UIElement.ManipulationCompleted イベント

  • リファレンス

定義

名前空間:
Windows.UI.Xaml
編集

UIElement の操作が完了したときに発生します。

public:
 virtual event ManipulationCompletedEventHandler ^ ManipulationCompleted;
// Register
event_token ManipulationCompleted(ManipulationCompletedEventHandler const& handler) const;

// Revoke with event_token
void ManipulationCompleted(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::ManipulationCompleted_revoker ManipulationCompleted(auto_revoke_t, ManipulationCompletedEventHandler const& handler) const;
public event ManipulationCompletedEventHandler ManipulationCompleted;
function onManipulationCompleted(eventArgs) { /* Your code */ }
uIElement.addEventListener("manipulationcompleted", onManipulationCompleted);
uIElement.removeEventListener("manipulationcompleted", onManipulationCompleted);
- or -
uIElement.onmanipulationcompleted = onManipulationCompleted;
Public Custom Event ManipulationCompleted As ManipulationCompletedEventHandler 
<uiElement ManipulationCompleted="eventhandler"/>

イベントの種類

ManipulationCompletedEventHandler

注釈

カスタム コントロールと操作エクスペリエンスについては、「 GestureRecognizer.ManipulationCompleted」を参照してください。

要素が操作イベント ソースになるには、None または System 以外の ManipulationMode 値が必要です。 ManipulationMode の既定値は System です。これにより、組み込みの制御ロジックで操作を処理できますが、アプリ コードで操作イベントを処理することはできません。 操作を処理する場合は、 ManipulationMode を [すべて] または特定の ManipulationModes 値に設定します。 詳細については、「 ManipulationMode」を参照してください。

ManipulationCompleted はルーティング イベントです。 イベントが未処理であるために親要素にバブルアップすることが許可されている場合、 ManipulationMode が None または親要素の System であっても、親要素のイベントを処理できます。 ルーティング イベントの概念の詳細については、「 イベントとルーティング イベントの概要」を参照してください。

タッチ操作や、タッチ操作の結果に発生する対話/操作イベントについては、ヒット テストで要素が表示されない場合、イベント ソースとして使用したり、操作に関連付けられたイベントを起動することはできません。 UIElement.Visibility はVisible である必要があります。 派生型の他のプロパティも、ヒット テストの可視性に影響します。 詳しくは、「イベントとルーティング イベントの概要」をご覧ください。

ManipulationCompleted では、イベントのイベント データが Handled とマークされている場合でも呼び出されるルートにイベント ハンドラーをアタッチする機能がサポートされています。 「 AddHandler」を参照してください。

Windows 8 の動作

Windows 8 では、慣性フェーズが開始された (および ManipulationInertiaStarting が起動した) が、スクロールが完了する前にユーザーがアイテムをタップした場合、ManipulationCompleted は起動しません。これにより、慣性フェーズが視覚的に取り消されます。 この問題は、Windows 8.1 以降で修正されています。ManipulationCompleted は、タップ アクションによって慣性フェーズが取り消されるとすぐに発生します。

Windows 8 用にコンパイルしたアプリは、Windows 8.1 上で実行しても Windows 8 のときと同じ動作になります。

適用対象

こちらもご覧ください