XamlUICommand Klasse

Referenz

Definition

Namespace:: Windows.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(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

Vererbung: Object IInspectable DependencyObject XamlUICommand

Abgeleitet: Windows.UI.Xaml.Input.StandardUICommand

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert: ICommand ICommand

Windows-Anforderungen

Gerätefamilie	Windows 10, version 1809 (eingeführt in 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v7.0)

Beispiele

Tipp

Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter Grundlagen des Befehlsentwurfs.

Wenn Sie die WinUI 2-Katalog-App installiert haben, klicken Sie hier, um die App zu öffnen und den StandardUICommand in Aktion zu sehen.

Hinweise

Implementiert die ICommand-Schnittstelle (Windows.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 Click-Ereignisses
Binden der Command-Eigenschaft an eine ICommand-Implementierung, die die Befehlslogik beschreibt

Mit XamlUICommand können Sie UI über die Steuerelementbindung angeben, z. B. ein Symbol, eine Bezeichnung, eine Beschreibung und Tastenkombinationen (sowohl Zugriffstaste als auch Tastaturkürzel), 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	Ruft den CoreDispatcher ab, dem dieses Objekt zugeordnet ist. CoreDispatcher stellt eine Funktion dar, die auf das 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, oder legt diese fest.
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