MouseDevice.Capture 方法

定義

命名空間:

System.Windows.Input

組件:

PresentationCore.dll

將滑鼠輸入捕捉至指定的項目。

多載

Capture(IInputElement)	將滑鼠事件捕捉至指定的項目。
Capture(IInputElement, CaptureMode)	使用指定的 CaptureMode 將滑鼠輸入捕捉至指定項目。

備註

當元素擷取滑鼠時，無論游標是否在其框線內，它都會收到滑鼠輸入。

CaptureMode如果未指定 ，則預設值CaptureMode為 Element。

若要釋放滑鼠擷取，請呼叫 Capture 傳遞 null 作為要擷取的專案。

如果在 引發 或 事件時MouseDown擷取滑鼠，而且輸入不會移至滑鼠下方的專案，PreviewMouseDownOutsideCapturedElement則會PreviewMouseUpOutsideCapturedElement先MouseUp引發。 這可讓擷取的項目有機會在 路由傳送 和 MouseUp 事件之前MouseDown釋放擷取。

Capture(IInputElement)

將滑鼠事件捕捉至指定的項目。

public:
 bool Capture(System::Windows::IInputElement ^ element);

public bool Capture (System.Windows.IInputElement element);

member this.Capture : System.Windows.IInputElement -> bool

Public Function Capture (element As IInputElement) As Boolean

參數

element

IInputElement

要捕捉滑鼠的項目。

傳回

Boolean

如果項目可以捕捉滑鼠，則為 true；否則為 false。

例外狀況

InvalidOperationException

element 不是 UIElement 也不是 ContentElement。

備註

當元素擷取滑鼠時，它會接收游標是否在其框線內的滑鼠輸入

CaptureMode如果未指定 ，則預設值CaptureMode為 Element。

若要釋放滑鼠擷取，請呼叫 Capture 傳遞 null 作為要擷取的專案。

如果在 引發 或 事件時MouseDown擷取滑鼠，而且輸入不會移至滑鼠下方的專案，PreviewMouseDownOutsideCapturedElement則會PreviewMouseUpOutsideCapturedElement先MouseUp引發。 這可讓擷取的項目有機會在 路由傳送 和 MouseUp 事件之前MouseDown釋放擷取。

Capture(IInputElement, CaptureMode)

使用指定的 CaptureMode 將滑鼠輸入捕捉至指定項目。

public:
 bool Capture(System::Windows::IInputElement ^ element, System::Windows::Input::CaptureMode captureMode);

public bool Capture (System.Windows.IInputElement element, System.Windows.Input.CaptureMode captureMode);

member this.Capture : System.Windows.IInputElement * System.Windows.Input.CaptureMode -> bool

Public Function Capture (element As IInputElement, captureMode As CaptureMode) As Boolean

參數

element

IInputElement

要捕捉滑鼠的項目。

captureMode

CaptureMode

要使用的捕捉原則。

傳回

Boolean

如果項目可以捕捉滑鼠，則為 true；否則為 false。

例外狀況

InvalidOperationException

element 不是 UIElement 也不是 ContentElement。

InvalidEnumArgumentException

captureMode 不是有效的 CaptureMode。

備註

當元素擷取滑鼠時，無論游標是否在其框線內，它都會收到滑鼠輸入。

若要釋放滑鼠擷取，請呼叫 Capture 傳遞 null 作為要擷取的專案。

如果在 引發 或 事件時MouseDown擷取滑鼠，而且輸入不會移至滑鼠下方的專案，PreviewMouseDownOutsideCapturedElement則會PreviewMouseUpOutsideCapturedElement先MouseUp引發。 這可讓擷取的項目有機會在 路由傳送 和 MouseUp 事件之前MouseDown釋放擷取。