Share via


MouseDevice.Capture Método

Definición

Captura la entrada del mouse en el elemento especificado.

Sobrecargas

Capture(IInputElement)

Captura los eventos 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 situado debajo del mouse y PreviewMouseDownOutsideCapturedElementPreviewMouseUpOutsideCapturedElement se genera primero. Esto permite al elemento capturado liberar la captura antes de enrutar los MouseDown eventos y MouseUp .

Capture(IInputElement)

Captura los eventos del mouse en el elemento especificado.

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

Parámetros

element
IInputElement

Elemento que va a capturar el mouse.

Devoluciones

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

Excepciones

Comentarios

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

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 situado debajo del mouse y PreviewMouseDownOutsideCapturedElementPreviewMouseUpOutsideCapturedElement se genera primero. Esto permite al elemento capturado liberar la captura antes de enrutar los MouseDown eventos y MouseUp .

Se aplica a

Capture(IInputElement, CaptureMode)

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

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

Parámetros

element
IInputElement

Elemento que va a capturar el mouse.

captureMode
CaptureMode

La directiva de captura que se va a utilizar.

Devoluciones

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

Atributos

Excepciones

captureMode no es un CaptureMode válido.

Comentarios

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

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 situado debajo del mouse y PreviewMouseDownOutsideCapturedElementPreviewMouseUpOutsideCapturedElement se genera primero. Esto permite al elemento capturado liberar la captura antes de enrutar los MouseDown eventos y MouseUp .

Se aplica a