InputBinding Třída

Definice

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

Dědičnost

Object

DispatcherObject

DependencyObject

InputBinding

Dědičnost

Object

DispatcherObject

DependencyObject

Freezable

InputBinding

Odvozené

System.Windows.Input.KeyBinding

System.Windows.Input.MouseBinding

Implementuje

ICommandSource

Příklady

Následující příklad ukazuje, jak použít k KeyBinding vytvoření vazby s příkazem OpenKeyGesture . Při provedení gesta klávesy se vyvolá příkaz Otevřít.

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

Následující příklady ukazují, jak vytvořit vazbu vlastního příkazu na InputBinding objekty. Tyto příklady vytvoří aplikaci, která uživateli umožní změnit barvu pozadí provedením jedné z následujících akcí:

• Kliknutí na tlačítko

• Stiskněte kombinaci kláves CTRL+C.

• Kliknutí pravým tlačítkem na ( StackPanel mimo ListBox).

První příklad vytvoří třídu s názvem SimpleDelegateCommand. Tato třída přijímá delegáta, aby objekt vytvářející příkaz mohl definovat akci, ke které dojde při spuštění příkazu. SimpleDelegateCommand definuje také vlastnosti, které určují, jakou klávesu a vstup myši vyvolá příkaz . GestureKey a GestureModifier zadejte vstup z klávesnice; MouseGesture určuje vstup myši.

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

Následující příklad vytvoří a inicializuje ColorChangeCommand, což je SimpleDelegateCommand. Příklad také definuje metodu, která se spustí při vyvolání příkazu a nastaví GestureKeyvlastnosti , GestureModifiera MouseGesture . Aplikace by volala metodu InitializeCommand při spuštění programu, například v konstruktoru objektu 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

Nakonec následující příklad vytvoří uživatelské rozhraní. Příklad přidá KeyBinding a do objektu MouseBindingStackPanel , který obsahuje Button a ListBox. Když uživatel vybere položku v ListBox, může změnit barvu pozadí na vybranou barvu. V každém případě CommandParameter je vlastnost svázaná s vybranou položkou v objektu ListBoxa Command vlastnost je svázaná s objektem ColorChangeCommand. Vlastnosti KeyBinding.Key, KeyBinding.Modifiersa MouseBinding.MouseAction jsou svázány s odpovídajícími vlastnostmi třídy 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>

Poznámky

Můžete určit, že uživatelský vstup vyvolá příkaz, a to vytvořením InputBinding. Když uživatel provede zadaný vstup, ICommand provede se vlastnost , která je nastavena Command na vlastnost .

Můžete určit, že InputBinding vyvolá příkaz definovaný u objektu vytvořením vazby pro Commandvlastnosti , CommandParametera CommandTarget . To vám umožní definovat vlastní příkaz a přidružit ho ke vstupu uživatele. Další informace najdete ve druhém příkladu v části Příklady.

Objekt InputBinding lze definovat u konkrétního objektu nebo na úrovni třídy registrací RegisterClassInputBinding objektu CommandManagerpomocí .

Samotná InputBinding třída nepodporuje použití XAML, protože nezpřístupňuje veřejný konstruktor bez parametrů (existuje konstruktor bez parametrů, ale je chráněný). Odvozené třídy však mohou vystavit veřejný konstruktor, a proto mohou nastavit vlastnosti odvozené třídy, které jsou zděděné s InputBinding použitím XAML. Dvě existující InputBindingtřídy odvozené od instancí, které je možné vytvořit v xaml a nastavit vlastnosti v XAML, jsou KeyBinding a MouseBinding. Typická vlastnost v programování WPF, která je nastavena v XAML a přebírá jeden nebo více InputBinding objektů jako hodnoty, je UIElement.InputBindings vlastnost .

Použití elementu objektu XAML

<inputBindingDerivedClass.../>

Hodnoty XAML

inputBindingDerivedClass
Odvozená třída , která podporuje syntaxi elementu InputBinding objektu, například KeyBinding nebo MouseBinding. Viz Poznámky.

Konstruktory

Pole

Vlastnosti

Metody

Událost

Platí pro

Viz také

• InputBindings
• CommandBinding