XamlUICommand Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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’elle est appelée (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, ICommandPublic Class XamlUICommand
Inherits DependencyObject
Implements ICommand- Héritage
- Dérivé
- Attributs
- Implémente
Exemples
Tip
Pour plus d’informations, des conseils de conception et des exemples de code, consultez Les principes de base de la commande.
L’application WinUI 3 Gallery inclut des exemples interactifs de la plupart des contrôles, des caractéristiques et des fonctionnalités de WinUI 3. Obtenez l’application à partir du Microsoft Store ou obtenez 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#), ajout de différentes propriétés, méthodes et événements d’interface utilisateur.
Classes dérivées XamlUICommand
XamlUICommand est la classe parente de 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 faire quelque chose qui se produit 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
Commandpropriété à uneICommandimplémentation qui décrit la logique de commande
XamlUICommand vous permet de spécifier l’interface utilisateur via la liaison de contrôle, telle qu’une icône, une étiquette, une description et des raccourcis clavier (à la fois une touche d’accès et un accélérateur clavier), sans définir les propriétés individuelles.
Constructeurs
| Nom | Description |
|---|---|
| XamlUICommand() |
Initialise une nouvelle instance de la classe XamlUICommand . |
Propriétés
| Nom | Description |
|---|---|
| AccessKey |
Obtient ou définit la clé d’accès (mnémonique) pour 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’elle est appelée, 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 de commande . |
| Description |
Obtient ou définit une description pour cet élément. |
| DescriptionProperty |
Identifie la propriété de dépendance Description . |
| Dispatcher |
Retourne |
| DispatcherQueue |
Obtient le |
| IconSource |
Obtient ou définit un glyphe 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 appelle 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
| Nom | Description |
|---|---|
| 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 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 à une dependencyProperty spécifique sur cette 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 qui a été précédemment inscrite en appelant RegisterPropertyChangedCallback. (Hérité de DependencyObject) |
Événements
| Nom | Description |
|---|---|
| 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é. |