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
ScrollViewer の親が存在し、値を設定するとパン/ズーム 操作が再開された場合は true。 メソッドを呼び出してもアクションが発生しない場合は false。
注釈
既定では、 ScrollViewer 要素のタッチ入力操作は、UI スレッドから 直接操作 エンジンによって処理されます。 直接操作処理の開始後に、関連付けられたポインター イベントをアプリで直接処理することはできません。 ScrollViewer 操作の開始時に CancelDirectManipulations を呼び出し、UI スレッドでポインター イベントを処理できます。これにより、ScrollViewer でカスタム入力処理を実行できます。
ScrollViewer 操作の開始時に直接操作処理をキャンセルした場合は、TryStartDirectManipulation を呼び出して、入力ストリームの直接操作処理を再開できます。 これにより、最初にカスタム入力処理を行い、 直接操作 処理を再開して、スクロールやズームなどのタッチ操作に対するアプリの応答性を高めます。
アクティブなタッチ連絡先のみを 直接操作に渡すことができます。 アクティブでない連絡先またはタッチしない連絡先を使用すると、例外がスローされます。
直接操作に渡すタッチ接触を指定すると、フレームワークは、ManipulationModes.System を含む ManipulationMode を持たない任意の要素 (元のターゲット要素を含む) に到達するまで、親チェーンを歩き上げ、検出された各 ScrollViewer の直接操作ビューポートで接触を順番に設定します。 特定のタッチ接触は、一度に 1 つのビジュアル チェーンにのみ関連付けることができます。 同じ連絡先で TryStartDirectManipulation を複数回呼び出すと、以前のチェーンが解放されます。