CMenu::AppendMenu

BOOL AppendMenu ( UINT nFlags, UINT nIDNewItem = 0, LPCTSTR lpszNewItem = NULL );

BOOL AppendMenu ( UINT nFlags, UINT nIDNewItem, const CBitmap * pBmp );

Valeur de retour

Différent de zéro si la fonction est réussie ; sinon 0.

Paramètres

nFlags

Spécifie des informations sur l'état de l'élément de menu nouveau lorsqu'elle est ajoutée au menu. Il se compose d'un ou plusieurs des valeurs répertoriées dans la section Remarques.

nIDNewItem

Spécifie soit l'ID de commande de l'élément de menu nouveau ou, si nIndicateurs est défini sur MF_POPUP, la poignée de menu (HMENU) d'un menu déroulant. Le paramètre nIDNewItem est ignoré (pas nécessaire) si nIndicateurs est défini sur MF_SEPARATOR.

lpszNewItem

Spécifie le contenu de l'élément de menu nouveau. Le paramètre nIndicateurs est utilisé pour interpréter les lpszNewItem de la façon suivante:

nFlags	Interprétation de lpszNewItem
MF_OWNERDRAW	Contient une valeur de 32 bits fournie à la demande que l'application peut utiliser pour maintenir les données supplémentaires associées à l'élément de menu. Cette valeur de 32 bits est disponible à la demande lorsqu'il traite les messages WM_MEASUREITEM et WM_DRAWITEM . La valeur est stockée dans le membre de itemData de la structure fournie avec ces messages.
MF_STRING	Contient un pointeur vers une chaîne terminée par null. C'est l'interprétation par défaut.
MF_SEPARATOR	Le paramètre lpszNewItem est ignoré (ne pas nécessaire).

pBmp

Pointe vers un objet CBitmap qui sera utilisé comme l'élément de menu.

Remarques

Ajoute un nouvel élément à la fin d'un menu. L'application peut spécifier l'état de l'élément de menu en définissant les valeurs de nFlags. Lorsque nIDNewItem spécifie un menu déroulant, il devient partie du menu auquel il est annexé. Si ce menu est détruit, le menu figurant en annexe est également détruit. Un menu ajouté devrait être détaché d'un objet CMenu pour éviter tout conflit. Notez que MF_STRING et MF_OWNERDRAW ne sont pas valides pour la version de l'image bitmap de AppendMenu.

La liste suivante décrit les indicateurs qui peuvent être définies en nFlags:

MF_CHECKEDnbsp ; Agit comme une bascule avec MF_U&NCHECKED pour placer la coche par défaut à côté de l'élément. Lorsque l'application fournit des bitmaps coche (voir la fonction de membre de SetMenuItemBitmaps ), l'image bitmap "coche sur" s'affiche.
MF_U&NCHECKEDnbsp ; Agit comme une bascule avec MF_CHECKED à enlever une coche en regard de l'élément. Lorsque l'application fournit des bitmaps coche (voir la fonction de membre de SetMenuItemBitmaps ), la bitmap « coche off » est affichée.
MF_DISABLED ; Désactive l'élément de menu afin qu'il ne peut pas être sélectionné, mais ne pas dim il.
MF_E&NABLEDnbsp ; Permet à l'élément de menu pour qu'il peut être sélectionné et il restaure à partir de son état est estompé.
MF_GRAYED ; Désactive l'élément de menu pour qu'il ne peut pas être sélectionné et il efface.
MF_ME&NUBARBREAKnbsp ; Place l'élément sur une nouvelle ligne dans les menus statiques ou dans une nouvelle colonne dans les menus déroulants. La nouvelle colonne de menu contextuel est séparée par une ligne verticale de la Division de l'ancienne colonne.
MF_ME&NUBREAKnbsp ; Place l'élément sur une nouvelle ligne dans les menus statiques ou dans une nouvelle colonne dans les menus déroulants. Aucune ligne de démarcation n'est placé entre les colonnes.
MF_OW&NERDRAWnbsp ; Spécifie que l'élément est un élément d'owner-draw. Lorsque le menu s'affiche pour la première fois, la fenêtre qui possède le menu reçoit un message WM_MEASUREITEM , qui récupère la hauteur et la largeur de l'élément de menu. Le message WM_DRAWITEM est envoyé chaque fois que le propriétaire doit mettre à jour l'apparence de l'élément de menu. Cette option n'est pas valide pour un élément de menu de niveau supérieur.
MF_POPUP ; Spécifie que l'élément de menu est un menu déroulant qui lui est associé. Le paramètre ID spécifie le handle d'un menu contextuel qui doit être associé à l'élément. Ceci est utilisé pour l'ajout d'un menu contextuel de niveau supérieur ou un menu contextuel hiérarchique à un élément de menu contextuel.
MF_SEPARATORnbsp ; Dessine une ligne de démarcation horizontale. &Ne peut être utilisée dans un menu déroulant. Cette ligne ne peut pas être grisée, désactivée ou mis en évidence. Autres paramètres sont ignorés.
MF_STRI&NGnbsp ; Spécifie que l'élément de menu est une chaîne de caractères.

Chacun des groupes suivants répertorie les drapeaux qui est mutuellement exclusives et ne peuvent pas être utilisés ensemble:

MF_DISABLED, MF_ENABLEDet MF_GRAYED
MF_STRING, MF_OWNERDRAW, MF_SEPARATORet la version de l'image bitmap
MF_MENUBARBREAK et MF_MENUBREAK
MF_CHECKED et MF_UNCHECKED

Chaque fois qu'un menu qui se trouve dans une fenêtre est modifié (si la fenêtre est affichée), l'application doit appeler CWnd::DrawMenuBar.

Aperçu des CMenu |nbsp ; Membres de la classe | Graphique de la hiérarchie

Voir aussinbsp ;CWnd::DrawMenuBar, CMenu::InsertMenu, CMenu::RemoveMenu, CMenu::SetMenuItemBitmaps, CMenu::Detach, :: AppendMenu

Index