XamlUICommand Klasse

Referenz

Definition

Namespace:: Microsoft.UI.Xaml.Input

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt eine Basisklasse zum Definieren des Befehlsverhaltens eines interaktiven UI-Elements bereit, das beim Aufrufen eine Aktion ausführt (z. B. senden einer E-Mail, Löschen eines Elements oder Senden eines Formulars).

/// [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

Vererbung: Object IInspectable DependencyObject XamlUICommand

Abgeleitet: Microsoft.UI.Xaml.Input.StandardUICommand

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert: ICommand

Beispiele

Tipp

Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter Grundlagen zum Befehlen.

Öffnen Sie die WinUI 3-Katalog-App, und sehen Sie sich xamlUICommand in Aktion an.

Die WinUI 3-Katalog-App umfasst interaktive Beispiele für die meisten WinUI 3-Steuerelemente, -Features und -Funktionen. Rufen Sie die App aus dem Microsoft Store oder den Quellcode auf GitHub ab.

Hinweise

Implementiert die ICommand Schnittstelle (Microsoft.UI.Xaml.Input.ICommand für C++ oder System.Windows.Input.ICommand für C#) und fügt verschiedene Ui-Eigenschaften, Methoden und Ereignisse hinzu.

XamlUICommand-abgeleitete Klassen

XamlUICommand ist die übergeordnete Klasse für StandardUICommand, die eine Reihe von Standardplattformbefehlen mit vordefinierten Eigenschaften verfügbar macht.

Ein einfaches Befehlsbeispiel finden Sie im Button-Steuerelement , das dazu dient, etwas zu bewirken, wenn ein Benutzer darauf klickt.

Es gibt zwei Möglichkeiten, einen Button Befehl zu verarbeiten (Steuerelemente mit einer Command Eigenschaft unterstützen ähnliche Funktionen):

Behandeln des Ereignisses Click
Binden der Command Eigenschaft an eine ICommand Implementierung, die die Befehlslogik beschreibt

XamlUICommand können Sie die Benutzeroberfläche über die Steuerelementbindung angeben, z. B. ein Symbol, eine Bezeichnung, eine Beschreibung und Tastenkombinationen (sowohl eine Zugriffstaste als auch eine Tastenkombination), ohne die einzelnen Eigenschaften festzulegen.

Konstruktoren

XamlUICommand()

Initialisiert eine neue instance der XamlUICommand-Klasse.

Eigenschaften

AccessKey	Ruft den Zugriffsschlüssel (mnemonic) für dieses Element ab oder legt diesen fest.
AccessKeyProperty	Gibt die AccessKey-Abhängigkeitseigenschaft an.
Command	Ruft das Befehlsverhalten eines interaktiven UI-Elements ab, das beim Aufrufen eine Aktion ausführt, z. B. das Senden einer E-Mail, das Löschen eines Elements oder das Senden eines Formulars.
CommandProperty	Gibt die Command-Abhängigkeitseigenschaft an.
Description	Ruft eine Beschreibung für dieses Element ab oder legt diese fest.
DescriptionProperty	Gibt die Description-Abhängigkeitseigenschaft an.
Dispatcher	Gibt immer in einer Windows App SDK-App zurück`null`. Verwenden Sie stattdessen DispatcherQueue . (Geerbt von DependencyObject)
DispatcherQueue	Ruft den `DispatcherQueue` ab, dem dieses Objekt zugeordnet ist. Stellt `DispatcherQueue` eine Funktion dar, die auf den `DependencyObject` im UI-Thread zugreifen kann, auch wenn der Code von einem Nicht-UI-Thread initiiert wird. (Geerbt von DependencyObject)
IconSource	Ruft eine Glyphe aus der Schriftart Segoe MDL2 Assets für dieses Element ab oder legt diese fest.
IconSourceProperty	Gibt die IconSource-Abhängigkeitseigenschaft an.
KeyboardAccelerators	Ruft die Sammlung von Tastenkombinationen für dieses Element ab, die eine Aktion über die Tastatur aufrufen.
KeyboardAcceleratorsProperty	Gibt die Abhängigkeitseigenschaft KeyboardAccelerators an.
Label	Ruft die Bezeichnung für dieses Element ab oder legt diese fest.
LabelProperty	Identifiziert die Label-Abhängigkeitseigenschaft .

Methoden

CanExecute(Object)	Ruft ab, ob der Befehl im aktuellen Zustand ausgeführt werden kann.
ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject)
Execute(Object)	Ruft den Befehl auf.
GetAnimationBaseValue(DependencyProperty)	Gibt einen beliebigen Basiswert zurück, der für eine Abhängigkeitseigenschaft festgelegt wurde, was in Fällen gilt, in denen eine Animation nicht aktiv ist. (Geerbt von DependencyObject)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject zurück. (Geerbt von DependencyObject)
NotifyCanExecuteChanged()	Benachrichtigt das System, dass sich der Befehlsstatus geändert hat.
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt ist. (Geerbt von DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registriert eine Benachrichtigungsfunktion zum Lauschen auf Änderungen an einer bestimmten DependencyProperty für dieses DependencyObject-instance. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft für ein DependencyObject fest. (Geerbt von DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Bricht eine Änderungsbenachrichtigung ab, die zuvor registriert wurde, indem RegisterPropertyChangedCallback aufgerufen wurde. (Geerbt von DependencyObject)

Ereignisse

CanExecuteChanged	Tritt immer dann auf, wenn etwas passiert, das sich darauf auswirkt, ob der Befehl ausgeführt werden kann.
CanExecuteRequested	Tritt auf, wenn ein CanExecute-Aufruf erfolgt.
ExecuteRequested	Tritt auf, wenn ein Execute-Aufruf ausgeführt wird.

Gilt für:

Freigeben über