CreatePopupMenu, fonction (winuser.h)

Article
08/27/2023

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)