UIElement.IsMouseCaptured UIElement.IsMouseCaptured UIElement.IsMouseCaptured UIElement.IsMouseCaptured Property

Définition

Obtient une valeur indiquant si la souris est capturée pour cet élément.Gets a value indicating whether the mouse is captured to this element. Il s’agit d’une propriété de dépendance.This is a dependency property.

public:
 property bool IsMouseCaptured { bool get(); };
public bool IsMouseCaptured { get; }
member this.IsMouseCaptured : bool
Public ReadOnly Property IsMouseCaptured As Boolean

Valeur de propriété

true si l’élément a la capture de la souris ; sinon, false.true if the element has mouse capture; otherwise, false. La valeur par défaut est false.The default is false.

Implémente

Exemples

L’exemple suivant active ou désactive l’état de capture de la souris selon que la souris est déjà capturée ou non pour l’élément.The following example turns the mouse capture state on or off based on whether the mouse is already captured for the element.

Si la capture de la souris est ailleurs, la capture de la souris est définie sur cet élément.If mouse capture is elsewhere, the mouse capture is set to that element. Si l’élément avait une capture de la souris, il est Mouse.Capture effacé en appelant avec une entrée null.If the element had mouse capture, it is cleared by calling Mouse.Capture with a null input.

    private void CaptureMouseCommandExecuted(object sender, ExecutedRoutedEventArgs e)
    {
        MessageBox.Show("Mouse Command");
        IInputElement target = Mouse.DirectlyOver;

        target = target as Control;
        if (target != null)
        {
            if (!target.IsMouseCaptured)
            {
                Mouse.Capture(target);
            }
            else
            {
                Mouse.Capture(null);
            }
        }
    }
Private Sub CaptureMouseCommandExecuted(ByVal sender As Object, ByVal e As ExecutedRoutedEventArgs)
    MessageBox.Show("Mouse Command")
    Dim target As IInputElement = Mouse.DirectlyOver

    target = TryCast(target, Control)
    If target IsNot Nothing Then
        If Not target.IsMouseCaptured Then
            Mouse.Capture(target)
        Else
            Mouse.Capture(Nothing)
        End If
    End If
End Sub

Remarques

L’état de capture de la souris est lié aux opérations de glisser-déplacer in-process.Mouse capture state is related to in-process drag-and-drop operations.

Informations sur les propriétés de dépendanceDependency Property Information

Champ d’identificateurIdentifier field IsMouseCapturedProperty
Propriétés de métadonnées définies surtrueMetadata properties set to true Aucun.None

S’applique à

Voir aussi