CCommandBar::AddAdornments

Mise à jour : novembre 2007

Ajoute un bouton Fermer et, éventuellement des boutons Aide et OK à la barre de commandes.

BOOL AddAdornments(
Dword dwFlags = 0 );

Paramètres

Le tableau suivant décrit les paramètres de la méthode AddAdornments de la classe CCommandBar (voir CCommandBar, classe).

Paramètre

Description

dwFlags

Spécifie des boutons facultatifs à ajouter à la barre de commandes. La valeur est nulle si seul le bouton Fermer est nécessaire, ou une combinaison des valeurs suivantes pour créer des boutons supplémentaires :

Valeur

Description

CMDBAR_HELP

Ajoute un bouton Aide à la barre de commandes. Lorsque vous cliquez dessus, ce bouton envoie un message WM_HELP.

CMDBAR_OK

Ajoute un bouton OK à la barre de commandes. Lorsqu'il est sélectionné, ce bouton envoie un message WM_COMMAND avec IDOK comme identificateur de message.

Valeurs de retour

true en cas de réussite ; sinon, false.

Notes

Cette méthode crée un minimum de deux boutons : un séparateur qui aligne les ornements sélectionnés à droite de la barre de commandes, et les ornements sélectionnés.

Lorsqu'un utilisateur clique sur le bouton Fermer, OK ou Aide, le message associé à ce bouton est placé dans la file d'attente des messages de l'application. Chaque barre de commandes doit avoir un bouton Fermer. Le bouton OK et le bouton Aide sont facultatifs.

Appelez cette méthode une fois que tous les autres éléments, tels que les menus, boutons et zones de liste déroulante, ont été ajoutés à la barre de commandes.

Les applications existantes doivent être revues pour supprimer la dépendance sur AddAdornments.

Configuration requise

Windows CE, versions 5.0 et ultérieures.

Fichier d'en-tête : déclaré dans Afxext.h.

Voir aussi

Référence

Méthodes CCommandBar

Autres ressources

MFC unique pour les classes Devices