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 すと、以前のチェーンが解放されます。