Menus (menus et autres ressources)

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

Dans cette section

Nom Description
À propos des menus Discute des menus.
Utilisation des menus Fournit des exemples de code de tâches liées aux menus.
Référence du menu Contient la référence de l’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 coché de l’élément de menu spécifié comme étant activé ou désactivé.
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 dans le groupe associé et efface l’indicateur de type d’élément de radio pour ces éléments.
CreateMenu Crée un menu. Le menu est initialement vide, mais il peut être rempli avec les éléments de menu à l’aide des fonctions InsertMenuItem, AppendMenuet 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 la création de la fenêtre par le système, 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 Met fin au menu actif du thread appelant.
GetMenu Récupère un handle du menu assigné à 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 la bitmap de coche par défaut. Le système affiche ce bitmap en regard des éléments de menu sélectionnés. Avant d’appeler la fonction SetMenuItemBitmaps pour remplacer la bitmap de coche par défaut d’un élément de menu, une application doit déterminer la taille correcte de la bitmap 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 vers 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 fenêtre (également appelé menu système ou menu contrôle) pour copier et modifier.
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 vers le menu ou sous-menu déroulant.
SetMenu Assigne 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 des informations pour un menu spécifié.
SetMenuItemBitmaps Associe la bitmap spécifiée à un élément de menu. Si l’élément de menu est activé ou désactivé, 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 menu.
[!Note]
La fonction InsertMenu a été remplacée par la fonction InsertMenuItem . Toutefois, vous pouvez toujours utiliser InsertMenu, si vous n’avez pas besoin des fonctionnalités étendues de InsertMenuItem.


Nom Description
WM, _ commande 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 touche d’accès rapide est traduite.
WM _ CONTEXTMENU Indique à une fenêtre que l’utilisateur a cliqué avec le bouton droit de la souris (cliquez avec le bouton droit) dans la fenêtre.
_ENTERMENULOOP WM Informe la procédure de fenêtre principale d’une application qu’une boucle modale de menu a été entrée.
_EXITMENULOOP WM Informe la procédure de fenêtre principale d’une application qu’une boucle modale de menu a été quittée.
_GETTITLEBARINFOEX WM Envoyé pour demander des informations étendues de barre de titre. Une fenêtre reçoit ce message par le biais de sa fonction WindowProc .
la _ MENUCOMMAND WM Envoyé lorsque l’utilisateur effectue une sélection à partir d’un menu.
_MENUDRAG WM Envoyé au propriétaire d’un menu glisser-déplacer lorsque l’utilisateur fait glisser un élément de menu.
_MENUGETOBJECT WM 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.
_MENURBUTTONUP WM Envoyé lorsque l’utilisateur relâche le bouton droit de la souris alors que le curseur se trouve sur un élément de menu.
_NEXTMENU WM Envoyé à une application lorsque la touche de direction droite ou gauche est utilisée pour basculer entre la barre de menus et le menu système.
_UNINITMENUPOPUP WM Envoyé lorsqu’un menu ou sous-menu déroulant a été détruit.
Nom Description
MDINEXTMENU Contient des informations sur le menu à activer.
MENUBARINFO Contient des informations sur la barre de menus.
_ _ en-tête de modèle menuex Définit l’en-tête d’un modèle de menu étendu. Cette définition de structure est destinée uniquement à des fins d’explication. Il n’est présent dans aucun fichier d’en-tête standard.
_élément de modèle menuex _ Définit un élément de menu dans un modèle de menu étendu. Cette définition de structure est destinée uniquement à des fins d’explication. 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 .