InputBinding Класс

Определение

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

Наследование

Object

DispatcherObject

DependencyObject

InputBinding

Наследование

Object

DispatcherObject

DependencyObject

Freezable

InputBinding

Производный

System.Windows.Input.KeyBinding

System.Windows.Input.MouseBinding

Реализации

ICommandSource

Примеры

В следующем примере показано, как использовать KeyBinding для привязки KeyGesture к команде Open . При выполнении ключевого жеста вызывается команда Открыть.

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

В следующих примерах показано, как привязать пользовательскую команду к InputBinding объектам . В этих примерах создается приложение, которое позволяет пользователю изменять цвет фона, выполняя одно из следующих действий:

• Нажатие кнопки.

• Нажмите клавиши CTRL+C.

• Щелчок правой кнопкой StackPanel мыши (за пределами ListBox).

В первом примере создается класс с именем SimpleDelegateCommand. Этот класс принимает делегат, чтобы объект, создающий команду, смог определить действие, выполняемое при выполнении команды. SimpleDelegateCommand также определяет свойства, указывающие, какой ввод клавиши и мыши вызывает команду. GestureKey и GestureModifier задает ввод с клавиатуры; MouseGesture указывает ввод с помощью мыши.

 // 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

В следующем примере создается и инициализируется ColorChangeCommandобъект , который является SimpleDelegateCommand. В примере также определяется метод , который выполняется при вызове команды и задает GestureKeyсвойства , GestureModifierи MouseGesture . Приложение вызывает InitializeCommand метод при запуске программы, например в конструкторе 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

Наконец, в следующем примере создается пользовательский интерфейс. В примере добавляются KeyBinding и в MouseBinding , StackPanel содержащий Button и ListBox. Когда пользователь выбирает элемент в ListBox, он может изменить цвет фона на выбранный. В каждом случае CommandParameter свойство привязывается к выбранному элементу ListBoxв , а Command свойство — к ColorChangeCommand. Свойства KeyBinding.Key, KeyBinding.Modifiersи MouseBinding.MouseAction привязаны к соответствующим свойствам SimpleDelegateCommand класса .

<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>

Комментарии

Можно указать, что входные данные пользователя вызывают команду, создав InputBinding. Когда пользователь выполняет указанные входные данные, ICommand выполняется свойство , для свойства Command .

Можно указать, что InputBinding вызывает команду, определенную для объекта , создав привязку Commandдля свойств , CommandParameterи CommandTarget . Это позволяет определить пользовательскую команду и связать ее с вводимыми пользователем данными. Дополнительные сведения см. во втором примере в разделе Примеры.

Можно InputBinding определить в определенном объекте или на уровне класса путем регистрации RegisterClassInputBinding в CommandManager.

Сам InputBinding класс не поддерживает использование XAML, так как он не предоставляет открытый конструктор без параметров (существует конструктор без параметров, но он защищен). Однако производные классы могут предоставлять открытый конструктор и, следовательно, могут задавать свойства для производного класса, унаследованные от InputBinding с использованием XAML. Два существующих InputBindingпроизводных от класса, которые могут создаваться в XAML и задавать свойства в XAML, — это KeyBinding и MouseBinding. Типичное свойство в программировании WPF, которое задается в XAML и принимает один или несколько InputBinding объектов в качестве значений, является свойством UIElement.InputBindings .

Использование элемента объекта XAML

< inputBindingDerivedClass.../>

Значения XAML

inputBindingDerivedClass
Производный класс класса , InputBinding поддерживающий синтаксис элемента объекта, например KeyBinding или MouseBinding. См. заметки.

Конструкторы

Поля

Свойства

Методы

События

Применяется к

См. также раздел

• InputBindings
• CommandBinding