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表示即使程式代碼是由非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	發生於 執行呼叫時 。

另請參閱

• StandardUICommand
• Windows 應用程式中使用 StandardUICommand、XamlUICommand 和 ICommand 的命令