XamlUICommand Klasse
Definition
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.
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, ICommandPublic Class XamlUICommand
Inherits DependencyObject
Implements ICommand- Vererbung
- Abgeleitet
- Attribute
- Implementiert
Beispiele
Tip
Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter "Grundlegendes zu Befehlen".
Die WinUI 3 Gallery-App enthält interaktive Beispiele für die meisten WinUI 3-Steuerelemente, -Features und -Funktionen. Holen Sie sich die App aus dem Microsoft Store oder holen Sie sich den Quellcode auf GitHub.
Hinweise
Implementiert die ICommand Schnittstelle (Microsoft. BENUTZEROBERFLÄCHE. Xaml.Input.ICommand für C++ oder System.Windows. Input.ICommand für C#), Hinzufügen verschiedener UI-Eigenschaften, Methoden und Ereignisse.
Abgeleitete XamlUICommand-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 Schaltflächen-Steuerelement , das darauf ausgelegt ist, etwas zu bewirken, wenn ein Benutzer darauf klickt.
Es gibt zwei Möglichkeiten zum Verarbeiten eines Button Befehls (Steuerelemente mit einer Command Eigenschaft unterstützen ähnliche Funktionen):
- Behandeln des Ereignisses
Click - Binden der
CommandEigenschaft an eineICommandImplementierung, die die Befehlslogik beschreibt
XamlUICommand Sie können 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
| Name | Beschreibung |
|---|---|
| XamlUICommand() |
Initialisiert eine neue Instanz der XamlUICommand-Klasse . |
Eigenschaften
| Name | Beschreibung |
|---|---|
| AccessKey |
Dient zum Abrufen oder Festlegen der Zugriffstaste (Mnemonic) für dieses Element. |
| AccessKeyProperty |
Identifies the AccessKey dependency property. |
| 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 |
Identifies the Command dependency property. |
| Description |
Dient zum Abrufen oder Festlegen einer Beschreibung für dieses Element. |
| DescriptionProperty |
Identifies the Description dependency property. |
| Dispatcher |
Gibt immer in einer Windows App SDK-App zurück |
| DispatcherQueue |
Ruft ab |
| IconSource |
Dient zum Abrufen oder Festlegen einer Glyphe aus der Schriftart Segoe MDL2 Assets für dieses Element. |
| IconSourceProperty |
Identifies the IconSource dependency property. |
| KeyboardAccelerators |
Ruft die Auflistung der Tastenkombinationen für dieses Element ab, die eine Aktion mithilfe der Tastatur aufrufen. |
| KeyboardAcceleratorsProperty |
Identifies the KeyboardAccelerators dependency property. |
| Label |
Ruft die Bezeichnung für dieses Element ab oder legt sie fest. |
| LabelProperty |
Identifies the Label dependency property. |
Methoden
| Name | Beschreibung |
|---|---|
| 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 Basiswert zurück, der für eine Abhängigkeitseigenschaft eingerichtet wurde, was in Fällen angewendet wird, 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 wird. (Geerbt von DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registriert eine Benachrichtigungsfunktion, um Änderungen an einer bestimmten DependencyProperty für diese DependencyObject-Instanz zu überwachen. (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 durch Aufrufen von RegisterPropertyChangedCallback registriert wurde. (Geerbt von DependencyObject) |
Ereignisse
| Name | Beschreibung |
|---|---|
| CanExecuteChanged |
Tritt auf, wenn etwas geschieht, das sich darauf auswirkt, ob der Befehl ausgeführt werden kann. |
| CanExecuteRequested |
Tritt auf, wenn ein CanExecute-Aufruf ausgeführt wird. |
| ExecuteRequested |
Tritt auf, wenn ein Execute-Aufruf ausgeführt wird. |