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
Conceptuel
Référence