XamlUICommand 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
提供一个基类，用于定义交互式 UI 元素的命令行为，该元素在调用 (（例如发送电子邮件、删除项目或提交表单) ）时执行操作。
/// [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 XamlUICommand : DependencyObject, ICommand[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 XamlUICommand : DependencyObject, ICommandPublic Class XamlUICommand
Inherits DependencyObject
Implements ICommand- 继承
- 派生
- 属性
- 实现
示例
提示
有关详细信息、设计指南和代码示例，请参阅 命令基础知识。
WinUI 3 库应用包括大多数 WinUI 3 控件、特性和功能的交互式示例。 通过 Microsoft Store 获取应用，或在 GitHub 上获取源代码。
注解
ICommand实现接口 (Microsoft.UI.Xaml.Input.ICommand for C++ 或 System.Windows.Input.ICommand for C#) ，添加各种 UI 属性、方法和事件。
XamlUICommand 派生类
XamlUICommand 是 StandardUICommand 的父类，它公开一组具有预定义属性的标准平台命令。
有关基本命令示例，请参阅 Button 控件，该控件旨在使用户单击它时发生某些操作。
可通过两种方法处理 Button 具有属性的命令 (控件 Command 支持类似的功能) ：
-
Click处理事件 - 将
Command属性绑定到ICommand描述命令逻辑的实现
XamlUICommand 允许通过控件绑定指定 UI，例如图标、标签、说明和键盘快捷方式 (访问键和键盘快捷键) ，而无需设置各个属性。
构造函数
| XamlUICommand() |
初始化 XamlUICommand 类的新实例。 |
属性
| AccessKey |
获取或设置此元素的访问键 (助记键) 。 |
| AccessKeyProperty |
标识 AccessKey 依赖属性。 |
| Command |
获取或设置交互式 UI 元素的命令行为，该元素在调用时执行操作，例如发送电子邮件、删除项目或提交表单。 |
| CommandProperty |
标识 Command 依赖属性。 |
| Description |
获取或设置此元素的说明。 |
| DescriptionProperty |
标识 Description 依赖属性。 |
| Dispatcher |
始终在Windows 应用 SDK应用中返回 |
| DispatcherQueue |
获取 |
| 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) |
注册一个通知函数，用于侦听此 DependencyObject 实例上特定 DependencyProperty 的更改。 (继承自 DependencyObject) |
| SetValue(DependencyProperty, Object) |
设置 DependencyObject 上依赖属性的本地值。 (继承自 DependencyObject) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
取消以前通过调用 RegisterPropertyChangedCallback 注册的更改通知。 (继承自 DependencyObject) |
事件
| CanExecuteChanged |
每当发生影响命令是否可以执行的情况时发生。 |
| CanExecuteRequested |
在进行 CanExecute 调用时发生。 |
| ExecuteRequested |
执行 调用时 发生。 |