Поделиться через


AppBarToggleButton.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 = 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 появились сочетания клавиш . Однако эти сочетания клавиш не отображались в пользовательском интерфейсе соответствующих элементов управления.

Начиная с Windows 10 версии 1803, при объявлении KeyboardAccelerators элементы управления по умолчанию отображают соответствующие сочетания клавиш.

Переопределенный текст не будет отображаться, если система не сможет определить, подключена ли клавиатура (вы можете проверить это самостоятельно с помощью свойства KeyboardPresent).

Совместимость версий

Свойство KeyboardAcceleratorTextOverride недоступно до Windows 10 версии 1803. Если параметр "минимальная версия платформы" вашего приложения в 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";
    }
}

Применяется к

См. также раздел