다음을 통해 공유


AppBarButton.KeyboardAcceleratorTextOverride 속성

정의

키보드 가속기와 연결된 기본 키 조합 문자열을 재정의하는 문자열을 가져오거나 설정합니다.

다양한 메뉴 항목에 대한 키보드 가속기를 보여 주는 메뉴의 예
다양한 메뉴 항목에 대한 키보드 가속기를 보여 주는 메뉴의 예

public:
 property Platform::String ^ KeyboardAcceleratorTextOverride { Platform::String ^ get(); void set(Platform::String ^ value); };
winrt::hstring KeyboardAcceleratorTextOverride();

void KeyboardAcceleratorTextOverride(winrt::hstring value);
public string KeyboardAcceleratorTextOverride { get; set; }
var string = appBarButton.keyboardAcceleratorTextOverride;
appBarButton.keyboardAcceleratorTextOverride = string;
Public Property KeyboardAcceleratorTextOverride As String

속성 값

String

Platform::String

winrt::hstring

기본 키 조합 문자열을 대체할 문자열입니다. 기본값은 null입니다.

텍스트 없이 단일 공간을 사용합니다.

Windows 요구 사항

디바이스 패밀리
Windows 10, version 1803 (10.0.17134.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v6.0에서 도입되었습니다.)

설명

Windows 10 버전 1703에는 바로 가기 키가 도입되었습니다. 그러나 이러한 바로 가기는 해당 컨트롤의 UI와 함께 표시되지 않았습니다.

Windows 10 버전 1803부터 KeyboardAccelerators가 선언되면 컨트롤은 기본적으로 해당 키 조합을 표시합니다.

시스템에서 연결된 키보드를 검색할 수 없는 경우 재정의 텍스트가 표시되지 않습니다(KeyboardPresent 속성을 통해 이를 자체적으로 확인할 수 있음).

버전 호환성

KeyboardAcceleratorTextOverride 속성은 Windows 10 버전 1803 이전에는 사용할 수 없습니다. Microsoft Visual Studio에서 앱의 '최소 플랫폼 버전' 설정이 이 페이지의 뒷부분에 있는 요구 사항 블록에 표시된 '도입된 버전'보다 작은 경우 이를 고려하여 앱을 디자인하고 테스트해야 합니다. 자세한 내용은 버전 적응 코드를 참조하세요.

앱이 이전 버전의 Windows 10 실행되는 경우 예외를 방지하려면 XAML에서 이 속성을 설정하거나 런타임 검사 수행하지 않고 사용하지 마세요. 이 예제에서는 ApiInformation 클래스를 사용 하 여 설정 하기 전에이 속성의 존재에 대 한 검사 하는 방법을 보여 집니다.

<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded">
    <AppBarButton x:Name="appBarButtonCut" Icon="Cut" Label="Cut"/>
</CommandBar>
private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AppBarButton", "KeyboardAcceleratorTextOverride"))
    {
        appBarButtonCut.KeyboardAcceleratorTextOverride = "Ctrl+C";
    }
}

적용 대상

추가 정보