Basic Library for UWP/WinRT XAML
C1DragHelper コンストラクタ

ドラッグジェスチャを監視する対象の Windows.UI.Xaml.UIElement
監視されるドラッグの種類を示します。操作終了後に DragDelta イベントが発生するように慣性フラグを他のフラグと組み合わせます(C1DragHelperMode.FreeDrag | C1DragHelperMode.Inertia など)。
開始するまでにジェスチャが通過するピクセルの数を指定します。
ポインタ押下イベント(SL と WPF の MouseLeftButtonDown および WinRT の PointerPressed)で要素をキャプチャするか、最初のポインタ移動イベント(SL と WPF の MouseMove および WinRT の PointerMoved)で要素をキャプチャするかを示します。マウスダウンで要素をキャプチャすると、サブ要素(ビジュアルツリー内のネストされた要素)で Click、DoubleClick、および MouseLeftButtonUp イベントが発生しなくなりますが、最初のマウス移動で要素をキャプチャすると、エンドユーザーが小さい要素をすばやくドラッグすることが難しくなる可能性があります。
マウスイベントが既に処理された後もドラッグジェスチャを監視するかどうかを示します。(これは、マウスジェスチャにのみ適用されます)
true に設定すると、Manipulation イベントを使用してジェスチャを監視します。そうでない場合は、Pointer イベントを使用します。
true に設定すると、左マウスボタンイベントではなく、右マウスボタンダウン/アップイベントを監視します(WinRT では、useManipulationEvents が false に設定されている場合にのみこれが適用されます)。
新しい C1DragHelper を初期化します。
構文
'宣言
 
Public Function New( _
   ByVal element As Windows.UI.Xaml.UIElement, _
   Optional ByVal mode As C1DragHelperMode, _
   Optional ByVal initialThreshold As System.Double, _
   Optional ByVal captureElementOnPointerPressed As System.Boolean, _
   Optional ByVal handledEventsToo As System.Boolean, _
   Optional ByVal useManipulationEvents As System.Boolean, _
   Optional ByVal useRightButton As System.Boolean _
)
public C1DragHelper( 
   Windows.UI.Xaml.UIElement element,
   C1DragHelperMode mode,
   System.double initialThreshold,
   System.bool captureElementOnPointerPressed,
   System.bool handledEventsToo,
   System.bool useManipulationEvents,
   System.bool useRightButton
)

パラメータ

element
ドラッグジェスチャを監視する対象の Windows.UI.Xaml.UIElement
mode
監視されるドラッグの種類を示します。操作終了後に DragDelta イベントが発生するように慣性フラグを他のフラグと組み合わせます(C1DragHelperMode.FreeDrag | C1DragHelperMode.Inertia など)。
initialThreshold
開始するまでにジェスチャが通過するピクセルの数を指定します。
captureElementOnPointerPressed
ポインタ押下イベント(SL と WPF の MouseLeftButtonDown および WinRT の PointerPressed)で要素をキャプチャするか、最初のポインタ移動イベント(SL と WPF の MouseMove および WinRT の PointerMoved)で要素をキャプチャするかを示します。マウスダウンで要素をキャプチャすると、サブ要素(ビジュアルツリー内のネストされた要素)で Click、DoubleClick、および MouseLeftButtonUp イベントが発生しなくなりますが、最初のマウス移動で要素をキャプチャすると、エンドユーザーが小さい要素をすばやくドラッグすることが難しくなる可能性があります。
handledEventsToo
マウスイベントが既に処理された後もドラッグジェスチャを監視するかどうかを示します。(これは、マウスジェスチャにのみ適用されます)
useManipulationEvents
true に設定すると、Manipulation イベントを使用してジェスチャを監視します。そうでない場合は、Pointer イベントを使用します。
useRightButton
true に設定すると、左マウスボタンイベントではなく、右マウスボタンダウン/アップイベントを監視します(WinRT では、useManipulationEvents が false に設定されている場合にのみこれが適用されます)。
解説
マウスダウンで要素をキャプチャすると、サブ要素(ビジュアルツリー内のネストされた要素)で Click、DoubleClick、および MouseLeftButtonUp イベントが発生しなくなりますが、最初のマウス移動で要素をキャプチャすると、エンドユーザーが小さい要素をすばやくドラッグすることが難しくなる可能性があります。
Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

参照

関連項目

C1DragHelper クラス
C1DragHelper メンバ

Send Feedback