KeyGesture 클래스

  • 참조

정의

네임스페이스:
System.Windows.Input
어셈블리:
PresentationCore.dll

명령을 호출하는 데 사용할 수 있는 키보드 조합을 정의합니다.

public ref class KeyGesture : System::Windows::Input::InputGesture
[System.ComponentModel.TypeConverter(typeof(System.Windows.Input.KeyGestureConverter))]
public class KeyGesture : System.Windows.Input.InputGesture
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Input.KeyGestureConverter))>]
type KeyGesture = class
    inherit InputGesture
Public Class KeyGesture
Inherits InputGesture
상속
Object
InputGesture
KeyGesture
특성
TypeConverterAttribute

예제

다음 예제에서는 바인딩하는 방법을 보여줍니다 합니다 Close 명령을 KeyGesture 사용 하 여를 KeyBinding입니다.

KeyGesture CloseCmdKeyGesture = new KeyGesture(
    Key.L, ModifierKeys.Alt);

KeyBinding CloseKeyBinding = new KeyBinding(
    ApplicationCommands.Close, CloseCmdKeyGesture);

this.InputBindings.Add(CloseKeyBinding);

Dim CloseCmdKeyGesture As New KeyGesture(Key.L, ModifierKeys.Alt)

Dim CloseKeyBinding As New KeyBinding(ApplicationCommands.Close, CloseCmdKeyGesture)

Me.InputBindings.Add(CloseKeyBinding)

다음 예제에서는 XAML에서 를 사용하는 KeyGesture 방법을 보여줍니다. XAML 사용은 요소를 직접 선언 <KeyGesture> 하지 않습니다. 공용 매개 변수 없는 생성자를 노출하지 않으므로 해당 개체 요소 사용이 불가능 KeyGesture 합니다. 대신 XAML 사용은 typeconverter 동작을 사용하여 전체 KeyGesture 인라인을 특성 값으로 Gesture 선언합니다.

<Window.InputBindings>
  <KeyBinding Command="ApplicationCommands.Open"
              Gesture="CTRL+R" />
</Window.InputBindings>

설명

대부분의 경우에는 KeyGesture 하나를 사용 하 여 연결 해야 ModifierKeys합니다. 이 규칙에 대 한 예외는 기능 키와 숫자 키패드의 키를 유효한 수 KeyGesture 자체적으로 합니다. 예를 들어, 만들 수 있습니다는 KeyGesture 에서 키 X를 사용 하는 F12 키만 사용 하 여는 KeyGesture 한정자 키를 사용 하 여 쌍으로 연결할 수 있어야 합니다.

사용할 수는 KeyBinding 바인딩할를 KeyGesture 에 ICommand명령이 호출 될 수 있도록 때는 KeyGesture 발생 합니다.

XAML 사용의 경우 KeyGesture 제스처가 표준 키와 한정자 키를 모두 나타내는 경우 XAML에서 일반적으로 설정된 속성은 입니다 Gesture. 설정할 수도 있습니다는 Gesture 속성을 함수 키 또는 한정자 키 조합입니다. 그러나는 것이 설정에 자주 합니다 Key 의도 한 명령 바인딩이 없는 한정자를 사용 하 여 함수 키 이면 속성 또는 Modifiers 의도 한 명령 바인딩 한정자 키만에 대 한 경우.

XAML 특성 사용

<object property="oneOrMoreModifierKeys+key"/>  
- or -  
<object property="functionKey"/>

XAML 값

functionKey
Key

단일 키 값, 함수 키 (F1-12) 또는 숫자 키패드 키 중 하나 여야 합니다.

oneOrMoreModifierKeys
정의한 하나 이상의 보조 키를 ModifierKeys 열거형, "+" 문자를 사용 하 여 구분 합니다.

key
Key

단일 키 값입니다.

생성자

KeyGesture(Key)

지정된 KeyGesture를 사용하여 Key 클래스의 새 인스턴스를 초기화합니다.
KeyGesture(Key, ModifierKeys)

지정된 KeyGesture 및 Key를 사용하여 ModifierKeys 클래스의 새 인스턴스를 초기화합니다.
KeyGesture(Key, ModifierKeys, String)

지정한 KeyGesture, Key와 표시 문자열을 사용하여 ModifierKeys 클래스의 새 인스턴스를 초기화합니다.

속성

DisplayString

이 KeyGesture에 대한 문자열 표현을 가져옵니다.
Key

이 KeyGesture와 연결된 키를 가져옵니다.
Modifiers

이 KeyGesture와 연결된 보조키를 가져옵니다.

메서드

Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.

(다음에서 상속됨 Object)
GetDisplayStringForCulture(CultureInfo)

KeyGesture를 표시하는 데 사용할 수 있는 문자열을 반환합니다.
GetHashCode()

기본 해시 함수로 작동합니다.

(다음에서 상속됨 Object)
GetType()

현재 인스턴스의 Type을 가져옵니다.

(다음에서 상속됨 Object)
Matches(Object, InputEventArgs)

이 KeyGesture가 지정한 InputEventArgs 개체와 연결된 입력과 일치하는지 여부를 확인합니다.
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
ToString()

현재 개체를 나타내는 문자열을 반환합니다.

(다음에서 상속됨 Object)

적용 대상

추가 정보