Compartilhar via


MouseGesture Classe

Definição

Define um gesto de entrada do 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
MouseGesture
Atributos

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, ela Open é invocada.

<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, MouseAction um não precisa ser emparelhado para ModifierKeys 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 ocorrer MouseGesture .

Para MouseGesture usos de atributo XAML, a propriedade que geralmente é definida em XAML é Gesture, em 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 Usos de elementos de objeto XAML são possíveis, mas incomuns, pois normalmente você pode definir a Gesture propriedade de MouseBinding embutido 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

Nome Description
MouseGesture()

Inicializa uma nova instância da classe MouseGesture.

MouseGesture(MouseAction, ModifierKeys)

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

MouseGesture(MouseAction)

Inicializa uma nova instância da MouseGesture classe usando a especificada MouseAction.

Propriedades

Nome Description
Modifiers

Obtém ou define as chaves modificadoras associadas a isso MouseGesture.

MouseAction

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

Métodos

Nome Description
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 especificado InputEventArgs .

MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também