Classe CMFCPopupMenu

Artigo
08/25/2010

Implementa funcionalidade de menu pop-up do Windows e amplia, adicionando recursos sistema autônomo destacável menus e dicas de ferramentas.

class CMFCPopupMenu : public CMiniFrameWnd

Membros

Construtores protegidos

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

Métodos públicos

Nome	Descrição
CMFCPopupMenu::ActivatePopupMenu
CMFCPopupMenu::AlwaysShowEmptyToolsEntry	Define se um menu pop-up estiver ativado para mostrar entradas vazias para ferramentas definidas pelo usuário.
CMFCPopupMenu::AreAllCommandsShown
CMFCPopupMenu::CheckArea	Determina o local de um ponto em relação ao menu pop-up.
CMFCPopupMenu::CloseMenu
CMFCPopupMenu::criar	Cria um menu pop-up e a anexa à CMFCPopupMenu objeto.
CMFCPopupMenu::DefaultMouseClickOnClose
CMFCPopupMenu::EnableMenuLogo	Inicializa o logotipo de um menu pop-up.
CMFCPopupMenu::EnableMenuSound	Permite que o som de menu.
CMFCPopupMenu::EnableResize
CMFCPopupMenu::EnableScrolling
CMFCPopupMenu::EnableVertResize
CMFCPopupMenu::FindSubItemByCommand
CMFCPopupMenu::GetActiveMenu	Retorna o menu ativo no momento.
CMFCPopupMenu::GetAnimationSpeed	Retorna a velocidade da animação de menus pop-up.
CMFCPopupMenu::GetAnimationType	Retorna o tipo corrente de animação de menu pop-up.
CMFCPopupMenu::GetDropDirection
CMFCPopupMenu::GetForceMenuFocus	Indica se o foco é retornado para o barra de menus quando for exibido um menu pop-up.
CMFCPopupMenu::GetForceShadow
CMFCPopupMenu::GetHMenu	Retorna um identificador para o recurso de menu anexado.
CMFCPopupMenu::GetMenuBar	Retorna o CMFCPopupMenuBar incorporada no menu pop-up.
CMFCPopupMenu::GetMenuItem	Retorna um ponteiro para o item de menu no índice especificado.
CMFCPopupMenu::GetMenuItemCount	Retorna o número de itens em um menu pop-up.
CMFCPopupMenu::GetMessageWnd	Retorna um ponteiro para a janela em que a estrutura encaminha as mensagens do menu pop-up.
CMFCPopupMenu::GetParentArea
CMFCPopupMenu::GetParentButton	Retorna um ponteiro para botão de barra de ferramentas pai.
CMFCPopupMenu::GetParentPopupMenu	Retorna um ponteiro para o menu pop-up pai.
CMFCPopupMenu::GetParentRibbonElement
CMFCPopupMenu::GetParentToolBar	Retorna um ponteiro para a barra de ferramentas do pai.
CMFCPopupMenu::GetQuickCustomizeType
CMFCPopupMenu::GetSelItem	Retorna um ponteiro para o comando de menu selecionado no momento.
CMFCPopupMenu::HasBeenResized
CMFCPopupMenu::HideRarelyUsedCommands	Indica se o menu pop-up pode ocultar os comandos usados raramente.
CMFCPopupMenu::InCommand
CMFCPopupMenu::InsertItem	Insere um novo item para o menu pop-up no local especificado.
CMFCPopupMenu::InsertSeparator	Insere um separador no menu pop-up no local especificado.
CMFCPopupMenu::IsAlwaysClose
CMFCPopupMenu::IsAlwaysShowEmptyToolsEntry
CMFCPopupMenu::IsCustomizePane	Indica se o menu pop-up está funcionando sistema autônomo um QuickCustomizePane.
CMFCPopupMenu::IsEscClose
CMFCPopupMenu::IsIdle	Indica se um menu pop-up está ocioso no momento.
CMFCPopupMenu::IsMenuSound
CMFCPopupMenu::IsQuickCustomize	Determina se o associadoClasse CMFCToolBarMenuButton está no modo QuickCustomize.
CMFCPopupMenu::IsResizeble
CMFCPopupMenu::IsRightAlign	Indica se o menu é alinhado à direita ou alinhado à esquerda.
CMFCPopupMenu::IsScrollable
CMFCPopupMenu::IsSendMenuSelectMsg	Indica se a estrutura notifica o quadro pai quando o usuário seleciona um comando no menu pop-up.
CMFCPopupMenu::IsShown	Indica se o menu pop-up é visível no momento.
CMFCPopupMenu::MoveTo
CMFCPopupMenu::OnCmdMsg	(Substitui CFrameWnd::OnCmdMsg.)
CMFCPopupMenu::PostCommand
CMFCPopupMenu::PreTranslateMessage	(Substitui CFrameWnd::PreTranslateMessage.)
CMFCPopupMenu::RecalcLayout	Chamado pela estrutura quando as barras de controle padrão são alternadas ou desativar ou quando a janela do quadro é redimensionada.(Substitui CFrameWnd::RecalcLayout.)
CMFCPopupMenu::RemoveAllItems	Limpa todos os itens do menu pop-up.
CMFCPopupMenu::RemoveItem	Remove o item especificado em um menu pop-up.
CMFCPopupMenu::SaveState
CMFCPopupMenu::SetAnimationSpeed	Define a velocidade da animação de menus pop-up.
CMFCPopupMenu::SetAnimationType	Define o tipo de animação de menu pop-up.
CMFCPopupMenu::SetAutoDestroy
CMFCPopupMenu::SetDefaultItem	Define o comando padrão do menu pop-up.
CMFCPopupMenu::SetForceMenuFocus	Força o foco de entrada para retornar para o barra de menus quando for exibido um menu pop-up.
CMFCPopupMenu::SetForceShadow	Força a estrutura para desenhar as sombras de menu ao menus pop-up aparecem fora do quadro principal.
CMFCPopupMenu::SetMaxWidth	conjunto a largura máxima do menu pop-up.
CMFCPopupMenu::SetMessageWnd
CMFCPopupMenu::SetParentRibbonElement
CMFCPopupMenu::SetQuickCustomizeType
CMFCPopupMenu::SetQuickMode
CMFCPopupMenu::SetRightAlign	Define o alinhamento de menu para menus pop-up.
CMFCPopupMenu::SetSendMenuSelectMsg	Define um sinalizar que controla se o menu pop-up notifica seu quadro pai quando o usuário seleciona um comando.
CMFCPopupMenu::ShowAllCommands	Força o menu pop-up para exibir todos os comandos.
CMFCPopupMenu::TriggerResize
CMFCPopupMenu::UpdateAllShadows	Atualiza as sombras de todos os menus pop-up abertas.
CMFCPopupMenu::UpdateShadow	Atualiza a sombra do menu pop-up.

Métodos protegidos

Nome	Descrição
CMFCPopupMenu::CreateTearOffBar
CMFCPopupMenu::OnChangeHot
CMFCPopupMenu::OnChooseItem

Comentários

Normalmente, a estrutura do Visual C++ 2008 Feature Pack cria automaticamente menus pop-up. Se você desejar criar um CMFCPopupMenu objeto manualmente, alocar um na pilha e, em seguida telefonar CMFCPopupMenu::criar.

Exemplo

O exemplo a seguir demonstra como configurar um objeto de menu pop-up.O exemplo mostra como conjunto o logotipo e o som do menu pop-up, defina a velocidade da animação e o tipo, desenhar sombras menu quando o menu pop-up aparecer fora do quadro principal, conjunto a largura máxima e conjunto o alinhamento de menu à direita do menu pop-up.Neste trecho de código faz parte o Exemplo do CustomPages: Aplicativo do MFC barra de ferramentas personalização Dialog.

     // 30 is the size of the logo in pixels.
        pPopupMenu->EnableMenuLogo(30);
        pPopupMenu->EnableMenuSound();
        // 500 is the animation speed in milliseconds.
        pPopupMenu->SetAnimationSpeed(500);
        pPopupMenu->SetAnimationType(CMFCPopupMenu::SLIDE);
        pPopupMenu->SetForceShadow(true);
        // 200 is the maximum width of the pop-up menu in pixels.
        pPopupMenu->SetMaxWidth(200);
        pPopupMenu->SetRightAlign();
        pPopupMenu->InsertSeparator();