InputBinding Klasse

Definition

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

Vererbung

Object

DispatcherObject

DependencyObject

InputBinding

Vererbung

Object

DispatcherObject

DependencyObject

Freezable

InputBinding

Abgeleitet

System.Windows.Input.KeyBinding

System.Windows.Input.MouseBinding

Implementiert

ICommandSource

Beispiele

Das folgende Beispiel zeigt, wie sie eine KeyBinding Bindung KeyGesture an den Open Befehl verwenden. Wenn die Tastengeste ausgeführt wird, wird der Befehl "Öffnen" aufgerufen.

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

Die folgenden Beispiele zeigen, wie ein benutzerdefinierter Befehl an InputBinding Objekte gebunden wird. In diesen Beispielen wird eine Anwendung erstellt, mit der der Benutzer die Hintergrundfarbe ändern kann, indem eine der folgenden Aktionen ausgeführt wird:

• Klicken auf eine Schaltfläche.

• Drücken von STRG+C.

• Klicken mit der rechten Maustaste auf ein StackPanel (außerhalb des ListBox).

Im ersten Beispiel wird eine Klasse mit dem Namen SimpleDelegateCommand. Diese Klasse akzeptiert einen Delegaten, sodass das Objekt, das den Befehl erstellt, die Aktion definieren kann, die beim Ausführen des Befehls auftritt. SimpleDelegateCommand definiert außerdem Eigenschaften, mit denen angegeben wird, welche Taste und Mauseingabe den Befehl aufruft. GestureKey und GestureModifier geben Sie die Tastatureingabe an. MouseGesture Gibt die Mauseingabe an.

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

Das folgende Beispiel erstellt und initialisiert den , der ColorChangeCommandein SimpleDelegateCommand. Im Beispiel wird auch die Methode definiert, die ausgeführt wird, wenn der Befehl aufgerufen wird, und legt die GestureKeyEigenschaften und MouseGesture Eigenschaften GestureModifierfest. Eine Anwendung würde die InitializeCommand Methode aufrufen, wenn das Programm beginnt, z. B. im Konstruktor eines 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

Schließlich erstellt das folgende Beispiel die Benutzeroberfläche. Im Beispiel wird eine KeyBinding und eine MouseBinding zu einer StackPanel , die ein Button und eine enthält, hinzugefügt ListBox. Wenn der Benutzer ein Element im ListBoxBereich auswählt, kann er die Farbe des Hintergrunds in die ausgewählte Farbe ändern. In jedem Fall ist die CommandParameter Eigenschaft an das ausgewählte Element im ListBox, und die Command Eigenschaft ist an die ColorChangeCommand. Die KeyBinding.KeyEigenschaften KeyBinding.Modifiersund MouseBinding.MouseAction Eigenschaften sind an die entsprechenden Eigenschaften der SimpleDelegateCommand Klasse gebunden.

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

Hinweise

Sie können angeben, dass die Benutzereingabe einen Befehl aufruft, indem Sie eine InputBinding. Wenn der Benutzer die angegebene Eingabe ausführt, wird der ICommand Wert auf die Command Eigenschaft festgelegt.

Sie können angeben, dass der Aufruf eines Befehls, der InputBinding für ein Objekt definiert ist, durch Erstellen einer Bindung für die Command, CommandParameterund CommandTarget Eigenschaften. Auf diese Weise können Sie einen benutzerdefinierten Befehl definieren und ihn benutzereingaben zuordnen. Weitere Informationen finden Sie im zweiten Beispiel im Abschnitt "Beispiele".

Ein InputBinding kann für ein bestimmtes Objekt oder auf Klassenebene definiert werden, indem ein RegisterClassInputBinding Benutzer registriert CommandManagerwird.

Die InputBinding Klasse selbst unterstützt keine XAML-Verwendung, da sie keinen öffentlichen parameterlosen Konstruktor verfügbar macht (es gibt einen parameterlosen Konstruktor, aber es ist geschützt). Abgeleitete Klassen können jedoch einen öffentlichen Konstruktor verfügbar machen und daher Eigenschaften für die abgeleitete Klasse festlegen, die von InputBinding einer XAML-Verwendung geerbt werden. Zwei vorhandene InputBindingabgeleitete Klassen, die in XAML instanziiert werden können und Eigenschaften in XAML festlegen können, sind KeyBinding und MouseBinding. Die typische Eigenschaft in der WPF-Programmierung, die in XAML festgelegt ist und ein oder InputBinding mehrere Objekte als Werte UIElement.InputBindings akzeptiert.

XAML-Objektelementverwendung

< inputBindingDerivedClass.../>

XAML-Werte

inputBindingDerivedClass Eine abgeleitete Klasse, die InputBinding objektelementsyntax unterstützt, z KeyBinding . B. oder MouseBinding. Weitere Informationen finden Sie in der "Anmerkungen".

Weitere Informationen

• InputBindings
• CommandBinding