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(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
Object IInspectable DependencyObject XamlUICommand
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é.

S’applique à

Voir aussi