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Значение свойства
Строка для замены строки сочетания клавиш по умолчанию. Значение по умолчанию — 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";
}
}