Classe CMenu

Artigo
06/10/2015

Uma encapsulamento do windows HMENU.

class CMenu : public CObject

Membros

Construtores public

Nome	Descrição
CMenu::CMenu	Constrói um objeto de CMenu .

Métodos públicos

Nome	Descrição
CMenu::AppendMenu	Acrescenta um novo item ao final do menu.
CMenu::Attach	Anexa um tratador do menu do windows a um objeto de CMenu .
CMenu::CheckMenuItem	Coloca uma marca de seleção ao lado de ou remover uma marca de seleção de um item de menu no menu pop-up.
CMenu::CheckMenuRadioItem	Coloque um botão de opção ao lado de um item de menu e remove o botão de opção de quaisquer outros itens de menu no grupo.
CMenu::CreateMenu	Criar um menu em branco e anexá-la a um objeto de CMenu .
CMenu::CreatePopupMenu	Criar um menu pop-up em branco e anexá-la a um objeto de CMenu .
CMenu::DeleteMenu	Excluir um item de menu especificado. Se o item de menu possui um menu pop-up associado for, a alça o menu pop-up e libera memória usada por ele.
CMenu::DeleteTempMap	Exclui todos os objetos temporários de CMenu criados pela função de membro de FromHandle .
CMenu::DestroyMenu	O menu for anexado a um objeto de qualquer CMenu e libera a memória que ocupa o menu.
CMenu::Detach	Dispara um identificador do menu do windows de um objeto de CMenu e retorna o identificador.
CMenu::DrawItem	Chamado pela estrutura quando uma aparência visual de um menu proprietário desenhado alterar.
CMenu::EnableMenuItem	Habilita, desativa ou escurece (cinza) um item de menu.
CMenu::FromHandle	Retorna um ponteiro para um objeto de CMenu dado um identificador do menu do windows.
CMenu::GetDefaultItem	Determina o item de menu padrão no menu especificado.
CMenu::GetMenuContextHelpId	Recupera a identificação de contexto da ajuda associado com o menu.
CMenu::GetMenuInfo	Recupera informações em um menu específico.
CMenu::GetMenuItemCount	Determina o número de itens em um menu pop-up ou de nível superior.
CMenu::GetMenuItemID	Obtém o identificador do item de menu para um item de menu na posição especificada.
CMenu::GetMenuItemInfo	Recupera informações sobre um item de menu.
CMenu::GetMenuState	Retorna o status do item de menu especificado ou o número de itens em um menu pop-up.
CMenu::GetMenuString	Recupera o rótulo do item de menu especificado.
CMenu::GetSafeHmenu	Retorna m_hMenu empacotado por esse objeto de CMenu .
CMenu::GetSubMenu	Recupera um ponteiro para um menu pop-up.
CMenu::InsertMenu	Insere um novo item de menu na posição especificada, movendo outros itens abaixo do menu.
CMenu::InsertMenuItem	Insere um novo item de menu na posição especificada em um menu.
CMenu::LoadMenu	Carrega um recurso do menu do arquivo executável e anexá-la a um objeto de CMenu .
CMenu::LoadMenuIndirect	Carrega um menu de um modelo de menu na memória e anexá-la a um objeto de CMenu .
CMenu::MeasureItem	Chamado pela estrutura para determinar dimensões de menu quando um menu proprietário desenhado é criado.
CMenu::ModifyMenu	Modifique um item de menu existente na posição especificada.
CMenu::RemoveMenu	Excluir um item de menu com um menu pop-up associado de menu especificado.
CMenu::SetDefaultItem	Define o item de menu padrão para o menu especificado.
CMenu::SetMenuContextHelpId	Define a identificação de contexto de ajuda a ser associado com o menu.
CMenu::SetMenuInfo	Define informações em um menu específico.
CMenu::SetMenuItemBitmaps	Associa bitmaps especificados de sinal com um item de menu.
CMenu::SetMenuItemInfo	Alterar informações sobre um item de menu.
CMenu::TrackPopupMenu	Exibe um menu pop-up flutuante no local especificado e controla a seleção de itens de menu pop-up.
CMenu::TrackPopupMenuEx	Exibe um menu pop-up flutuante no local especificado e controla a seleção de itens de menu pop-up.

Operadores públicos

Nome	Descrição
CMenu::operator HMENU	Recupera a alça de objeto do menu.
CMenu::operator! =	Determina se dois objetos de menu não são iguais.
CMenu::operator = =	Determina se dois objetos de menu são iguais.

Membros públicos de dados

Nome	Descrição
CMenu::m_hMenu	Especifica o identificador para o menu do windows anexado ao objeto de CMenu .

Comentários

Fornece funções de membro para criar, acompanhar, atualizar, e destruir um menu.

Crie um objeto de CMenu no quadro de pilha como um local, então chama as funções de membro de CMenu quando necessário para manipular o novo menu. Em seguida, chame CWnd::SetMenu para definir o menu para uma janela, tiver usado imediatamente por uma chamada para a função de membro de Desanexar do objeto de CMenu . A função de membro de CWnd::SetMenu define o menu da janela para o novo menu, faz com que a janela para ser redesenhado para refletir a alteração no menu, e também passa a propriedade de menu para a janela. A chamada a Desanexar dispara HMENU do objeto de CMenu , de modo que quando a variável local de CMenu passa para fora do escopo, o destrutor do objeto de CMenu não tente destruir um menu que não possui. O próprio menu é destruído automaticamente quando a janela é destruída.

Você pode usar a função de membro de LoadMenuIndirect para criar um menu de um modelo na memória, mas um menu criado de um recurso por uma chamada a LoadMenu é mantido mais facilmente, e o próprio recurso de menu pode ser criado e modificado pelo editor do menu.