Поделиться через


CContextMenuManager::ShowPopupMenu

Отображает указанное контекстное меню.

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
);

Параметры

  • [входящий] uiMenuResId
    Идентификатор ресурса меню, этот метод будет отображаться.

  • [входящий] x
    Горизонтальное смещение для контекстного меню в клиентских координатах.

  • [входящий] y
    Вертикальное смещение для контекстного меню в клиентских координатах

  • [входящий] pWndOwner
    Указатель к родительскому окну контекстного меню.

  • [входящий] bOwnMessage
    Логический параметр, который указывает, каким образом сообщения передаются. Если bOwnMessageFALSE, то стандартная маршрутизация MFC используется. В противном случае - значение pWndOwner получает сообщения.

  • [входящий] hmenuPopup
    Дескриптор меню, этот метод будет отображаться.

  • [входящий] bAutoDestroy
    Логический параметр, указывающий, будет ли автоматически уничтожении меню.

  • [входящий] bRightAlign
    Логический параметр, указывающий, например пунктов меню выравнены. Если bRightAlignTRUE, то меню выравнивается по правому краю, порядок чтения справа налево.

Возвращаемое значение

Первая перегрузка метода возвращает ненулевое значение, если метод отображает меню успешно; в противном случае – значение 0. Вторая перегрузка метода возвращает указатель на CMFCPopupMenu если отображение контекстного меню правильно; в противном случае NULL.

Заметки

Этот метод похож на метод CContextMenuManager::TrackPopupMenu тем, что оба метода отображается контекстное меню. Однако TrackPopupMenu возвращает индекс выбранной команды меню.

Если параметр bAutoDestroyFALSE, необходимо вручную вызвать унаследованный метод DestroyMenu для освобождения ресурсов памяти. Реализация по умолчанию ShowPopupMenu не использует параметр bAutoDestroy. Предоставляется для дальнейшего использования или для пользовательских классов, производных от Класс CContextMenuManager.

Требования

заголовок: afxcontextmenumanager.h

См. также

Ссылки

Класс CContextMenuManager

Диаграмма иерархии

CContextMenuManager::TrackPopupMenu