UIElement.TryStartDirectManipulation(Pointer) メソッド

  • リファレンス

定義

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

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

ScrollViewer の親が存在し、値を設定するとパン/ズーム 操作が再開された場合は true。 メソッドを呼び出してもアクションが発生しない場合は false。

注釈

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

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

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

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

適用対象

こちらもご覧ください