CContextMenuManager, classe

Article
06/10/2015

L'objet d' CContextMenuManager gère des menus contextuels, également appelé des menus contextuels.

class CContextMenuManager : public CObject

Membres

Constructeurs publics

Nom	Description
CContextMenuManager::CContextMenuManager	Construit un objet CContextMenuManager.
CContextMenuManager::~CContextMenuManager	Destructor.

Méthodes publiques

Nom	Description
CContextMenuManager::AddMenu	Ajoute un nouveau menu contextuel.
CContextMenuManager::GetMenuById	Retourne un handle vers le menu associé à l'identification fournies de ressource
CContextMenuManager::GetMenuByName	Retourne un handle au menu qui correspond au nom de menu fourni.
CContextMenuManager::GetMenuNames	Retourne une liste de noms de menu.
CContextMenuManager::LoadState	Charge des menus contextuels inscrits dans le Registre Windows.
CContextMenuManager::ResetState	Efface les menus contextuels du gestionnaire de menu contextuel.
CContextMenuManager::SaveState	Enregistre les menus contextuels au Registre Windows.
CContextMenuManager::SetDontCloseActiveMenu	Contrôle si CContextMenuManager ferme le menu contextuel actif lorsqu'il affiche un nouveau menu contextuel.
CContextMenuManager::ShowPopupMenu	Affiche le menu contextuel spécifié.
CContextMenuManager::TrackPopupMenu	Affiche le menu contextuel spécifié. Retourne l'index de la commande de menu sélectionnée.

Notes

CContextMenuManager gère des menus contextuels et vérifie qu'ils ont une apparence cohérente.

Vous ne devez pas créer un objet d' CContextMenuManager manuellement. l'infrastructure de votre application crée l'objet d' CContextMenuManager . Toutefois, vous devez appeler CWinAppEx::InitContextMenuManager lorsque votre application est initialisée. Après avoir initialisé le gestionnaire de contexte, utilisez la méthode CWinAppEx::GetContextMenuManager pour obtenir un pointeur vers le gestionnaire de contexte pour votre application.

Vous pouvez créer des menus contextuels au moment de l'exécution en appelant AddMenu. Si vous souhaitez afficher le menu sans la première entrée d'utilisateur de réception, appelez ShowPopupMenu. TrackPopupMenu est utilisé lorsque vous souhaitez créer un menu et une attente l'entrée d'utilisateur. TrackPopupMenu retourne l'index de la commande ou de 0 sélectionnée si l'utilisateur quittait sans sélectionner n'importe quoi.

CContextMenuManager peut également enregistrer et charger son état au Registre Windows.

Exemple

L'exemple suivant montre comment ajouter un menu à un objet d' CContextMenuManager , et comment ne pas fermer le menu contextuel actif lorsque l'objet d' CContextMenuManager affiche un nouveau menu contextuel. Cet extrait de code fait partie de Le personnalisé pages l'exemple.

   // The GetContextMenuManager method is inherited from the CWinAppEx class.
    GetContextMenuManager()->AddMenu (_T("My menu"), IDR_CONTEXT_MENU);
    GetContextMenuManager()->SetDontCloseActiveMenu(true);