UIElement.IsMouseCaptured Propriedade

Referência

Definição

Namespace:: System.Windows

Assembly:: PresentationCore.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém um valor que indica se o mouse é capturado para esse elemento. É uma propriedade de dependência.

public:
 property bool IsMouseCaptured { bool get(); };

public bool IsMouseCaptured { get; }

member this.IsMouseCaptured : bool

Public ReadOnly Property IsMouseCaptured As Boolean

Valor da propriedade

Boolean

true se o elemento tiver a captura do mouse; caso contrário, false. O padrão é false.

Implementações

IsMouseCaptured

Exemplos

O exemplo a seguir ativa ou desativa o estado de captura do mouse com base em se o mouse já foi capturado para o elemento .

Se a captura do mouse estiver em outro lugar, a captura do mouse será definida como esse elemento. Se o elemento tiver captura de mouse, ele será limpo chamando Mouse.Capture com uma entrada nula.

    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

Comentários

O estado de captura do mouse está relacionado a operações de arrastar e soltar em processo.

Informações da propriedade de dependência


Campo Identificador	IsMouseCapturedProperty
Propriedades de metadados definidas como `true`	Nenhum

Aplica-se a

Produto	Versões
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Partilhar via