AppBarButton.KeyboardAcceleratorTextOverride 屬性

定義

命名空間:

Microsoft.UI.Xaml.Controls

取得或設定字串，此字串會覆寫與 鍵盤快捷鍵相關聯的預設按鍵組合字串。

顯示各種功能表項鍵盤快捷鍵的功能表範例

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 10 1703 版引進了鍵盤快捷鍵。 不過，這些快捷方式並未顯示其對應控件的UI。

從宣告 KeyboardAccelerators Windows 10 1803 版開始，控件預設會顯示對應的按鍵組合。

若系統無法偵測到已連結的鍵盤 (您可以透過 KeyboardPresent 屬性檢查)，便不會顯示覆寫文字。

版本相容性

KeyboardAcceleratorTextOverride 屬性在 Windows 10 1803 版之前無法使用。 如果您的 App 在 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";
    }
}

另請參閱

• 鍵盤快速鍵