XamlUICommand 类

定义

命名空间:

Microsoft.UI.Xaml.Input

提供一个基类，用于定义交互式 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, ICommand

Public Class XamlUICommand
Inherits DependencyObject
Implements ICommand

继承

Object IInspectable DependencyObject XamlUICommand

派生

Microsoft.UI.Xaml.Input.StandardUICommand

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

ICommand

示例

提示

有关详细信息、设计指南和代码示例，请参阅 命令基础知识。

打开 WinUI 3 库应用，查看 XamlUICommand 的运行情况。

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应用中返回 null 。 请改用 DispatcherQueue 。 (继承自 DependencyObject)
DispatcherQueue	获取 DispatcherQueue 与此 对象关联的 。 DispatcherQueue表示可以访问 DependencyObject UI 线程上的 的功能，即使代码是由非 UI 线程启动的。 (继承自 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)	注册一个通知函数，用于侦听此 DependencyObject 实例上特定 DependencyProperty 的更改。 (继承自 DependencyObject)
SetValue(DependencyProperty, Object)	设置 DependencyObject 上依赖属性的本地值。 (继承自 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消以前通过调用 RegisterPropertyChangedCallback 注册的更改通知。 (继承自 DependencyObject)

事件

CanExecuteChanged	每当发生影响命令是否可以执行的情况时发生。
CanExecuteRequested	在进行 CanExecute 调用时发生。
ExecuteRequested	执行 调用时 发生。

另请参阅

• StandardUICommand
• 使用 StandardUICommand、XamlUICommand 和 ICommand 在 Windows 应用中进行命令控制