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.

Fonctions de menu

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.

Menu Notifications

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.

Menu Structures

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 .