Menus (Menus et autres ressources)

Cette section décrit les menus et explique comment les utiliser.

Dans cette section

Name Description
À propos des menus Traite des menus.
Utilisation des menus Fournit des exemples de code de tâches liées aux menus.
Informations de référence sur le menu Contient la référence API.
Nom Description
AppendMenu Ajoute un nouvel élément à la fin de la barre de menus, du menu déroulant, du sous-menu ou du menu contextuel spécifiés. Vous pouvez utiliser cette fonction pour spécifier le contenu, l’apparence et le comportement de l’élément de menu.
CheckMenuItem Définit l’état de l’attribut de marque case activée de l’élément de menu spécifié sur sélectionné ou effacé.
CheckMenuRadioItem Vérifie un élément de menu spécifié et en fait un élément radio. En même temps, la fonction efface tous les autres éléments de menu du groupe associé et efface l’indicateur de type d’élément radio pour ces éléments.
Createmenu Crée un menu. Le menu est initialement vide, mais il peut être rempli d’éléments de menu à l’aide des fonctions InsertMenuItem, AppendMenu et InsertMenu .
CreatePopupMenu 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.
DeleteMenu Supprime un élément du menu spécifié. Si l’élément de menu ouvre un menu ou un sous-menu, cette fonction détruit le handle du menu ou du sous-menu et libère la mémoire utilisée par le menu ou le sous-menu.
DestroyMenu Détruit le menu spécifié et libère toute mémoire occupée par le menu.
DrawMenuBar Redessine la barre de menus de la fenêtre spécifiée. Si la barre de menus change après que le système a créé la fenêtre, cette fonction doit être appelée pour dessiner la barre de menus modifiée.
EnableMenuItem Active, désactive ou grise l’élément de menu spécifié.
EndMenu Termine le menu actif du thread appelant.
GetMenu Récupère un handle dans le menu affecté à la fenêtre spécifiée.
GetMenuBarInfo Récupère des informations sur la barre de menus spécifiée.
GetMenuCheckMarkDimensions Récupère les dimensions de l’image bitmap de marque case activée par défaut. Le système affiche cette bitmap en regard des éléments de menu sélectionnés. Avant d’appeler la fonction SetMenuItemBitmaps pour remplacer l’image bitmap par défaut case activée-mark pour un élément de menu, une application doit déterminer la taille de bitmap correcte en appelant GetMenuCheckMarkDimensions.
GetMenuDefaultItem Détermine l’élément de menu par défaut dans le menu spécifié.
GetMenuInfo Récupère des informations sur un menu spécifié.
GetMenuItemCount Récupère le nombre d’éléments dans le menu spécifié.
GetMenuItemID Récupère l’identificateur d’élément de menu d’un élément de menu situé à la position spécifiée dans un menu.
GetMenuItemInfo Récupère des informations sur un élément de menu.
GetMenuItemRect Récupère le rectangle englobant pour l’élément de menu spécifié.
GetMenuState Récupère les indicateurs de menu associés à l’élément de menu spécifié. Si l’élément de menu ouvre un sous-menu, cette fonction retourne également le nombre d’éléments dans le sous-menu.
GetMenuString Copie la chaîne de texte de l’élément de menu spécifié dans la mémoire tampon spécifiée.
GetSubMenu Récupère un handle dans le menu déroulant ou le sous-menu activé par l’élément de menu spécifié.
GetSystemMenu Permet à l’application d’accéder au menu de la fenêtre (également appelé menu système ou menu de contrôle) pour la copie et la modification.
HiliteMenuItem Met en surbrillance ou supprime la mise en surbrillance d’un élément dans une barre de menus.
InsertMenuItem Insère un nouvel élément de menu à la position spécifiée dans un menu.
IsMenu Détermine si un handle est un handle de menu.
LoadMenu Charge la ressource de menu spécifiée à partir du fichier exécutable (.exe) associé à une instance d’application.
LoadMenuIndirect Charge le modèle de menu spécifié en mémoire.
MenuItemFromPoint Détermine l’élément de menu, le cas échéant, à l’emplacement spécifié.
ModifyMenu Modifie un élément de menu existant. Cette fonction est utilisée pour spécifier le contenu, l’apparence et le comportement de l’élément de menu.
RemoveMenu Supprime un élément de menu ou détache un sous-menu du menu spécifié. Si l’élément de menu ouvre un menu déroulant ou un sous-menu, RemoveMenu ne détruit pas le menu ou sa poignée, ce qui permet de réutiliser le menu. Avant d’appeler cette fonction, la fonction GetSubMenu doit récupérer un handle dans le menu déroulant ou le sous-menu.
SetMenu Affecte un nouveau menu à la fenêtre spécifiée.
SetMenuDefaultItem Définit l’élément de menu par défaut pour le menu spécifié.
SetMenuInfo Définit les informations d’un menu spécifié.
SetMenuItemBitmaps Associe l’image bitmap spécifiée à un élément de menu. Que l’élément de menu soit sélectionné ou effacé, le système affiche l’image bitmap appropriée en regard de l’élément de menu.
SetMenuItemInfo Modifie les informations relatives à un élément de menu.
TrackPopupMenu Affiche un menu contextuel à l’emplacement spécifié et effectue le suivi de la sélection des éléments dans le menu. Le menu contextuel peut apparaître n’importe où sur l’écran.
TrackPopupMenuEx Affiche un menu contextuel à l’emplacement spécifié et effectue le suivi de la sélection des éléments dans le menu contextuel. Le menu contextuel peut apparaître n’importe où sur l’écran.

La fonction suivante est obsolète.

Nom Description
InsertMenu Insère un nouvel élément de menu dans un menu, en déplaçant d’autres éléments vers le bas du menu. Note: La fonction InsertMenu a été remplacée par la fonction InsertMenuItem . Toutefois, vous pouvez toujours utiliser InsertMenu si vous n’avez besoin d’aucune des fonctionnalités étendues de InsertMenuItem.
Nom Description
WM_COMMAND Envoyé lorsque l’utilisateur sélectionne un élément de commande dans un menu, lorsqu’un contrôle envoie un message de notification à sa fenêtre parente ou lorsqu’une frappe d’accélérateur est traduite.
WM_CONTEXTMENU Informe une fenêtre que l’utilisateur a cliqué sur le bouton droit de la souris (clic droit) dans la fenêtre.
WM_ENTERMENULOOP Informe la procédure de fenêtre main d’une application qu’une boucle modale de menu a été entrée.
WM_EXITMENULOOP Informe la procédure de fenêtre main d’une application qu’une boucle modale de menu a été supprimée.
WM_GETTITLEBARINFOEX Envoyé pour demander des informations de barre de titre étendue. Une fenêtre reçoit ce message via sa fonction WindowProc.
WM_MENUCOMMAND Envoyé lorsque l’utilisateur effectue une sélection à partir d’un menu.
WM_MENUDRAG Envoyé au propriétaire d’un menu glisser-déplacer lorsque l’utilisateur fait glisser un élément de menu.
WM_MENUGETOBJECT Envoyé au propriétaire d’un menu glisser-déplacer lorsque le curseur de la souris entre dans un élément de menu ou se déplace du centre de l’élément vers le haut ou le bas de l’élément.
WM_MENURBUTTONUP Envoyé lorsque l’utilisateur relâche le bouton droit de la souris alors que le curseur se trouve sur un élément de menu.
WM_NEXTMENU Envoyé à une application lorsque la flèche droite ou gauche est utilisée pour basculer entre la barre de menus et le menu système.
WM_UNINITMENUPOPUP Envoyé lorsqu’un menu déroulant ou un sous-menu a été détruit.
Nom Description
MDINEXTMENU Contient des informations sur le menu à activer.
MENUBARINFO Contient des informations de barre de menus.
MENUEX_TEMPLATE_HEADER Définit l’en-tête d’un modèle de menu étendu. Cette définition de structure est à des fins d’explication uniquement ; il n’est présent dans aucun fichier d’en-tête standard.
MENUEX_TEMPLATE_ITEM Définit un élément de menu dans un modèle de menu étendu. Cette définition de structure est à des fins d’explication uniquement ; il n’est présent dans aucun fichier d’en-tête standard.
MENUGETOBJECTINFO Contient des informations sur le menu sur lequel se trouve le curseur de la souris.
MENUINFO Contient des informations sur un menu.
MENUITEMINFO Contient des informations sur un élément de menu.
MENUITEMTEMPLATE Définit un élément de menu dans un modèle de menu.
MENUITEMTEMPLATEHEADER Définit l’en-tête d’un modèle de menu. Un modèle de menu complet se compose d’un en-tête et d’une ou plusieurs listes d’éléments de menu.
TPMPARAMS Contient des paramètres étendus pour la fonction TrackPopupMenuEx .