Mouse.Capture Método

Definição

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Captura a entrada de mouse no elemento especificado.

Sobrecargas

Capture(IInputElement)	Captura a entrada de mouse no 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 a entrada de mouse no 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

O elemento do qual o mouse é capturado.

Retornos

Boolean

true se o elemento conseguiu capturar o mouse, caso contrário, false.

Exemplos

O exemplo a seguir mostra como capturar o mouse em um elemento específico usando o 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

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, CaptureMode)

Captura a entrada do mouse para o elemento especificado usando o 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

O elemento do qual o mouse é capturado.

captureMode

CaptureMode

A política de captura a ser usada.

Retornos

Boolean

true se o elemento conseguiu capturar o mouse, caso contrário, false.

Exemplos

O exemplo a seguir mostra como capturar o mouse em um elemento específico usando o 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

Comentários

Quando um elemento captura o mouse, ele recebe a entrada do mouse se o cursor está 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.