Partager via


CContextMenuManager::ShowPopupMenu

Affiche le menu contextuel spécifié.

virtual BOOL ShowPopupMenu(
   UINT uiMenuResId,
   int x,
   int y,
   CWnd* pWndOwner,
   BOOL bOwnMessage = FALSE,
   BOOL bRightAlign = FALSE
);

virtual CMFCPopupMenu* ShowPopupMenu(
   HMENU hmenuPopup,
   int x,
   int y,
   CWnd* pWndOwner,
   BOOL bOwnMessage = FALSE,
   BOOL bAutoDestroy = TRUE,
   BOOL bRightAlign = FALSE
);

Paramètres

  • [in] uiMenuResId
    L'ID de ressource de menu que cette méthode affiche.

  • [in] x
    L'offset horizontal du menu contextuel dans les coordonnées clientes.

  • [in] y
    Le décalage vertical du menu contextuel dans les coordonnées clientes

  • [in] pWndOwner
    Un pointeur vers la fenêtre parente dans le menu contextuel.

  • [in] bOwnMessage
    Un paramètre de type boolean qui indique comment les messages sont routés. Si bOwnMessage est FALSE, le routage MFC standard est utilisé. Sinon, pWndOwner reçoit des messages.

  • [in] hmenuPopup
    Le handle de menu que cette méthode affiche.

  • [in] bAutoDestroy
    Un paramètre de type boolean qui indique si le menu sera automatiquement détruit.

  • [in] bRightAlign
    Un paramètre de type boolean qui indique comment les éléments de menu sont alignés. Si bRightAlign est TRUE, le menu est aligné à droite de l'ordre de lecture de droite à gauche.

Valeur de retour

La première surcharge de méthode retourne une valeur différente de zéro si la méthode indique le menu avec succès ; sinon 0. La deuxième surcharge de méthode retourne un pointeur vers CMFCPopupMenu si les affichages de menu contextuel correctement ; sinon NULL.

Notes

Cette méthode ressemble à la méthode CContextMenuManager::TrackPopupMenu dans la mesure où les deux méthodes affichent un menu contextuel. Toutefois, TrackPopupMenu retourne l'index de la commande de menu sélectionnée.

Si le paramètre bAutoDestroy est FALSE, vous devez appeler manuellement la méthode héritée d' DestroyMenu pour libérer les ressources mémoire. L'implémentation par défaut d' ShowPopupMenu n'utilise pas le paramètre bAutoDestroy. Il est ainsi pour une utilisation ultérieure ou pour les classes personnalisées dérivées de CContextMenuManager, classe.

Configuration requise

en-tête : afxcontextmenumanager.h

Voir aussi

Référence

CContextMenuManager, classe

Graphique de la hiérarchie

CContextMenuManager::TrackPopupMenu