Partager via


CreatePopupMenu, fonction (winuser.h)

Crée un menu déroulant, un sous-menu ou un menu contextuel. Le menu est initialement vide. Vous pouvez insérer ou ajouter des éléments de menu à l’aide de la fonction InsertMenuItem . Vous pouvez également utiliser la fonction InsertMenu pour insérer des éléments de menu et la fonction AppendMenu pour ajouter des éléments de menu.

Syntaxe

HMENU CreatePopupMenu();

Valeur de retour

Type : HMENU

Si la fonction réussit, la valeur de retour est un handle pour le menu nouvellement créé.

Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

L’application peut ajouter le nouveau menu à un menu existant ou afficher un menu contextuel en appelant les fonctions TrackPopupMenuEx ou TrackPopupMenu.

Les ressources associées à un menu affecté à une fenêtre sont libérées automatiquement. Si le menu n’est pas affecté à une fenêtre, une application doit libérer les ressources système associées au menu avant de se fermer. Une application libère des ressources de menu en appelant la fonction DestroyMenu .

Exemples

Pour obtenir un exemple, consultez Ajout de lignes et de graphiques à un menu.

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winuser.h (inclure Windows.h)
Bibliothèque User32.lib
DLL User32.dll
Ensemble d’API ext-ms-win-ntuser-menu-l1-1-0 (introduit dans Windows 8)

Voir aussi

AppendMenu

Conceptuel

Createmenu

DestroyMenu

InsertMenu

InsertMenuItem

Menus

Référence

SetMenu

TrackPopupMenu

TrackPopupMenuEx