UIElement.ManipulationStarting イベント

  • リファレンス

定義

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

操作プロセッサを初めて作成するときに発生します。

public:
 virtual event ManipulationStartingEventHandler ^ ManipulationStarting;
// Register
event_token ManipulationStarting(ManipulationStartingEventHandler const& handler) const;

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

// Revoke with event_revoker
UIElement::ManipulationStarting_revoker ManipulationStarting(auto_revoke_t, ManipulationStartingEventHandler const& handler) const;
public event ManipulationStartingEventHandler ManipulationStarting;
function onManipulationStarting(eventArgs) { /* Your code */ }
uIElement.addEventListener("manipulationstarting", onManipulationStarting);
uIElement.removeEventListener("manipulationstarting", onManipulationStarting);
- or -
uIElement.onmanipulationstarting = onManipulationStarting;
Public Custom Event ManipulationStarting As ManipulationStartingEventHandler 
<uiElement ManipulationStarting="eventhandler"/>

イベントの種類

ManipulationStartingEventHandler

注釈

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

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

ManipulationStarting は基本的に、 要素が操作を可能にする要素とポインターが対話するたびに発生します。 これには、操作がジェスチャとして解釈され、ポインターが移動しないケース ( タップ ジェスチャや 保持 ジェスチャなど) が含まれます。 ポインターが移動する場合、 ManipulationStarted は通常、その後に起動します。

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

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

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

Windows 8 の動作

Windows 8 では、短時間に複数のジェスチャが発生した場合に、このイベントの発生に関する問題が発生しました。 たとえば、Windows 8 では、1 番目のジェスチャに対してのみ ManipulationStarting が起動され、2 番目のジェスチャでは起動されない場合があります。 この問題は、Windows 8.1以降修正されています。入力システムによって処理された複数の開始ジェスチャによって、それぞれ個別の ManipulationStarting イベントが発生します。

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

適用対象

こちらもご覧ください