Compartir a través de


CContextMenuManager::ShowPopupMenu

Muestra el menú contextual especificado.

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

Parámetros

  • [in] uiMenuResId
    El Id. de recurso de menú que este método mostrará.

  • [in] x
    El desplazamiento horizontal para el menú contextual de cliente coordina.

  • [in] y
    El desplazamiento vertical para el menú contextual de cliente coordina

  • [in] pWndOwner
    Un puntero a la ventana primaria del menú contextual.

  • [in] bOwnMessage
    Un parámetro boolean que indica cómo se enrutan los mensajes. Si bOwnMessage es FALSE, se utiliza el enrutamiento estándar de MFC. si no, pWndOwner recibe los mensajes.

  • [in] hmenuPopup
    El identificador de menú que este método mostrará.

  • [in] bAutoDestroy
    Un parámetro boolean que indica si el menú automáticamente se destruirá.

  • [in] bRightAlign
    Un parámetro boolean que indica cómo los elementos de menú se alinean. Si bRightAlign es TRUE, el menú se alinean a la derecha para orden de lectura de derecha a izquierda.

Valor devuelto

La primera sobrecarga de método devuelve cero si el método muestra el menú correctamente; si no 0. La segunda sobrecarga del método devuelve un puntero a CMFCPopupMenu si el menú contextual muestra correctamente; si no NULL.

Comentarios

Este método es similar al método CContextMenuManager::TrackPopupMenu en que ambos métodos muestran un menú contextual. Sin embargo, TrackPopupMenu devuelve el índice del comando de menú seleccionado.

Si el parámetro bAutoDestroy es FALSE, debe llamar manualmente el método heredado de DestroyMenu para liberar recursos de memoria. la implementación predeterminada de ShowPopupMenu no utiliza el parámetro bAutoDestroy. Se proporciona para uso futuro o de clases personalizadas derivadas de CContextMenuManager Class.

Requisitos

encabezado: afxcontextmenumanager.h

Vea también

Referencia

CContextMenuManager Class

Gráfico de jerarquías

CContextMenuManager::TrackPopupMenu