AppBarToggleButton.KeyboardAcceleratorTextOverride 屬性

定義

命名空間:

Windows.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 = appBarToggleButton.keyboardAcceleratorTextOverride;
appBarToggleButton.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。

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

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

版本相容性

KeyboardAcceleratorTextOverride 屬性在 Windows 10 1803 版之前無法使用。 如果您的 App 在 Microsoft Visual Studio 中的「最低平臺版本」設定小於此頁面稍後的 [需求] 區塊中顯示的「引進版本」，您必須設計並測試您的應用程式以考慮此設定。 如需詳細資訊，請參閱 版本調適型程式碼。

若要避免在舊版Windows 10上執行應用程式時發生例外狀況，請勿在 XAML 中設定此屬性，或在不執行執行時間檢查的情況下使用它。 此範例示範如何使用 ApiInformation 類別，在設定此屬性之前檢查此屬性是否存在。

<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded">
    <AppBarToggleButton x:Name="appBarButtonShuffle" Icon="Shuffle" Label="Shuffle"/>
</CommandBar>

private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AppBarToggleButton", "KeyboardAcceleratorTextOverride"))
    {
        appBarButtonCut.KeyboardAcceleratorTextOverride = "Ctrl+S";
    }
}

另請參閱

• 鍵盤快速鍵