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他のイベントです。

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

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

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

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

適用対象

こちらもご覧ください