KeyboardAccelerator Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет сочетание клавиш (или акселератор), которое позволяет пользователю выполнять действие с помощью клавиатуры вместо навигации по пользовательскому интерфейсу приложения (напрямую или с помощью клавиш доступа).
Ускорители обычно назначаются кнопкам или элементам меню.
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class KeyboardAccelerator : DependencyObject
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class KeyboardAccelerator : DependencyObject
Public Class KeyboardAccelerator
Inherits DependencyObject
- Наследование
- Атрибуты
Комментарии
Клавиша акселератора может быть одним ключом, например F1 – F12 и ESC, или сочетанием клавиш (CTRL+ SHIFT+ B или CTRL C), которые вызывают команду. Они отличаются от ключей доступа (mnemonics), которые обычно изменяются с помощью клавиши ALT и просто активируют команду или элемент управления.
Акселератор можно выполнить, даже если элемент, связанный с акселератором, не отображается. Например, элемент в коллекции SecondaryCommandscommandBar можно вызвать с помощью акселератора, не расширяя меню переполнения и отображая элемент.
По умолчанию акселератор имеет глобальную область. Однако можно ограничить область с помощью ScopeOwner или полностью отключить акселератор с помощью IsEnabled.
Конструкторы
| Имя | Описание |
|---|---|
| KeyboardAccelerator() |
Инициализирует новый экземпляр класса KeyboardAccelerator . |
Свойства
| Имя | Описание |
|---|---|
| Dispatcher |
Всегда возвращается |
| DispatcherQueue |
Возвращает, |
| IsEnabled |
Возвращает или задает возможность доступа к сочетанию клавиш (акселератору) пользователю. |
| IsEnabledProperty |
Определяет свойство зависимостей IsEnabled . |
| Key |
Получает или задает виртуальный ключ (используемый в сочетании с одним или несколькими клавишами модификатора) для сочетания клавиш (акселератор). Сочетание клавиш вызывается при нажатии клавиш модификатора, связанных с сочетанием клавиш, а затем нажатие клавиши без модификатора одновременно. Например, CTRL+C для копирования и CTRL+S для сохранения. |
| KeyProperty |
Определяет свойство зависимостей key . |
| Modifiers |
Возвращает или задает виртуальный ключ, используемый для изменения другого нажатия клавиш для сочетания клавиш (акселератор). Сочетание клавиш вызывается при нажатии клавиш модификатора, связанных с сочетанием клавиш, а затем нажатие клавиши без модификатора одновременно. Например, CTRL+C для копирования и CTRL+S для сохранения. |
| ModifiersProperty |
Определяет свойство зависимостей модификаторов . |
| ScopeOwner |
Возвращает или задает область (или целевой объект) акселератора клавиатуры. |
| ScopeOwnerProperty |
Определяет свойство зависимостей ScopeOwner . |
Методы
| Имя | Описание |
|---|---|
| ClearValue(DependencyProperty) |
Очищает локальное значение свойства зависимостей. (Унаследовано от DependencyObject) |
| GetAnimationBaseValue(DependencyProperty) |
Возвращает любое базовое значение, установленное для свойства зависимостей, которое будет применяться в случаях, когда анимация не активна. (Унаследовано от DependencyObject) |
| GetValue(DependencyProperty) |
Возвращает текущее эффективное значение свойства зависимостей из DependencyObject. (Унаследовано от DependencyObject) |
| ReadLocalValue(DependencyProperty) |
Возвращает локальное значение свойства зависимостей, если задано локальное значение. (Унаследовано от DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Регистрирует функцию уведомлений для прослушивания изменений в определенном экземпляре DependencyProperty в этом экземпляре DependencyObject . (Унаследовано от DependencyObject) |
| SetValue(DependencyProperty, Object) |
Задает локальное значение свойства зависимостей в DependencyObject. (Унаследовано от DependencyObject) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Отменяет уведомление об изменении, которое ранее было зарегистрировано путем вызова RegisterPropertyChangedCallback. (Унаследовано от DependencyObject) |
События
| Имя | Описание |
|---|---|
| Invoked |
Происходит при нажатии сочетания клавиш для этого клавиатурногоaccelerator . |