CContextMenuManager Class

Artículo
06/10/2015

El objeto de CContextMenuManager administra los menús contextuales, también conocidos como menús contextuales.

class CContextMenuManager : public CObject

Members

Constructores públicos

Name	Descripción
CContextMenuManager::CContextMenuManager	Crea un objeto CContextMenuManager.
CContextMenuManager::~CContextMenuManager	Un destructor.

Métodos públicos

Name	Descripción
CContextMenuManager::AddMenu	Agrega un nuevo menú contextual.
CContextMenuManager::GetMenuById	Devuelve un identificador al menú asociado a la identificación proporcionada de recursos
CContextMenuManager::GetMenuByName	Devuelve un identificador al menú que coincide con el nombre de menú proporcionado.
CContextMenuManager::GetMenuNames	Devuelve una lista de nombres de menú.
CContextMenuManager::LoadState	Carga los menús contextuales almacenados en el Registro de Windows.
CContextMenuManager::ResetState	Borra los menús contextuales del administrador del menú contextual.
CContextMenuManager::SaveState	Guarda menús contextuales al Registro de Windows.
CContextMenuManager::SetDontCloseActiveMenu	Controla si cierra CContextMenuManager el menú contextual activa cuando muestra un nuevo menú contextual.
CContextMenuManager::ShowPopupMenu	Muestra el menú contextual especificado.
CContextMenuManager::TrackPopupMenu	Muestra el menú contextual especificado. Devuelve el índice del comando de menú seleccionado.

Comentarios

CContextMenuManager administra menús contextuales y asegúrese de que tienen un aspecto coherente.

No debe crear un objeto de CContextMenuManager manualmente. el marco de la aplicación crea el objeto de CContextMenuManager . Sin embargo, debe llamar a CWinAppEx::InitContextMenuManager cuando se inicializa la aplicación. Después de inicializar el administrador de contexto, use el método CWinAppEx::GetContextMenuManager para obtener un puntero al administrador de contexto para la aplicación.

Puede crear menús contextuales del runtime llamando a AddMenu. Si desea mostrar el menú sin el primer datos proporcionados por el usuario que recibe, llame a ShowPopupMenu. Se utilizaTrackPopupMenu cuando desee crear un menú y una espera para los datos proporcionados por el usuario. TrackPopupMenu devuelve el índice del comando seleccionado o el 0 si el usuario queda sin seleccionar nada.

CContextMenuManager puede guardar y cargar su estado en el Registro de Windows.

Ejemplo

El ejemplo siguiente muestra cómo agregar un menú a un objeto de CContextMenuManager , y cómo no cerrar un menú emergente activa cuando el objeto de CContextMenuManager muestra un nuevo menú emergente. Este fragmento de código es parte de Ejemplo de las páginas de personalizadas.

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