XamlUICommand Classe

Définition

Fournit une classe de base pour définir le comportement de commande d’un élément d’interface utilisateur interactif qui effectue une action lorsqu’il est appelé (par exemple, l’envoi d’un e-mail, la suppression d’un élément ou l’envoi d’un formulaire).

/// [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
Héritage
Object IInspectable DependencyObject XamlUICommand
Dérivé
Attributs
Implémente

Exemples

Conseil

Pour plus d’informations, des conseils de conception et des exemples de code, consultez Notions de base relatives aux commandes.

L’application WinUI 3 Gallery comprend des exemples interactifs de la plupart des contrôles et des fonctionnalités WinUI 3. Procurez-vous l’application sur le Microsoft Store ou le code source sur GitHub.

Remarques

Implémente l’interface ICommand (Microsoft.UI.Xaml.Input.ICommand pour C++ ou System.Windows.Input.ICommand pour C#), en ajoutant diverses propriétés, méthodes et événements d’interface utilisateur.

Classes dérivées xamlUICommand

XamlUICommand est la classe parente pour StandardUICommand, qui expose un ensemble de commandes de plateforme standard avec des propriétés prédéfinies.

Pour obtenir un exemple de commande de base, consultez le contrôle Button , qui est conçu pour que quelque chose se produise lorsqu’un utilisateur clique dessus.

Il existe deux façons de traiter une Button commande (les contrôles avec une Command propriété prennent en charge des fonctionnalités similaires) :

  • Gérer l’événement Click
  • Lier la Command propriété à une ICommand implémentation qui décrit la logique de commande

XamlUICommand vous permet de spécifier l’interface utilisateur via la liaison de contrôle, par exemple une icône, une étiquette, une description et des raccourcis clavier (à la fois une touche d’accès et un accélérateur de clavier), sans définir les propriétés individuelles.

Constructeurs

XamlUICommand()

Initialise une nouvelle instance de la classe XamlUICommand.

Propriétés

AccessKey

Obtient ou définit la clé d’accès (mnémonique) de cet élément.

AccessKeyProperty

Identifie la propriété de dépendance AccessKey .

Command

Obtient ou définit le comportement de commande d’un élément d’interface utilisateur interactif qui effectue une action lorsqu’il est appelé, comme l’envoi d’un e-mail, la suppression d’un élément ou l’envoi d’un formulaire.

CommandProperty

Identifie la propriété de dépendance Command .

Description

Obtient ou définit une description pour cet élément.

DescriptionProperty

Identifie la propriété de dépendance Description .

Dispatcher

Retourne null toujours dans une application SDK d'application Windows. Utilisez DispatcherQueue à la place.

(Hérité de DependencyObject)
DispatcherQueue

Obtient le DispatcherQueue auquel cet objet est associé. DispatcherQueue représente une installation qui peut accéder au DependencyObject sur le thread d’interface utilisateur, même si le code est initié par un thread autre que l’interface utilisateur.

(Hérité de DependencyObject)
IconSource

Obtient ou définit un glyphe à partir de la police Segoe MDL2 Assets pour cet élément.

IconSourceProperty

Identifie la propriété de dépendance IconSource .

KeyboardAccelerators

Obtient la collection de combinaisons de touches pour cet élément qui appellent une action à l’aide du clavier.

KeyboardAcceleratorsProperty

Identifie la propriété de dépendance KeyboardAccelerators .

Label

Obtient ou définit l’étiquette de cet élément.

LabelProperty

Identifie la propriété de dépendance Label .

Méthodes

CanExecute(Object)

Récupère si la commande peut s’exécuter dans son état actuel.

ClearValue(DependencyProperty)

Efface la valeur locale d’une propriété de dépendance.

(Hérité de DependencyObject)
Execute(Object)

Appelle la commande.

GetAnimationBaseValue(DependencyProperty)

Retourne toute valeur de base établie pour une propriété de dépendance, qui s’applique dans les cas où une animation n’est pas active.

(Hérité de DependencyObject)
GetValue(DependencyProperty)

Retourne la valeur effective actuelle d’une propriété de dépendance à partir d’un objet DependencyObject.

(Hérité de DependencyObject)
NotifyCanExecuteChanged()

Avertit le système que l’état de la commande a changé.

ReadLocalValue(DependencyProperty)

Retourne la valeur locale d’une propriété de dépendance, si une valeur locale est définie.

(Hérité de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Inscrit une fonction de notification pour écouter les modifications apportées à un DependencyProperty spécifique sur ce instance DependencyObject.

(Hérité de DependencyObject)
SetValue(DependencyProperty, Object)

Définit la valeur locale d’une propriété de dépendance sur un DependencyObject.

(Hérité de DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Annule une notification de modification précédemment inscrite en appelant RegisterPropertyChangedCallback.

(Hérité de DependencyObject)

Événements

CanExecuteChanged

Se produit chaque fois que quelque chose se produit qui affecte si la commande peut s’exécuter.

CanExecuteRequested

Se produit lorsqu’un appel CanExecute est effectué.

ExecuteRequested

Se produit lorsqu’un appel d’exécution est effectué.

S’applique à

Voir aussi