CMenu, classe

Article
06/10/2015

Une encapsulation des fenêtres HMENU.

class CMenu : public CObject

Membres

Constructeurs publics

Nom	Description
CMenu::CMenu	Construit un objet CMenu.

Méthodes publiques

Nom	Description
CMenu::AppendMenu	Ajoute un élément à la fin de le menu.
CMenu::Attach	Joint un handle de menu à un objet d' CMenu .
CMenu::CheckMenuItem	Définit une coche en regard de ou supprime une coche d'un élément de menu dans le menu contextuel.
CMenu::CheckMenuRadioItem	Définit une case d'option en regard de l'élément de menu et supprime la case d'option de tous les autres éléments de menu au groupe.
CMenu::CreateMenu	Crée un menu vide et l'attache à un objet d' CMenu .
CMenu::CreatePopupMenu	Crée un menu contextuel vide et l'attache à un objet d' CMenu .
CMenu::DeleteMenu	Supprime un élément spécifié dans le menu. Si l'élément de menu a un menu contextuel associé, perd le handle au menu contextuel et libère la mémoire utilisée par elle.
CMenu::DeleteTempMap	Supprime tous les objets temporaires d' CMenu créés par la fonction membre d' FromHandle .
CMenu::DestroyMenu	Perd le menu joint à un objet d' CMenu et libère toute mémoire que le menu est occupée.
CMenu::Detach	Détache un handle de menu d'un objet d' CMenu et retourne le handle.
CMenu::DrawItem	Appelé par l'infrastructure lorsqu'un aspect visuel d'un menu owner-drawn change.
CMenu::EnableMenuItem	Active, les désactive, ou estompe des (gris) un élément de menu.
CMenu::FromHandle	Retourne un pointeur vers un objet d' CMenu donné un handle de menu de windows.
CMenu::GetDefaultItem	Détermine l'élément de menu par défaut dans le menu spécifié.
CMenu::GetMenuContextHelpId	Extrait l'ID de contexte d'aide associé au menu.
CMenu::GetMenuInfo	Récupère des informations sur un menu spécifique.
CMenu::GetMenuItemCount	Détermine le nombre d'éléments dans un menu contextuel ou un menu de niveau supérieur.
CMenu::GetMenuItemID	Obtient l'identificateur d'élément de menu pour un élément de menu situé à la position spécifiée.
CMenu::GetMenuItemInfo	Récupère des informations sur un élément de menu.
CMenu::GetMenuState	Retourne l'état de l'élément de menu spécifié ou le nombre d'éléments dans un menu contextuel.
CMenu::GetMenuString	Récupère l'étiquette de l'élément de menu spécifié.
CMenu::GetSafeHmenu	Retourne m_hMenu encapsulé par cet objet d' CMenu .
CMenu::GetSubMenu	Extrait un pointeur vers un menu contextuel.
CMenu::InsertMenu	Insère un nouvel élément de menu à la position spécifiée, le déplacement d'autres éléments vers le bas du menu.
CMenu::InsertMenuItem	Insère un nouvel élément de menu à la position spécifiée dans un menu.
CMenu::LoadMenu	Charge une ressource menu du fichier exécutable et la attaché à un objet d' CMenu .
CMenu::LoadMenuIndirect	Charge un menu d'un modèle de menu en mémoire et l'attache à un objet d' CMenu .
CMenu::MeasureItem	Appelé par l'infrastructure pour déterminer les dimensions de menu lorsqu'un menu owner-drawn est créé.
CMenu::ModifyMenu	Modifie un élément de menu existant à la position spécifiée.
CMenu::RemoveMenu	Supprime un élément de menu à un menu contextuel associé du menu spécifié.
CMenu::SetDefaultItem	Définit l'élément de menu par défaut du menu spécifié.
CMenu::SetMenuContextHelpId	Définit l'ID de contexte d'aide à associer au menu.
CMenu::SetMenuInfo	Définit des informations sur un menu spécifique.
CMenu::SetMenuItemBitmaps	Associe les bitmaps spécifiées de la coche à un élément de menu.
CMenu::SetMenuItemInfo	Modification des informations sur un élément de menu.
CMenu::TrackPopupMenu	Affiche un menu contextuel flottant à l'emplacement spécifié et suivre la sélection des éléments dans le menu contextuel.
CMenu::TrackPopupMenuEx	Affiche un menu contextuel flottant à l'emplacement spécifié et suivre la sélection des éléments dans le menu contextuel.

Opérateurs publics

Nom	Description
CMenu::operator HMENU	Récupère le handle de l'objet de menu.
CMenu::operator ! =	Détermine si deux objets de menu ne sont pas égales.
== De CMenu::operator	Détermine si deux objets de menu sont égaux.

Données membres publiques

Nom	Description
CMenu::m_hMenu	Spécifie le handle au menu joint à l'objet d' CMenu .

Notes

Il fournit les fonctions membres pour créer, le traçage, mettre à jour, et détruire un menu.

Créez un objet d' CMenu sur le frame de pile en tant que des variables locales, puis fonctions membres d'CMenu d'appel pour manipuler le nouveau menu selon les besoins. Ensuite, appelez CWnd::SetMenu pour définir le menu à une fenêtre, suivi immédiatement par un appel à la fonction membre de détachez de l'objet d' CMenu . La fonction membre d' CWnd::SetMenu définit le menu de fenêtre vers le nouveau menu, entraîne la fenêtre d'être redessinée pour refléter la modification de menu, et passe également la propriété du menu dans la fenêtre. L'appel à Détacher détache HMENU de l'objet d' CMenu , de sorte que lorsque la variable locale d' CMenu passe hors de portée, le destructeur d'objet d' CMenu ne tente pas de détruire un menu qu'il ne possède plus. Le menu lui-même est automatiquement détruit lorsque la fenêtre est détruite.

Vous pouvez utiliser la fonction membre de LoadMenuIndirect pour créer un menu à partir d'un modèle en mémoire, mais un menu création d'une ressource par un appel à LoadMenu plus facilement est mis à jour, et la ressource menu lui-même peut être créée et modifiées par l'éditeur de menus.