IUICommandHandler ::Execute, méthode (uiribbon.h)

Répond aux événements d’exécution sur les commandes liées au gestionnaire de commandes.

Syntaxe

HRESULT Execute(
  [in]           UINT32               commandId,
  [in]           UI_EXECUTIONVERB     verb,
  [in, optional] const PROPERTYKEY    *key,
  [in, optional] const PROPVARIANT    *currentValue,
  [in, optional] IUISimplePropertySet *commandExecutionProperties
);

Paramètres

[in] commandId

Type : UINT32

ID de la commande, qui est spécifié dans le fichier de ressources Markup.

[in] verb

Type : UI_EXECUTIONVERB

UI_EXECUTIONVERB ou action lancée par l’utilisateur.

[in, optional] key

Type : const PROPERTYKEY*

Pointeur vers une clé de propriété dont la valeur a changé. Ce paramètre peut être NULL.

[in, optional] currentValue

Type : const PROPVARIANT*

Pointeur vers la valeur actuelle de la clé. Ce paramètre peut être NULL.

[in, optional] commandExecutionProperties

Type : IUISimplePropertySet*

Pointeur vers un objet IUISimplePropertySet qui contient des propriétés d’état command et des valeurs de propriété, telles que les coordonnées d’écran et les index d’éléments de liste. Ce paramètre peut être NULL.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Chaque commande d’une vue doit être liée à un gestionnaire de commandes nouveau ou existant dans l’application hôte.

Configuration requise

Voir aussi

IUICommandHandler

Exemples d’infrastructure du ruban Windows