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

Начиная с 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";
    }
}

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

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