UIElement.CaptureStylus UIElement.CaptureStylus UIElement.CaptureStylus UIElement.CaptureStylus Method

定義

この要素にスタイラスをキャプチャするように強制することを試みます。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.

このメソッドを呼び出すと、 StylusCaptureになる静的メソッドが呼び出されます。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. を呼び出すIsEnabled true 前に、が戻っているかどうかをCaptureStylus確認します。Check whether IsEnabled is true return before you call CaptureStylus.

を呼びCaptureStylus出すtrueIsStylusCaptured 、もtrueになります。If calling CaptureStylus returns true, IsStylusCaptured is also true.

適用対象