Partager via


Méthode IMenuButton ::AddButton (mmc.h)

La méthode IMenuButton ::AddButton permet à un utilisateur d’ajouter un bouton à la barre de menus MMC pour une vue particulière.

Syntaxe

HRESULT AddButton(
  [in] int      idCommand,
  [in] LPOLESTR lpButtonText,
  [in] LPOLESTR lpTooltipText
);

Paramètres

[in] idCommand

Valeur qui spécifie une valeur fournie par l’utilisateur qui identifie de manière unique le bouton à ajouter à la barre de menus.

[in] lpButtonText

Pointeur vers la valeur de texte (chaîne terminée par null) à afficher sur le bouton.

[in] lpTooltipText

Pointeur vers la valeur de texte (chaîne terminée par null) à afficher lorsque l’utilisateur place le pointeur de la souris sur le bouton.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Remarques

Les boutons ajoutés à la barre de menus MMC pour une vue particulière sont toujours ajoutés aux boutons déjà présents. L’état initial d’un bouton de menu est masqué et désactivé.

Lorsque le composant logiciel enfichable perd le focus, ces boutons sont automatiquement supprimés de la barre de menus. Par conséquent, ils doivent être ajoutés chaque fois que le composant logiciel enfichable obtient le focus.

Cette méthode peut être appelée par les composants logiciels enfichables principaux ou d’extension.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête mmc.h
DLL Mmcndmgr.dll

Voir aussi

IMenuButton