Mouse.Capture Méthode

Définition

Espace de noms:

System.Windows.Input

Assembly:

PresentationCore.dll

Capture l'entrée de la souris à l'élément spécifié.

Surcharges

Capture(IInputElement)	Capture l'entrée de la souris à l'élément spécifié.
Capture(IInputElement, CaptureMode)	Capture l'entrée de la souris à l'élément spécifié à l'aide du CaptureModespécifié.

Remarques

Lorsqu’un élément capture la souris, il reçoit l’entrée de la souris, que le curseur se trouve ou non dans ses bordures.

Si un CaptureMode n’est pas spécifié, la valeur par défaut CaptureMode est Element.

Pour libérer la capture de la souris, appelez Capture en tant null qu’élément à capturer.

Si la souris est capturée lorsqu’un MouseDown événement ou MouseUp est déclenché et que l’entrée ne va pas à l’élément sous la souris, PreviewMouseDownOutsideCapturedElement et PreviewMouseUpOutsideCapturedElement qu’elle est déclenchée en premier. Cela permet à l’élément capturé de libérer la capture avant que les MouseDown événements et MouseUp ne soient routés.

Capture(IInputElement)

Capture l'entrée de la souris à l'élément spécifié.

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

Paramètres

element

IInputElement

Élément pour capturer la souris.

Retours

Boolean

true si l'élément a pu capturer la souris ; sinon, false.

Exemples

L’exemple suivant montre comment capturer la souris sur un élément spécifique à l’aide de la Capture méthode .

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

Remarques

Lorsqu’un élément capture la souris, il reçoit l’entrée de la souris, que le curseur se trouve ou non dans ses bordures.

Si un CaptureMode n’est pas spécifié, la valeur par défaut CaptureMode est Element.

Pour libérer la capture de la souris, appelez Capture en tant null qu’élément à capturer.

Si la souris est capturée lorsqu’un MouseDown événement ou MouseUp est déclenché et que l’entrée ne va pas à l’élément sous la souris, PreviewMouseDownOutsideCapturedElement et PreviewMouseUpOutsideCapturedElement qu’elle est déclenchée en premier. Cela permet à l’élément capturé de libérer la capture avant que les MouseDown événements et MouseUp ne soient routés.

Capture(IInputElement, CaptureMode)

Capture l'entrée de la souris à l'élément spécifié à l'aide du CaptureModespécifié.

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

Paramètres

element

IInputElement

Élément pour capturer la souris.

captureMode

CaptureMode

Stratégie de capture à utiliser.

Retours

Boolean

true si l'élément a pu capturer la souris ; sinon, false.

Exemples

L’exemple suivant montre comment capturer la souris sur un élément spécifique à l’aide de la Capture méthode .

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

Remarques

Lorsqu’un élément capture la souris, il reçoit l’entrée de la souris si le curseur se trouve dans ses bordures.

Pour libérer la capture de la souris, appelez Capture en tant null qu’élément à capturer.

Si la souris est capturée lorsqu’un MouseDown événement ou MouseUp est déclenché et que l’entrée ne va pas à l’élément sous la souris, PreviewMouseDownOutsideCapturedElement et PreviewMouseUpOutsideCapturedElement qu’elle est déclenchée en premier. Cela permet à l’élément capturé de libérer la capture avant que les MouseDown événements et MouseUp ne soient routés.