UIElement.TryStartDirectManipulation(Pointer) メソッド

定義

現在の 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

操作を開始したアクティブなタッチ ポイント。

戻り値

Boolean

bool

true ScrollViewer の親が存在し、値を設定すると、パン/ズーム アクションが再開されます。 false メソッドを呼び出しても何も行われません。

注釈

既定では、 ScrollViewer 要素のタッチ入力操作は、UI スレッドから 直接操作 エンジンによって処理されます。 直接操作処理の開始後に、関連付けられたポインター イベントをアプリで直接処理することはできません。 対話のScrollViewer開始時に CancelDirectManipulations を呼び出し、UI スレッドでポインター イベントを処理できます。これにより、 でScrollViewerカスタム入力処理を実行できます。

ScrollViewer 操作の開始時に直接操作処理を取り消した場合は、 を呼び出TryStartDirectManipulationして、入力ストリームの直接操作処理を再開できます。 これにより、最初にカスタム入力処理を行い、 直接操作 処理を再開して、スクロールやズームなどのタッチ操作に対するアプリの応答性を高めます。

アクティブなタッチ連絡先のみを 直接操作に渡すことができます。 アクティブでない連絡先またはタッチしない連絡先を使用すると、例外がスローされます。

直接操作に渡すタッチ接触を指定すると、フレームワークは、ManipulationModes.System を含む ManipulationMode を持たない任意の要素 (元のターゲット要素を含む) に到達するまで、親チェーンを歩き上げ、検出された各 ScrollViewer直接操作ビューポートで接触を順番に設定します。 特定のタッチ接触は、一度に 1 つのビジュアル チェーンにのみ関連付けることができます。 同じ連絡先に対して複数回呼び出 TryStartDirectManipulation すと、以前のチェーンが解放されます。

適用対象

こちらもご覧ください