Freigeben über


XamlUICommand Klasse

Definition

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
Attribute
Implementiert

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:

Weitere Informationen