MouseDevice.Capture Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Captura a entrada do rato para o elemento especificado.
Sobrecargas
| Name | Description |
|---|---|
| Capture(IInputElement) |
Captura eventos do rato para o elemento especificado. |
| Capture(IInputElement, CaptureMode) |
Captura a entrada do rato para o elemento especificado usando o elemento especificado CaptureMode. |
Observações
Quando um elemento captura o rato, recebe a entrada do rato, quer o cursor esteja ou não dentro das suas bordas.
Se a CaptureMode não for especificado, o padrão CaptureMode é Element.
Para libertar a captura do rato, chame Capture o passing null como elemento a capturar.
Se o rato for capturado quando um MouseDown evento ou MouseUp é levantado e a entrada não for para o elemento por baixo do rato, PreviewMouseDownOutsideCapturedElement e PreviewMouseUpOutsideCapturedElement forem levantados primeiro. Isto permite ao elemento capturado a oportunidade de libertar a captura antes que os MouseDown eventos e MouseUp sejam encaminhados.
Capture(IInputElement)
Captura eventos do rato 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 para capturar o rato.
Devoluções
true se o elemento conseguisse capturar o rato; caso contrário, false.
Exceções
element não é um UIElement ou ContentElement.
Observações
Quando um elemento captura o rato, recebe entrada do rato quer o cursor esteja dentro das suas bordas
Se a CaptureMode não for especificado, o padrão CaptureMode é Element.
Para libertar a captura do rato, chame Capture o passing null como elemento a capturar.
Se o rato for capturado quando um MouseDown evento ou MouseUp é levantado e a entrada não for para o elemento por baixo do rato, PreviewMouseDownOutsideCapturedElement e PreviewMouseUpOutsideCapturedElement forem levantados primeiro. Isto permite ao elemento capturado a oportunidade de libertar a captura antes que os MouseDown eventos e MouseUp sejam encaminhados.
Aplica-se a
Capture(IInputElement, CaptureMode)
Captura a entrada do rato para o elemento especificado usando o elemento especificado CaptureMode.
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);[<System.Security.SecurityCritical>]
member 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 para capturar o rato.
- captureMode
- CaptureMode
A política de captura a usar.
Devoluções
true se o elemento conseguisse capturar o rato; caso contrário, false.
- Atributos
Exceções
element não é um UIElement ou ContentElement.
captureMode não é um CaptureModeválido.
Observações
Quando um elemento captura o rato, recebe a entrada do rato, quer o cursor esteja ou não dentro das suas bordas.
Para libertar a captura do rato, chame Capture o passing null como elemento a capturar.
Se o rato for capturado quando um MouseDown evento ou MouseUp é levantado e a entrada não for para o elemento por baixo do rato, PreviewMouseDownOutsideCapturedElement e PreviewMouseUpOutsideCapturedElement forem levantados primeiro. Isto permite ao elemento capturado a oportunidade de libertar a captura antes que os MouseDown eventos e MouseUp sejam encaminhados.