XamlUICommand 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
提供一个基类,用于定义交互式 UI 元素的命令行为,该元素在调用 ((例如发送电子邮件、删除项目或提交表单) )时执行操作。
/// [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 中引入)
|
示例
注解
(适用于 C++ 的 Windows.UI.Xaml.Input.ICommand 或适用于 C# ) 的 System.Windows.Input.ICommand 实现 ICommand 接口,添加各种 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 |
获取与此 对象关联的 CoreDispatcher 。 CoreDispatcher 表示可以访问 UI 线程上的 DependencyObject 的工具,即使代码是由非 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 |
执行 调用时 发生。 |