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 에 바인딩을 KeyGestureOpen 명령에 합니다. 키 제스처가 수행되면 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

다음 예제에서는 을 만들고 초기화합니다ColorChangeCommandSimpleDelegateCommand. 이 예제에서는 명령이 호출될 때 실행되는 메서드를 정의하고 , GestureModifier및 MouseGesture 속성을 설정합니다GestureKey. 애플리케이션 호출을 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

마지막으로 다음 예제에서는 사용자 인터페이스를 만듭니다. 이 예제에서는 및 KeyBindingMouseBinding 를 포함하는 에 StackPanel 및 ListBox를 Button 추가합니다. 사용자가 에서 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 실행됩니다.

에서 , CommandParameter및 CommandTarget 속성에 바인딩을 만들어 Command개체에 정의된 명령을 호출할 수 InputBinding 있습니다. 이렇게 하면 사용자 지정 명령을 정의하고 사용자 입력과 연결할 수 있습니다. 자세한 내용은 예제 섹션의 두 번째 예제를 참조하세요.

를 InputBinding 에 등록하여 RegisterClassInputBindingCommandManager특정 개체 또는 클래스 수준에서 를 정의할 수 있습니다.

InputBinding 클래스 자체는 공용 매개 변수 없는 생성자를 노출하지 않기 때문에 XAML 사용을 지원하지 않습니다(매개 변수가 없는 생성자는 있지만 보호됨). 그러나 파생 클래스는 공용 생성자를 노출할 수 있으므로 XAML 사용량으로 에서 상속되는 파생 클래스의 InputBinding 속성을 설정할 수 있습니다. XAML에서 인스턴스화할 수 있고 XAML에서 속성을 설정할 수 있는 두 개의 기존 InputBinding파생 클래스는 및 MouseBinding입니다KeyBinding. XAML에서 설정되고 값이 속성이므로 하나 이상의 InputBinding 개체를 사용하는 WPF 프로그래밍의 UIElement.InputBindings 일반적인 속성입니다.

XAML 개체 요소 사용

<inputBindingDerivedClass.../>

XAML 값

inputBindingDerivedClass
또는 MouseBinding와 같은 KeyBinding 개체 요소 구문을 지원하는 의 InputBinding 파생 클래스입니다. 설명 부분을 참조하세요.

생성자

필드

속성

메서드

이벤트

적용 대상

추가 정보

• InputBindings
• CommandBinding