UIElement.TryStartDirectManipulation(Pointer) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
現在の UIElement を含む ScrollViewer 親の直接操作処理 (システム定義のパン/ズーム) を再開します。
public:
static bool TryStartDirectManipulation(Pointer ^ value); static bool TryStartDirectManipulation(Pointer const& value);public static bool TryStartDirectManipulation(Pointer value);function tryStartDirectManipulation(value)Public Shared Function TryStartDirectManipulation (value As Pointer) As Booleanパラメーター
- value
- Pointer
操作を開始したアクティブなタッチ ポイント。
返品
bool
true
ScrollViewer の親が存在し、値を設定するとパン/ズーム 操作が再開された場合。
false メソッドを呼び出してもアクションが発生しない場合。
注釈
既定では、 ScrollViewer 要素のタッチ入力操作は、UI スレッドから 直接操作 エンジンによって処理されます。
直接操作処理の開始後に、関連付けられているポインター イベントをアプリで直接処理することはできません。
ScrollViewer操作の開始時に CancelDirectManipulations を呼び出し、UI スレッドでポインター イベントを処理できます。このイベントを使用すると、ScrollViewerでカスタム入力処理を行うことができます。
ScrollViewer 操作の開始時に直接操作処理を取り消した場合は、TryStartDirectManipulationを呼び出して、直接操作プロセスの入力ストリームを再開できます。 これにより、最初にカスタム入力処理を実行してから、 直接操作 処理を再開して、スクロールやズームなどのタッチ操作に対するアプリの応答性を高めます。
アクティブなタッチ連絡先のみを 直接操作に渡すことができます。 アクティブでない連絡先またはタッチしない連絡先を使用すると、例外がスローされます。
直接操作に渡すタッチ連絡先を指定すると、フレームワークは親チェーンをウォークアップし、ウォークが ManipulationModes.System を含む ManipulationMode を持たない任意の要素 (元のターゲット要素を含む) に到達するまで、各 ScrollViewer の直接操作ビューポートで接触を順番に設定します。 特定のタッチ連絡先は、一度に 1 つのビジュアル チェーンにのみ関連付けることができます。 同じ連絡先に対して TryStartDirectManipulation を複数回呼び出すと、以前のチェーンが解放されます。