MouseGesture Classe

  • Referência

Definição

Namespace:
System.Windows.Input
Assembly:
PresentationCore.dll

Define um gesto de entrada de mouse que pode ser usado para invocar um comando.

public ref class MouseGesture : System::Windows::Input::InputGesture
[System.ComponentModel.TypeConverter(typeof(System.Windows.Input.MouseGestureConverter))]
public class MouseGesture : System.Windows.Input.InputGesture
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Input.MouseGestureConverter))>]
type MouseGesture = class
    inherit InputGesture
Public Class MouseGesture
Inherits InputGesture
Herança
Object
InputGesture
MouseGesture
Atributos
TypeConverterAttribute

Exemplos

O exemplo a seguir mostra como criar um MouseGesture e associá-lo a um RoutedCommand por meio de um MouseBinding. Quando a roda do mouse é clicada enquanto a Control tecla é pressionada, o Open é invocado.

<MouseBinding Gesture="Control+WheelClick"
              Command="ApplicationCommands.Open" />

MouseGesture OpenCmdMouseGesture = new MouseGesture();
OpenCmdMouseGesture.MouseAction = MouseAction.WheelClick;
OpenCmdMouseGesture.Modifiers = ModifierKeys.Control;

MouseBinding OpenCmdMouseBinding = new MouseBinding();
OpenCmdMouseBinding.Gesture = OpenCmdMouseGesture;
OpenCmdMouseBinding.Command = ApplicationCommands.Open;

this.InputBindings.Add(OpenCmdMouseBinding);

Dim OpenCmdMouseGesture As New MouseGesture()
OpenCmdMouseGesture.MouseAction = MouseAction.WheelClick
OpenCmdMouseGesture.Modifiers = ModifierKeys.Control

Dim OpenCmdMouseBinding As New MouseBinding()
OpenCmdMouseBinding.Gesture = OpenCmdMouseGesture
OpenCmdMouseBinding.Command = ApplicationCommands.Open

Me.InputBindings.Add(OpenCmdMouseBinding)

Comentários

Ao contrário de um KeyGesture, um MouseAction não precisa ser emparelhado com ModifierKeys para ser um válido MouseGesture.

Um MouseGesture pode ser associado a uma RoutedCommand (ou outras ICommand implementações) por meio de um MouseBinding para que o comando seja invocado quando o MouseGesture ocorrer.

Para MouseGesture usos de atributo XAML, a propriedade que geralmente é definida em XAML é Gesture, nos casos em que o gesto pode representar uma ação do mouse e uma ou mais teclas modificadoras. Você também pode definir a Gesture propriedade como apenas uma ação do mouse. Em geral, é recomendável que você use apenas o Gesture atributo de XAML, em vez de definir MouseAction, mesmo que você não especifique modificadores. Isso evitará ambiguidade, fornecerá a sintaxe mais simplificada e fornecerá a representação mais simples para serialização.

MouseGesture Os usos de elementos de objeto XAML são possíveis, mas incomuns, porque normalmente você pode definir a Gesture propriedade de MouseBinding embutida sem o uso da sintaxe do elemento de propriedade.

Uso do Atributo XAML

<object property="mouseAction"/>  
- or -  
<object property="oneOrMoreModifierKeys+mouseAction"/>

Valores XAML

mouseAction
MouseAction

Uma única ação do mouse.

oneOrMoreModifierKeys
Uma ou mais chaves modificadoras, definidas pela ModifierKeys enumeração . Se mais de uma chave modificadora for fornecida, cada chave modificadora será delimitada com um caractere "+".

Construtores

MouseGesture()

Inicializa uma nova instância da classe MouseGesture.
MouseGesture(MouseAction)

Inicializa uma nova instância da classe MouseGesture usando o MouseAction especificado.
MouseGesture(MouseAction, ModifierKeys)

Inicializa uma nova instância da classe MouseGesture usando o MouseAction e ModifierKeys especificados.

Propriedades

Modifiers

Obtém ou define as teclas modificadoras associadas a este MouseGesture.
MouseAction

Obtém ou define o MouseAction associado a esse gesto.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
Matches(Object, InputEventArgs)

Determina se MouseGesture corresponde à entrada associada ao objeto InputEventArgs especificado.
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também