MouseDevice.Capture Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Captura a entrada de mouse no elemento especificado.
Sobrecargas
| Capture(IInputElement) |
Captura eventos do mouse para o elemento especificado. |
| Capture(IInputElement, CaptureMode) |
Captura a entrada do mouse para o elemento especificado usando o CaptureMode especificado. |
Comentários
Quando um elemento captura o mouse, ele recebe a entrada do mouse se o cursor está ou não dentro de suas bordas.
Se um CaptureMode não for especificado, o padrão CaptureMode será Element.
Para liberar a captura do mouse, chame Capture passando null como o elemento a ser capturado.
Se o mouse for capturado quando um MouseDown evento ou MouseUp for acionado e a entrada não for para o elemento sob o mouse e PreviewMouseDownOutsideCapturedElementPreviewMouseUpOutsideCapturedElement for gerada primeiro. Isso permite ao elemento capturado uma chance de liberar a captura antes que os MouseDown eventos e MouseUp sejam roteado.
Capture(IInputElement)
Captura eventos do mouse para o elemento especificado.
public:
bool Capture(System::Windows::IInputElement ^ element);public bool Capture (System.Windows.IInputElement element);member this.Capture : System.Windows.IInputElement -> boolPublic Function Capture (element As IInputElement) As BooleanParâmetros
- element
- IInputElement
O elemento do qual o mouse é capturado.
Retornos
true se o elemento conseguiu capturar o mouse, caso contrário, false.
Exceções
element não é um UIElement ou ContentElement.
Comentários
Quando um elemento captura o mouse, ele recebe a entrada do mouse se o cursor está dentro de suas bordas
Se um CaptureMode não for especificado, o padrão CaptureMode será Element.
Para liberar a captura do mouse, chame Capture passando null como o elemento a ser capturado.
Se o mouse for capturado quando um MouseDown evento ou MouseUp for acionado e a entrada não for para o elemento sob o mouse e PreviewMouseDownOutsideCapturedElementPreviewMouseUpOutsideCapturedElement for gerada primeiro. Isso permite ao elemento capturado uma chance de liberar a captura antes que os MouseDown eventos e MouseUp sejam roteado.
Aplica-se a
Capture(IInputElement, CaptureMode)
Captura a entrada do mouse para o elemento especificado usando o 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 -> boolmember this.Capture : System.Windows.IInputElement * System.Windows.Input.CaptureMode -> boolPublic Function Capture (element As IInputElement, captureMode As CaptureMode) As BooleanParâmetros
- element
- IInputElement
O elemento do qual o mouse é capturado.
- captureMode
- CaptureMode
A política de captura a ser usada.
Retornos
true se o elemento conseguiu capturar o mouse, caso contrário, false.
- Atributos
Exceções
element não é um UIElement ou ContentElement.
captureMode não é um CaptureMode válido.
Comentários
Quando um elemento captura o mouse, ele recebe a entrada do mouse se o cursor está ou não dentro de suas bordas.
Para liberar a captura do mouse, chame Capture passando null como o elemento a ser capturado.
Se o mouse for capturado quando um MouseDown evento ou MouseUp for acionado e a entrada não for para o elemento sob o mouse e PreviewMouseDownOutsideCapturedElementPreviewMouseUpOutsideCapturedElement for gerada primeiro. Isso permite ao elemento capturado uma chance de liberar a captura antes que os MouseDown eventos e MouseUp sejam roteado.
