다음을 통해 공유


KeyboardAccelerator 클래스

정의

사용자가 직접 또는 액세스 키를 통해 앱 UI를 탐색하는 대신 키보드를 사용하여 작업을 수행할 수 있는 바로 가기 키(또는 가속기)를 나타냅니다.

가속기는 일반적으로 단추 또는 메뉴 항목에 할당됩니다.

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class KeyboardAccelerator : DependencyObject
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class KeyboardAccelerator : DependencyObject
Public Class KeyboardAccelerator
Inherits DependencyObject
상속
Object IInspectable DependencyObject KeyboardAccelerator
특성

설명

가속기 키는 F1 - F12 및 Esc와 같은 단일 키 또는 명령을 호출하는 키 조합(Ctrl + Shift + B 또는 Ctrl C)일 수 있습니다. 일반적으로 Alt 키를 사용하여 수정되고 명령 또는 컨트롤을 활성화하는 액세스 키(니모닉)와 다릅니다.

액셀러레이터와 연결된 요소가 표시되지 않더라도 액셀러레이터를 실행할 수 있습니다. 예를 들어 CommandBarSecondaryCommands 컬렉션에 있는 항목은 오버플로 메뉴를 확장하고 요소를 표시하지 않고 가속기를 사용하여 호출할 수 있습니다.

기본적으로 액셀러레이터에는 전역 scope 있습니다. 그러나 ScopeOwner를 사용하여 scope 제한하거나 IsEnabled를 사용하여 가속기를 완전히 사용하지 않도록 설정할 수 있습니다.

생성자

KeyboardAccelerator()

KeyboardAccelerator 클래스의 새 instance 초기화합니다.

속성

Dispatcher

항상 Windows 앱 SDK 앱에서 를 반환 null 합니다. 대신 DispatcherQueue 를 사용합니다.

(다음에서 상속됨 DependencyObject)
DispatcherQueue

DispatcherQueue 이 개체가 연결된 을 가져옵니다. 는 DispatcherQueue 코드가 비 UI 스레드에 의해 시작되는 경우에도 UI 스레드에서 에 액세스할 DependencyObject 수 있는 기능을 나타냅니다.

(다음에서 상속됨 DependencyObject)
IsEnabled

사용자가 바로 가기 키(액셀러레이터)를 사용할 수 있는지 여부를 가져오거나 설정합니다.

IsEnabledProperty

IsEnabled 종속성 속성을 식별합니다.

Key

바로 가기 키(액셀러레이터)에 대한 가상 키(하나 이상의 한정자 키와 함께 사용됨)를 가져오거나 설정합니다.

바로 가기 키와 연결된 한정자 키를 누른 다음 한정자가 아닌 키를 동시에 누르면 바로 가기 키가 호출됩니다. 예를 들어 복사의 경우 Ctrl+C, 저장의 경우 Ctrl+S를 사용합니다.

KeyProperty

종속성 속성을 식별합니다.

Modifiers

바로 가기 키(액셀러레이터)에 대한 다른 키 프레스를 수정하는 데 사용되는 가상 키를 가져오거나 설정합니다.

바로 가기 키와 연결된 한정자 키를 누른 다음 한정자가 아닌 키를 동시에 누르면 바로 가기 키가 호출됩니다. 예를 들어 복사의 경우 Ctrl+C, 저장의 경우 Ctrl+S를 사용합니다.

ModifiersProperty

한정자 종속성 속성을 식별합니다.

ScopeOwner

키보드 가속기의 scope(또는 대상)를 가져오거나 설정합니다.

ScopeOwnerProperty

ScopeOwner 종속성 속성을 식별합니다.

메서드

ClearValue(DependencyProperty)

종속성 속성의 로컬 값을 지웁니다.

(다음에서 상속됨 DependencyObject)
GetAnimationBaseValue(DependencyProperty)

애니메이션이 활성화되지 않은 경우 적용되는 종속성 속성에 대해 설정된 모든 기본 값을 반환합니다.

(다음에서 상속됨 DependencyObject)
GetValue(DependencyProperty)

DependencyObject에서 종속성 속성의 현재 유효 값을 반환합니다.

(다음에서 상속됨 DependencyObject)
ReadLocalValue(DependencyProperty)

로컬 값이 설정된 경우 종속성 속성의 로컬 값을 반환합니다.

(다음에서 상속됨 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

DependencyObject instance 특정 DependencyProperty의 변경 내용을 수신 대기하기 위한 알림 함수를 등록합니다.

(다음에서 상속됨 DependencyObject)
SetValue(DependencyProperty, Object)

DependencyObject에서 종속성 속성의 로컬 값을 설정합니다.

(다음에서 상속됨 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

RegisterPropertyChangedCallback을 호출하여 이전에 등록된 변경 알림을 취소합니다.

(다음에서 상속됨 DependencyObject)

이벤트

Invoked

KeyboardAccelerator 의 키 조합을 누를 때 발생합니다.

적용 대상

추가 정보