InputBinding Classe

Definição

public ref class InputBinding : System::Windows::DependencyObject, System::Windows::Input::ICommandSource

public ref class InputBinding : System::Windows::Freezable, System::Windows::Input::ICommandSource

public class InputBinding : System.Windows.DependencyObject, System.Windows.Input.ICommandSource

public class InputBinding : System.Windows.Freezable, System.Windows.Input.ICommandSource

type InputBinding = class
    inherit DependencyObject
    interface ICommandSource

type InputBinding = class
    inherit Freezable
    interface ICommandSource

Public Class InputBinding
Inherits DependencyObject
Implements ICommandSource

Public Class InputBinding
Inherits Freezable
Implements ICommandSource

Herança

Object

DispatcherObject

DependencyObject

InputBinding

Herança

Object

DispatcherObject

DependencyObject

Freezable

InputBinding

Derivado

System.Windows.Input.KeyBinding

System.Windows.Input.MouseBinding

Implementações

ICommandSource

Exemplos

O exemplo seguinte mostra como usar a KeyBinding para associar a KeyGesture ao Open comando. Quando o gesto de tecla é executado, é invocado o comando Open.

<Window.InputBindings>
  <KeyBinding Key="B"
              Modifiers="Control" 
              Command="ApplicationCommands.Open" />
</Window.InputBindings>

Os exemplos seguintes mostram como associar um comando personalizado a InputBinding objetos. Estes exemplos criam uma aplicação que permite ao utilizador alterar a cor de fundo realizando uma das seguintes ações:

• Clicar num botão.

• A pressionar CTRL+C.

• Clicando com o botão direito num StackPanel (fora do ListBox).

O primeiro exemplo cria uma classe chamada SimpleDelegateCommand. Esta classe aceita um delegado para que o objeto que cria o comando possa definir a ação que ocorre quando o comando é executado. SimpleDelegateCommand também define propriedades que especificam que tecla e entrada do rato invocam o comando. GestureKey e GestureModifier especificar a entrada do teclado; MouseGesture especifica a entrada do rato.

 // Create a class that implements ICommand and accepts a delegate.
public class SimpleDelegateCommand : ICommand
{
    // Specify the keys and mouse actions that invoke the command. 
    public Key GestureKey { get; set; }
    public ModifierKeys GestureModifier { get; set; }
    public MouseAction MouseGesture { get; set; }

    Action<object> _executeDelegate;

    public SimpleDelegateCommand(Action<object> executeDelegate)
    {
        _executeDelegate = executeDelegate;
    }

    public void Execute(object parameter)
    {
        _executeDelegate(parameter);
    }

    public bool CanExecute(object parameter) { return true; }
    public event EventHandler CanExecuteChanged;
}

' Create a class that implements ICommand and accepts a delegate. 
Public Class SimpleDelegateCommand
    Implements ICommand

    ' Specify the keys and mouse actions that invoke the command. 
    Private _GestureKey As Key
    Private _GestureModifier As ModifierKeys
    Private _MouseGesture As MouseAction

    Public Property GestureKey() As Key
        Get
            Return _GestureKey
        End Get
        Set(ByVal value As Key)
            _GestureKey = value
        End Set
    End Property

    Public Property GestureModifier() As ModifierKeys
        Get
            Return _GestureModifier
        End Get
        Set(ByVal value As ModifierKeys)
            _GestureModifier = value
        End Set
    End Property

    Public Property MouseGesture() As MouseAction
        Get
            Return _MouseGesture
        End Get
        Set(ByVal value As MouseAction)
            _MouseGesture = value
        End Set
    End Property

    Private _executeDelegate As Action(Of Object)

    Public Sub New(ByVal executeDelegate As Action(Of Object))
        _executeDelegate = executeDelegate
    End Sub

    Public Sub Execute(ByVal parameter As Object) _
        Implements ICommand.Execute

        _executeDelegate(parameter)
    End Sub

    Public Function CanExecute(ByVal parameter As Object) As Boolean _
        Implements ICommand.CanExecute

        Return True
    End Function

    Public Event CanExecuteChanged As EventHandler _
        Implements ICommand.CanExecuteChanged
End Class

O exemplo seguinte cria e inicializa o ColorChangeCommand, que é um SimpleDelegateCommand. O exemplo também define o método que executa quando o comando é invocado e define as GestureKeypropriedades , GestureModifier, e MouseGesture . Uma aplicação chamaria o InitializeCommand método quando o programa começa, como no construtor de um Window.

public SimpleDelegateCommand ChangeColorCommand
{
    get { return changeColorCommand; }
}

private SimpleDelegateCommand changeColorCommand;

private void InitializeCommand()
{
    originalColor = this.Background;

    changeColorCommand = new SimpleDelegateCommand(x => this.ChangeColor(x));

    DataContext = this;
    changeColorCommand.GestureKey = Key.C;
    changeColorCommand.GestureModifier = ModifierKeys.Control;
    ChangeColorCommand.MouseGesture = MouseAction.RightClick;
}

private Brush originalColor, alternateColor;

// Switch the Background color between
// the original and selected color.
private void ChangeColor(object colorString)
{
    if (colorString == null)
    {
        return;
    }

    Color newColor = 
        (Color)ColorConverter.ConvertFromString((String)colorString);
    
    alternateColor = new SolidColorBrush(newColor);

    if (this.Background == originalColor)
    {
        this.Background = alternateColor;
    }
    else
    {
        this.Background = originalColor;
    }
}

Public ReadOnly Property ChangeColorCommand() As SimpleDelegateCommand
    Get
        Return _changeColorCommand
    End Get
End Property

Private _changeColorCommand As SimpleDelegateCommand
Private originalColor As Brush, alternateColor As Brush

Private Sub InitializeCommand()
    originalColor = Me.Background

    _changeColorCommand = New SimpleDelegateCommand(Function(x) Me.ChangeColor(x))

    DataContext = Me
    _changeColorCommand.GestureKey = Key.C
    _changeColorCommand.GestureModifier = ModifierKeys.Control
    _changeColorCommand.MouseGesture = MouseAction.RightClick
End Sub

' Switch the Background color between 
' the original and selected color. 
Private Function ChangeColor(ByVal colorString As Object) As Integer

    If colorString Is Nothing Then
        Return 0
    End If

    Dim newColor As Color = DirectCast(ColorConverter.ConvertFromString(DirectCast(colorString, [String])), Color)

    alternateColor = New SolidColorBrush(newColor)

    If Brush.Equals(Me.Background, originalColor) Then
        Me.Background = alternateColor
    Else
        Me.Background = originalColor
    End If

    Return 0
End Function

Finalmente, o exemplo seguinte cria a interface de utilizador. O exemplo acrescenta a KeyBinding e a MouseBinding a StackPanel a que contém a Button e um ListBox. Quando o utilizador seleciona um item no ListBox, pode alterar a cor do fundo para a cor selecionada. Em cada caso, a CommandParameter propriedade está ligada ao item selecionado no ListBox, e a Command propriedade está ligada ao ColorChangeCommand. As KeyBinding.Keypropriedades , KeyBinding.Modifiers, e MouseBinding.MouseAction estão ligadas às propriedades correspondentes na SimpleDelegateCommand classe.

<StackPanel Background="Transparent">
  <StackPanel.InputBindings>
    
    <KeyBinding Command="{Binding ChangeColorCommand}"
                CommandParameter="{Binding ElementName=colorPicker, Path=SelectedItem}"
                Key="{Binding ChangeColorCommand.GestureKey}"
                Modifiers="{Binding ChangeColorCommand.GestureModifier}"/>

    <MouseBinding Command="{Binding ChangeColorCommand}"
                  CommandParameter="{Binding ElementName=colorPicker, Path=SelectedItem}"
                  MouseAction="{Binding ChangeColorCommand.MouseGesture}"/>
  
  </StackPanel.InputBindings>
  
  <Button Content="Change Color" 
          Command="{Binding ChangeColorCommand}" 
          CommandParameter="{Binding ElementName=colorPicker, Path=SelectedItem}">
  </Button>

  <ListBox Name="colorPicker"
           Background="Transparent"
           xmlns:sys="clr-namespace:System;assembly=mscorlib">
    <sys:String>Red</sys:String>
    <sys:String>Green</sys:String>
    <sys:String>Blue</sys:String>
    <sys:String>Yellow</sys:String>
    <sys:String>Orange</sys:String>
    <sys:String>Purple</sys:String>
  </ListBox>
</StackPanel>

Observações

Pode especificar que a entrada do utilizador invoca um comando criando um InputBindingcomando . Quando o utilizador executa a entrada especificada, o ICommand que é definido para a Command propriedade é executado.

Pode especificar que o InputBinding invoca um comando definido num objeto criando uma ligação nas Commandpropriedades , CommandParameter, e CommandTarget . Isto permite-lhe definir um comando personalizado e associá-lo à entrada do utilizador. Para mais informações, consulte o segundo exemplo na secção Exemplos.

An InputBinding pode ser definido num objeto específico ou ao nível da classe ao registar a RegisterClassInputBinding com o CommandManager.

A InputBinding própria classe não suporta o uso de XAML porque não expõe um construtor público sem parâmetros (existe um construtor sem parâmetros, mas está protegido). No entanto, classes derivadas podem expor um construtor público e, portanto, podem definir propriedades na classe derivada que são herdadas com InputBinding um uso XAML. Duas classes existentes InputBindingderivadas em que podem ser instanciadas em XAML e podem definir propriedades em XAML são KeyBinding e MouseBinding. A propriedade típica na programação WPF que está definida em XAML e toma um ou mais objetos InputBinding como valores é a propriedade UIElement.InputBindings.

Uso do elemento de objeto XAML

< inputVinculdingDerivedClass.../>

Valores XAML

inputBindingDerivedClass Uma classe derivada de InputBinding que suporta sintaxe de elementos objeto, como KeyBinding ou MouseBinding. Ver Observações.

Ver também

• InputBindings
• CommandBinding