Mouse.Capture Método

Definición

Espacio de nombres:

System.Windows.Input

Ensamblado:

PresentationCore.dll

Captura la entrada del mouse en el elemento especificado.

Sobrecargas

Capture(IInputElement)	Captura la entrada del mouse en el elemento especificado.
Capture(IInputElement, CaptureMode)	Captura la entrada del mouse en el elemento especificado utilizando el objeto CaptureMode especificado.

Comentarios

Cuando un elemento captura el mouse, recibe la entrada del mouse tanto si el cursor está dentro de sus bordes como si no.

Si no se especifica , CaptureMode el valor predeterminado CaptureMode es Element.

Para liberar la captura del mouse, llame Capture a pasando null como el elemento que se va a capturar.

Si el mouse se captura cuando se genera un MouseDown evento o MouseUp y la entrada no va al elemento debajo del mouse PreviewMouseDownOutsideCapturedElement y PreviewMouseUpOutsideCapturedElement se genera primero. Esto permite al elemento capturado liberar la captura antes de enrutar los MouseDown eventos y MouseUp .

Capture(IInputElement)

Captura la entrada del mouse en el elemento especificado.

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

Parámetros

element

IInputElement

Elemento que va a capturar el mouse.

Devoluciones

Boolean

Es true si el elemento es capaz de capturar el mouse; en caso contrario, es false.

Ejemplos

En el ejemplo siguiente se muestra cómo capturar el mouse en un elemento específico mediante el Capture método .

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

Comentarios

Cuando un elemento captura el mouse, recibe la entrada del mouse tanto si el cursor está dentro de sus bordes como si no.

Si no se especifica , CaptureMode el valor predeterminado CaptureMode es Element.

Para liberar la captura del mouse, llame Capture a pasando null como el elemento que se va a capturar.

Si el mouse se captura cuando se genera un MouseDown evento o MouseUp y la entrada no va al elemento debajo del mouse PreviewMouseDownOutsideCapturedElement y PreviewMouseUpOutsideCapturedElement se genera primero. Esto permite al elemento capturado liberar la captura antes de enrutar los MouseDown eventos y MouseUp .

Capture(IInputElement, CaptureMode)

Captura la entrada del mouse en el elemento especificado utilizando el objeto CaptureMode especificado.

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

Parámetros

element

IInputElement

Elemento que va a capturar el mouse.

captureMode

CaptureMode

La directiva de captura que se va a utilizar.

Devoluciones

Boolean

Es true si el elemento es capaz de capturar el mouse; en caso contrario, es false.

Ejemplos

En el ejemplo siguiente se muestra cómo capturar el mouse en un elemento específico mediante el Capture método .

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

Comentarios

Cuando un elemento captura el mouse, recibe la entrada del mouse si el cursor está dentro de sus bordes.

Para liberar la captura del mouse, llame Capture a pasando null como el elemento que se va a capturar.

Si el mouse se captura cuando se genera un MouseDown evento o MouseUp y la entrada no va al elemento debajo del mouse PreviewMouseDownOutsideCapturedElement y PreviewMouseUpOutsideCapturedElement se genera primero. Esto permite al elemento capturado liberar la captura antes de enrutar los MouseDown eventos y MouseUp .