UIElement.ManipulationStarted イベント

定義

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

入力デバイスが UIElement の操作を開始したときに発生します。

// Register
event_token ManipulationStarted(ManipulationStartedEventHandler const& handler) const;

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

// Revoke with event_revoker
UIElement::ManipulationStarted_revoker ManipulationStarted(auto_revoke_t, ManipulationStartedEventHandler const& handler) const;
public event ManipulationStartedEventHandler ManipulationStarted;
function onManipulationStarted(eventArgs) { /* Your code */ }
uIElement.addEventListener("manipulationstarted", onManipulationStarted);
uIElement.removeEventListener("manipulationstarted", onManipulationStarted);
- or -
uIElement.onmanipulationstarted = onManipulationStarted;
Public Custom Event ManipulationStarted As ManipulationStartedEventHandler 
<uiElement ManipulationStarted="eventhandler"/>

イベントの種類

ManipulationStartedEventHandler

注釈

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

ManipulationStarted は、操作認識ロジックがポインターの動きを検出したことを表します。 この場合、一般的なシーケンスで発生する 2 番目の操作イベントは、 ManipulationStarting後、 ManipulationDelta 前、または ManipulationInertiaStarting などの他のイベントの前に発生します。

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

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

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

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

適用対象

こちらもご覧ください