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

Beispiele

Tipp

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

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ücknull. 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:

Weitere Informationen