IUIFramework ::SetUICommandProperty, méthode (uiribbon.h)

Définit une propriété, une valeur ou un état de commande.

Syntaxe

HRESULT SetUICommandProperty(
  [in] UINT32         commandId,
  [in] REFPROPERTYKEY key,
  [in] REFPROPVARIANT value
);

Paramètres

[in] commandId

Type : UINT32

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

[in] key

Type : REFPROPERTYKEY

Clé de propriété de la propriété, de la valeur ou de l’état de commande.

[in] value

Type : PROPVARIANT

Propriété, valeur ou état.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, sinon une valeur d’erreur de la liste suivante.

Valeur	Description
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	La propriété, la valeur ou l’état ne prend pas en charge IUIFramework ::SetUICommandProperty. Ils peuvent prendre en charge la définition via l’invalidation uniquement.
E_FAIL	L'opération a échoué.

Remarques

Un nombre limité de clés de propriété peut être défini à l’aide de IUIFramework ::SetUICommandProperty. Pour les propriétés où IUIFramework ::SetUICommandProperty retourne HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED), IUIFramework ::InvalidateUICommand doit être utilisé à la place.

Pour plus d’informations sur la définition d’une clé de propriété pour un contrôle spécifique, consultez la page Bibliothèque de contrôles Du ruban Windows pour ce contrôle.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	uiribbon.h
DLL	Mshtml.dll

Voir aussi

IUIFramework

Exemples d’infrastructure du ruban Windows