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’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(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
- Héritage
- Dérivé
- Attributs
- Implémente
Configuration requise pour Windows
Famille d’appareils |
Windows 10, version 1809 (introduit dans 10.0.17763.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduit dans v7.0)
|
Exemples
Conseil
Pour plus d’informations, des conseils de conception et des exemples de code, consultez Principes de base de la conception des commandes.
Si vous avez installé l’application Galerie WinUI 2 , cliquez ici pour ouvrir l’application et voir l’application StandardUICommand en action.
Remarques
Implémente l’interface ICommand (Windows.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 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 que quelque chose se produise lorsqu’un utilisateur clique dessus.
Il existe deux façons de traiter une commande Button (les contrôles avec une propriété Command prennent en charge des fonctionnalités similaires) :
- Gérer l’événement Click
- Lier la propriété Command à une implémentation ICommand qui décrit la logique de commande
Avec XamlUICommand, vous pouvez spécifier l’interface utilisateur par le biais de 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 rapide et un accélérateur clavier), sans avoir à définir les différentes propriétés.
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) 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’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 |
Obtient le CoreDispatcher auquel cet objet est associé. CoreDispatcher représente une fonctionnalité qui peut accéder à 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 de la police Segoe MDL2 Assets pour cet élément. |
IconSourceProperty |
Identifie la propriété de dépendance IconSource . |
KeyboardAccelerators |
Obtient ou définit 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
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’appliquerait 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 à 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é. |