UIElement.IsMouseCaptured Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob die Maus für dieses Element erfasst wird.Gets a value indicating whether the mouse is captured to this element. Hierbei handelt es sich um eine Abhängigkeitseigenschaft.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

Eigenschaftswert

true, wenn die Maus für dieses Element erfasst wird, andernfalls false.true if the element has mouse capture; otherwise, false. Die Standardeinstellung ist false.The default is false.

Implementiert

Beispiele

Im folgenden Beispiel wird der Maus Erfassungs Zustand basierend darauf, ob die Maus für das-Element bereits aufgezeichnet wurde, ein-oder ausgeschaltet.The following example turns the mouse capture state on or off based on whether the mouse is already captured for the element.

Wenn die Maus Aufzeichnung an einer anderen Stelle ist, wird die Maus Aufzeichnung auf dieses Element festgelegt.If mouse capture is elsewhere, the mouse capture is set to that element. Wenn das Element über die Maus Aufzeichnung verfügt, wird es durch Aufrufen von Mouse.Capture mit einer NULL-Eingabe gelöscht.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

Hinweise

Der Status der Maus Aufzeichnung bezieht sich auf in-Process-Drag & Drop-Vorgänge.Mouse capture state is related to in-process drag-and-drop operations.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field IsMouseCapturedProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true KeineNone

Gilt für:

Siehe auch