共用方式為


MouseDevice.Capture 方法

定義

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

多載

Capture(IInputElement)

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

Capture(IInputElement, CaptureMode)

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

備註

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

CaptureMode如果未指定 ,則預設值CaptureModeElement

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

如果在 引發 或 事件時MouseDown擷取滑鼠,而且輸入不會移至滑鼠下方的專案,PreviewMouseDownOutsideCapturedElement則會PreviewMouseUpOutsideCapturedElementMouseUp引發。 這可讓擷取的項目有機會在 路由傳送 和 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

要捕捉滑鼠的項目。

傳回

如果項目可以捕捉滑鼠,則為 true;否則為 false

例外狀況

element 不是 UIElement 也不是 ContentElement

備註

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

CaptureMode如果未指定 ,則預設值CaptureModeElement

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

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

適用於

Capture(IInputElement, CaptureMode)

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

public:
 bool Capture(System::Windows::IInputElement ^ element, System::Windows::Input::CaptureMode captureMode);
[System.Security.SecurityCritical]
public bool Capture (System.Windows.IInputElement element, System.Windows.Input.CaptureMode captureMode);
public bool Capture (System.Windows.IInputElement element, System.Windows.Input.CaptureMode captureMode);
[<System.Security.SecurityCritical>]
member this.Capture : System.Windows.IInputElement * System.Windows.Input.CaptureMode -> bool
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

要使用的捕捉原則。

傳回

如果項目可以捕捉滑鼠,則為 true;否則為 false

屬性

例外狀況

element 不是 UIElement 也不是 ContentElement

captureMode 不是有效的 CaptureMode

備註

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

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

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

適用於