Mouse.Capture Méthode

Définition

Espace de noms:
System.Windows.Input
Assembly:
PresentationCore.dll

Capture l’entrée de la souris dans l’élément spécifié.

Surcharges

Nom Description
Capture(IInputElement)

Capture l’entrée de la souris dans l’élément spécifié.
Capture(IInputElement, CaptureMode)

Capture l’entrée de la souris sur l’élément spécifié à l’aide de l’élément spécifié CaptureMode.

Remarques

Lorsqu’un élément capture la souris, il reçoit l’entrée de la souris si le curseur se trouve à l’intérieur de 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 le passage null en tant qu’élément à capturer.

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

Capture(IInputElement)

Capture l’entrée de la souris dans 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 à capturer.

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 à l’intérieur de 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 le passage null en tant qu’élément à capturer.

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

S’applique à

Capture(IInputElement, CaptureMode)

Capture l’entrée de la souris sur l’élément spécifié à l’aide de l’élément spécifié CaptureMode.

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 à capturer.

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 le passage null en tant qu’élément à capturer.

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

S’applique à