Classe CContextMenuManager

Artigo
06/10/2015

O objeto de CContextMenuManager gerencia o menu de atalho, também conhecido como menus de contexto.

class CContextMenuManager : public CObject

Membros

Construtores public

Nome	Descrição
CContextMenuManager::CContextMenuManager	Constrói um objeto de CContextMenuManager .
CContextMenuManager::~CContextMenuManager	Destruidor.

Métodos públicos

Nome	Descrição
CContextMenuManager::AddMenu	Adiciona um novo menu de atalho.
CContextMenuManager::GetMenuById	Retorna um identificador para o menu associado com a identificação fornecida de recurso
CContextMenuManager::GetMenuByName	Retorna um identificador para o menu que corresponde ao nome de menu fornecido.
CContextMenuManager::GetMenuNames	Retorna uma lista de nomes de menu.
CContextMenuManager::LoadState	Carrega os menus de atalho armazenados no Registro do Windows.
CContextMenuManager::ResetState	Limpa o menu de atalho do gerenciador de menu de contexto.
CContextMenuManager::SaveState	Salva menu de atalho do Registro do Windows.
CContextMenuManager::SetDontCloseActiveMenu	Controles se CContextMenuManager fecha o menu de atalho ativa quando mostrar um novo menu de atalho.
CContextMenuManager::ShowPopupMenu	Exibe o menu de atalho especificado.
CContextMenuManager::TrackPopupMenu	Exibe o menu de atalho especificado. Retorna o índice de comando de menu selecionado.

Comentários

CContextMenuManager gerencia menu de atalho e certifique-se que têm uma aparência consistente.

Você não deve criar um objeto de CContextMenuManager manualmente. A estrutura do seu aplicativo cria o objeto de CContextMenuManager . Em o entanto, você deve chamar CWinAppEx::InitContextMenuManager quando seu aplicativo é inicializado. Após inicializado o gerenciador de contexto, use o método CWinAppEx::GetContextMenuManager para obter um ponteiro ao gerenciador de contexto para seu aplicativo.

Você pode criar menus de atalho em tempo de execução chamando AddMenu. Se você quiser mostrar o menu sem primeira entrada do usuário de recepção, chame ShowPopupMenu. TrackPopupMenu é usado quando você desejar criar um menu e uma espera para entrada do usuário. TrackPopupMenu retorna o índice de comando ou de 0 selecionado se o usuário foi encerrado sem selecionar qualquer coisa.

CContextMenuManager também pode salvar e carregar o estado para o Registro do Windows.

Exemplo

O exemplo a seguir demonstra como adicionar um menu para um objeto de CContextMenuManager , e não como fechar o menu pop-up ativa quando o objeto de CContextMenuManager exibe um novo menu pop-up. Este trecho de código é parte de Custom de páginas.

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