共用方式為


Mouse.Capture 方法

定義

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

多載

Capture(IInputElement)

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

Capture(IInputElement, CaptureMode)

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

備註

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

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

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

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

Capture(IInputElement)

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

public:
 static bool Capture(System::Windows::IInputElement ^ element);
public static bool Capture (System.Windows.IInputElement element);
static member Capture : System.Windows.IInputElement -> bool
Public Shared Function Capture (element As IInputElement) As Boolean

參數

element
IInputElement

要捕捉滑鼠的項目。

傳回

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

範例

下列範例示範如何使用 方法,將滑鼠擷取至特定元素 Capture

private void OnCaptureMouseRequest(object sender, RoutedEventArgs e)
{
    Mouse.Capture(_elementToCapture);
}
Private Sub OnCaptureMouseRequest(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Mouse.Capture(_elementToCapture)
End Sub

備註

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

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

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

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

適用於

Capture(IInputElement, CaptureMode)

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

public:
 static bool Capture(System::Windows::IInputElement ^ element, System::Windows::Input::CaptureMode captureMode);
public static bool Capture (System.Windows.IInputElement element, System.Windows.Input.CaptureMode captureMode);
static member Capture : System.Windows.IInputElement * System.Windows.Input.CaptureMode -> bool
Public Shared Function Capture (element As IInputElement, captureMode As CaptureMode) As Boolean

參數

element
IInputElement

要捕捉滑鼠的項目。

captureMode
CaptureMode

要使用的捕捉原則。

傳回

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

範例

下列範例示範如何使用 方法,將滑鼠擷取至特定元素 Capture

private void OnCaptureMouseRequest(object sender, RoutedEventArgs e)
{
    Mouse.Capture(_elementToCapture);
}
Private Sub OnCaptureMouseRequest(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Mouse.Capture(_elementToCapture)
End Sub

備註

當專案擷取滑鼠時,它會接收滑鼠輸入,指出游標是否在其框線內。

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

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

適用於