Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cette section décrit les menus et explique comment les utiliser.
Dans cette section
| Nom | Description |
|---|---|
| À propos des menus | Présente les menus. |
| à l’aide de menus | Fournit des exemples de code de tâches liées aux menus. |
| de référence de menu | Contient la référence de l’API. |
Fonctions de menu
| Nom | Description |
|---|---|
| appendMenu | Ajoute un nouvel élément à la fin de la barre de menus spécifiée, du menu déroulant, du sous-menu ou du menu contextuel. 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 coche de l’élément de menu spécifié sur sélectionné ou désactivé. |
| CheckMenuRadioItem | Vérifie un élément de menu spécifié et le fait d’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 avec des éléments de menu à l’aide des fonctionsInsertMenuItem, 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 une fois 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 la bitmap de coche 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 la bitmap de coche par défaut 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 de 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 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 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 fonctionGetSubMenudoit récupérer un handle dans le menu déroulant ou sous-menu. |
| SetMenu | Affecte un nouveau menu à la fenêtre spécifiée. |
| SetMenuDefaultItem | Définit l’élément de menu par défaut du 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. Que l’élément de menu soit sélectionné ou effacé, le système affiche la 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 d’éléments dans le menu. Le menu contextuel peut apparaître n’importe où à l’écran. |
| TrackPopupMenuEx | Affiche un menu contextuel à l’emplacement spécifié et effectue le suivi de la sélection d’éléments dans le menu contextuel. Le menu contextuel peut apparaître n’importe où à l’écran. |
La fonction suivante est obsolète.
| Nom | Description |
|---|---|
| InsertMenu | Insère un nouvel élément de menu dans un menu, déplaçant d’autres éléments vers le bas du menu.
Remarque : la fonctionInsertMenua été remplacée par la fonction InsertMenuItem. Vous pouvez toujours utiliser InsertMenu, toutefois, si vous n’avez pas besoin 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 séquence de touches d’accélérateur est traduite. |
| WM_CONTEXTMENU | Informe une fenêtre que l’utilisateur a cliqué sur le bouton droit de la souris () dans la fenêtre. |
| WM_ENTERMENULOOP | Informe la procédure principale d’une application indiquant qu’une boucle modale de menu a été entrée. |
| WM_EXITMENULOOP | Informe la procédure de fenêtre principale d’une application qu’une boucle modale de menu a été supprimée. |
| WM_GETTITLEBARINFOEX | Envoyé pour demander des informations sur la 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 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 pendant 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 sur la 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. |