UIElement.CaptureStylus メソッド

定義

この要素にスタイラスをキャプチャするように強制することを試みます。Attempts to force capture of the stylus to this element.

public:
 virtual bool CaptureStylus();
public bool CaptureStylus ();
abstract member CaptureStylus : unit -> bool
override this.CaptureStylus : unit -> bool
Public Function CaptureStylus () As Boolean

戻り値

スタイラスが正常にキャプチャされた場合は true。それ以外の場合は falsetrue if the stylus was successfully captured; otherwise, false.

実装

注釈

基になる既定のスタイラスデバイスに基づく既定の実装では、常に trueが返されます。The default implementation based on the underlying default stylus device always returns true. ただし、入力システムのデバイスの実装を提供する入力デバイスを拡張する場合は、異なる結果を返す可能性がある別のスタイラスデバイスの実装でシステムを作成することができます。However, if you are extending the input devices that provide the device implementation for the input system, it is possible to create a system with an alternative stylus device implementation that might return different results.

要素は、スタイラスをキャプチャすると、スタイラスが境界の外側にある場合でもスタイラス入力を受け取ります。When an element captures the stylus, it receives stylus input even if the stylus is outside its bounds. スタイラスは、通常、ドラッグアンドドロップ操作中にのみキャプチャされます。The stylus is typically captured only during drag-and-drop operations.

このメソッドを呼び出すと、基になる静的 Stylus メソッド Captureが呼び出されます。Calling this method calls an underlying static Stylus method Capture. 実際のキャプチャ動作は、アクティブなスタイラスデバイス実装によって実装されます。The actual capture behavior is implemented by the active stylus device implementation.

キャプチャするには、要素を有効にする必要があります。To be captured, an element must be enabled. CaptureStylusを呼び出す前に IsEnabled が返さ true かどうかを確認します。Check whether IsEnabled is true return before you call CaptureStylus.

CaptureStylus を呼び出すと trueが返される場合、IsStylusCapturedtrueます。If calling CaptureStylus returns true, IsStylusCaptured is also true.

適用対象