MouseDevice.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 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

Boolean

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

Excepciones

InvalidOperationException

element no es UIElement ni ContentElement.

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 .

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);

public bool Capture (System.Windows.IInputElement element, System.Windows.Input.CaptureMode captureMode);

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

Boolean

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

Excepciones

InvalidOperationException

element no es UIElement ni ContentElement.

InvalidEnumArgumentException

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 .