UIElement.IsMouseCaptured Propriedade

Definição

Obtém um valor que indica se o mouse é capturado para esse elemento.Gets a value indicating whether the mouse is captured to this element. É uma propriedade de dependência.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

Valor da propriedade

true se o elemento tiver a captura do mouse; caso contrário, false.true if the element has mouse capture; otherwise, false. O padrão é false.The default is false.

Implementações

Exemplos

O exemplo a seguir ativa ou desativa o estado de captura do mouse com base no fato de o mouse já ter sido capturado para o elemento.The following example turns the mouse capture state on or off based on whether the mouse is already captured for the element.

Se a captura do mouse estiver em outro lugar, a captura do mouse será definida para esse elemento.If mouse capture is elsewhere, the mouse capture is set to that element. Se o elemento tiver a captura do mouse, ele será limpo chamando Mouse.Capture com uma entrada nula.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

Comentários

O estado de captura do mouse está relacionado a operações de arrastar e soltar em processo.Mouse capture state is related to in-process drag-and-drop operations.

Informações de Propriedade de DependênciaDependency Property Information

Campo de identificadorIdentifier field IsMouseCapturedProperty
Propriedades de metadados definidas como trueMetadata properties set to true NenhumNone

Aplica-se a

Veja também