XamlUICommand 類別

  • 參考

定義

命名空間:
Windows.UI.Xaml.Input
編輯

提供基類，用來定義互動式 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
繼承
Object IInspectable DependencyObject XamlUICommand
衍生
屬性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute
實作
ICommand ICommand

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 for C++ 或 System.Windows.Input.ICommand for C#) 、新增各種 UI 屬性、方法和事件。

XamlUICommand 衍生類別

XamlUICommand 是 StandardUICommand的父類別，其會公開一組具有預先定義屬性的標準平臺命令。

如需基本命令範例，請參閱 Button 控制項，其設計目的是在使用者按一下按鈕時發生問題。

有兩種方式可以處理具有 Command 屬性的 Button 命令 (控制項支援類似的功能) ：

  • 處理 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

發生于 執行呼叫時 。

適用於

另請參閱