XamlUICommand Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет базовый класс для определения поведения команды интерактивного элемента пользовательского интерфейса, который выполняет действие при вызове (например, отправка сообщения электронной почты, удаление элемента или отправка формы).
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 458752)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class XamlUICommand : DependencyObject, ICommand
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 458752)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class XamlUICommand : DependencyObject, ICommand
Public Class XamlUICommand
Inherits DependencyObject
Implements ICommand
- Наследование
- Производный
- Атрибуты
- Реализации
Требования к Windows
Семейство устройств |
Windows 10, version 1809 (появилось в 10.0.17763.0)
|
API contract |
Windows.Foundation.UniversalApiContract (появилось в v7.0)
|
Примеры
Совет
Дополнительные сведения, рекомендации по проектированию и примеры кода см. в статье Основы проектирования команд.
Если у вас установлено приложение коллекции WinUI 2 , щелкните здесь, чтобы открыть приложение и увидеть StandardUICommand в действии.
Комментарии
Реализует интерфейс ICommand (Windows.UI.Xaml.Input.ICommand для C++ или System.Windows.Input.ICommand для C#), добавляя различные свойства, методы и события пользовательского интерфейса.
Производные классы XamlUICommand
XamlUICommand — это родительский класс для StandardUICommand, который предоставляет набор стандартных команд платформы с предопределенными свойствами.
Базовый пример выполнения команд см. в разделе Элемент управления Кнопка , который предназначен для того, чтобы что-то произошло, когда пользователь щелкает его.
Существует два способа обработки команды Button (элементы управления со свойством Command поддерживают аналогичные функции):
- Обработка события Click
- Привязка свойства Command к реализации ICommand, описывающей логику команды
XamlUICommand позволяет указать пользовательский интерфейс через привязку элемента управления, например значок, метку, описание и сочетания клавиш (клавиша доступа и ускоритель клавиатуры) без настройки отдельных свойств.
Конструкторы
XamlUICommand() |
Инициализирует новый экземпляр класса XamlUICommand . |
Свойства
AccessKey |
Возвращает или задает ключ доступа (мнемонический) для этого элемента. |
AccessKeyProperty |
Определяет свойство зависимостей AccessKey . |
Command |
Возвращает или задает поведение команды интерактивного элемента пользовательского интерфейса, выполняющего действие при вызове, например отправку сообщения электронной почты, удаление элемента или отправку формы. |
CommandProperty |
Идентифицирует свойство зависимости Command . |
Description |
Возвращает или задает описание для этого элемента. |
DescriptionProperty |
Идентифицирует свойство зависимости Description . |
Dispatcher |
Возвращает объект CoreDispatcher , с которым связан этот объект. CoreDispatcher представляет собой средство, которое может получить доступ к DependencyObject в потоке пользовательского интерфейса, даже если код инициируется потоком, не относящегося к пользовательскому интерфейсу. (Унаследовано от DependencyObject) |
IconSource |
Возвращает или задает глиф из шрифта Segoe MDL2 Assets для этого элемента. |
IconSourceProperty |
Определяет свойство зависимости IconSource . |
KeyboardAccelerators |
Возвращает или задает коллекцию сочетаний клавиш для этого элемента, которые вызывают действие с помощью клавиатуры. |
KeyboardAcceleratorsProperty |
Определяет свойство зависимостей KeyboardAccelerators . |
Label |
Возвращает или задает метку для этого элемента. |
LabelProperty |
Идентифицирует свойство зависимостей Label . |
Методы
CanExecute(Object) |
Возвращает значение, указывая, может ли команда выполняться в текущем состоянии. |
ClearValue(DependencyProperty) |
Очищает локальное значение свойства зависимостей. (Унаследовано от DependencyObject) |
Execute(Object) |
Вызывает команду. |
GetAnimationBaseValue(DependencyProperty) |
Возвращает любое базовое значение, установленное для свойства зависимостей, которое применяется в случаях, когда анимация не активна. (Унаследовано от DependencyObject) |
GetValue(DependencyProperty) |
Возвращает текущее действующее значение свойства зависимостей из DependencyObject. (Унаследовано от DependencyObject) |
NotifyCanExecuteChanged() |
Уведомляет систему об изменении состояния команды. |
ReadLocalValue(DependencyProperty) |
Возвращает локальное значение свойства зависимостей, если задано локальное значение. (Унаследовано от DependencyObject) |
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Регистрирует функцию уведомления для прослушивания изменений определенного DependencyProperty в этом экземпляре DependencyObject . (Унаследовано от DependencyObject) |
SetValue(DependencyProperty, Object) |
Задает локальное значение свойства зависимостей для Объекта DependencyObject. (Унаследовано от DependencyObject) |
UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Отменяет уведомление об изменениях, которое было ранее зарегистрировано путем вызова Метода RegisterPropertyChangedCallback. (Унаследовано от DependencyObject) |
События
CanExecuteChanged |
Возникает всякий раз, когда происходит что-то, что влияет на возможность выполнения команды. |
CanExecuteRequested |
Происходит при вызове CanExecute . |
ExecuteRequested |
Происходит при выполнении вызова Execute . |