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
Наследование
Object IInspectable DependencyObject XamlUICommand
Производный
Атрибуты
Реализации

Требования к 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 .

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

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