Mouse.Capture 方法

定義

命名空間:

System.Windows.Input

組件:

PresentationCore.dll

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

多載

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

備註

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

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

若要釋放滑鼠擷取，請呼叫 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

要捕捉滑鼠的項目。

傳回

Boolean

如果項目可以捕捉滑鼠，則為 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如果未指定 ，則預設值CaptureMode為 Element。

若要釋放滑鼠擷取，請呼叫 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

要使用的捕捉原則。

傳回

Boolean

如果項目可以捕捉滑鼠，則為 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釋放擷取。