Partilhar via


Classe CMFCPopupMenuBar

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Uma barra de menus embutida num menu pop-up.

Sintaxe

class CMFCPopupMenuBar : public CMFCToolBar

Membros

Métodos Públicos

Nome Description
CMFCPopupMenuBar::AjustarTamanhoImediato Recalcula imediatamente a disposição de um painel. (Sobrepõe o CPane::AjustarTamanhoImediato.)
CMFCPopupMenuBar::BuildOrigItems Carrega itens pop-up do menu a partir de um recurso de menu especificado.
CMFCPopupMenuBar::FecharSubMenu Atrasado Fecha um botão de menu pop-up atrasado.
CMFCPopupMenuBar::ExportarParaMenu Constrói um menu a partir dos botões do menu pop-up.
CMFCPopupMenuBar::FindDestinationToolBar Localiza a barra de ferramentas onde se encontra um ponto especificado.
CMFCPopupMenuBar::GetCurrentMenuImageSize Indica o tamanho das imagens dos botões do menu.
CMFCPopupMenuBar::GetDefaultMenuId Devolve o identificador do item predefinido do menu.
CMFCPopupMenuBar::GetLastCommandIndex Obtém o índice do comando de menu invocado mais recentemente.
CMFCPopupMenuBar::GetOffset Fica com o deslocamento da linha na barra de menu pop-up.
CMFCPopupMenuBar::ImportFromMenu Importa botões pop-up de um menu especificado.
CMFCPopupMenuBar::IsDropDownListMode Indica se a barra de menu pop-up está em modo de lista suspensa.
CMFCPopupMenuBar::IsPaletteMode Indica se a barra de menu pop-up está em modo paleta.
CMFCPopupMenuBar::IsRibbonPanel Indica se isto é um painel de fita (FALSE por defeito).
CMFCPopupMenuBar::IsRibbonPanelInRegularMode Indica se este é um painel de fita em modo normal (FALSE por defeito).
CMFCPopupMenuBar::LoadFromHash Carrega um menu arquivado.
CMFCPopupMenuBar::RestoreDelayedSubmenu Restaura um botão de menu atrasado para fechar a barra pop-up.
CMFCPopupMenuBar::SetButtonStyle Define o estilo do botão da barra de ferramentas no índice indicado. (Sobrepõe CMFCToolBar::SetButtonStyle.)
CMFCPopupMenuBar::SetOffset Define o deslocamento da linha na barra de menu pop-up.
CMFCPopupMenuBar::StartPopupMenuTimer Inicia o temporizador para um botão de menu popup atrasado especificado.

Membros de Dados

Nome Description
CMFCPopupMenuBar::m_bDisableSideBarInXPMode Especifica se a barra lateral cinzenta será exibida quando a aplicação tiver uma aparência de Windows XP.

Observações

É CMFCPopupMenuBar criado ao mesmo tempo que uma classe CMFCPopupMenu e incorporado nela. Cobre CMFCPopupMenuBar toda a área do cliente do CMFCPopupMenu objeto. Suporta entrada por teclado e rato. Também comunica essa entrada para a CMFCPopupMenu janela de frames de nível superior.

Example

O exemplo seguinte demonstra como inicializar um CMFCPopupMenuBar objeto a partir de um CMFCPopupMenu objeto. Este excerto de código faz parte do exemplo Draw Client.

// CMFCPopupMenu* pMenuPopup
CMFCPopupMenuBar *pMenuBar = pMenuPopup->GetMenuBar();

Hierarquia de herança

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

CMFCPopupMenuBar

Requerimentos

Cabeçalho: afxpopupmenubar.h

CMFCPopupMenuBar::AjustarTamanhoImediato

Recalcula imediatamente a disposição do painel da barra de menu pop-up. (Anula o CPane::AjustarTamanhoImediato.

virtual void AdjustSizeImmediate(BOOL bRecalcLayout);

Parâmetros

bRecalcLayout
[dentro] TRUE para recalcular automaticamente a disposição do painel da barra de menu pop-up; caso contrário, FALSO.

Observações

CMFCPopupMenuBar::BuildOrigItems

Carrega itens pop-up do menu a partir de um recurso de menu especificado.

BOOL BuildOrigItems(UINT uiMenuResID);

Parâmetros

uiMenuResID
[dentro] Especifica o ID do menu do recurso do menu a carregar.

Valor de retorno

Retorna VERDADEIRO se for bem-sucedido ou FALSO se não.

Observações

CMFCPopupMenuBar::FecharSubMenu Atrasado

Fecha um botão de menu pop-up que estava atrasado.

virtual void CloseDelayedSubMenu();

Observações

CMFCPopupMenuBar::ExportarParaMenu

Constrói um menu a partir dos botões pop-up.

virtual HMENU ExportToMenu() const;

Valor de retorno

Devolve uma alça ao novo menu.

Observações

CMFCPopupMenuBar::FindDestinationToolBar

Localiza a barra de ferramentas onde se encontra um ponto especificado.

CMFCToolBar* FindDestintationToolBar(CPoint point);

Parâmetros

ponto
[dentro] Um ponto no ecrã.

Valor de retorno

Devolve um handle à barra de ferramentas onde o ponto está disponível, se houver, ou NULL se não existir.

Observações

CMFCPopupMenuBar::GetCurrentMenuImageSize

Indica o tamanho das imagens dos botões do menu.

virtual CSize GetCurrentMenuImageSize() const;

Valor de retorno

Devolve o tamanho das imagens dos botões de menu na barra de ferramentas.

Observações

CMFCPopupMenuBar::GetDefaultMenuId

Devolve o identificador do item predefinido do menu.

UINT GetDefaultMenuId() const;

Valor de retorno

Devolve o identificador do elemento do menu predefinido na barra pop-up.

Observações

CMFCPopupMenuBar::GetLastCommandIndex

Obtém o índice do comando de menu invocado mais recentemente.

static int __stdcall GetLastCommandIndex();

Valor de retorno

Devolve o índice do último comando de menu que foi invocado.

Observações

CMFCPopupMenuBar::GetOffset

Fica com o deslocamento da linha na barra de menu pop-up.

int GetOffset() const;

Valor de retorno

Devolve o deslocamento de linha da barra de menu popup.

Observações

Este valor é definido usando o CMFCPopupMenuBar::SetOffset.

CMFCPopupMenuBar::ImportFromMenu

Importa botões pop-up de um menu especificado.

virtual BOOL ImportFromMenu(
    HMENU hMenu,
    BOOL bShowAllCommands = FALSE);

Parâmetros

hMenu
[dentro] O menu de onde se importam os botões do menu pop-up.

bShowAllCommands
[dentro] TRUE se todos os comandos no menu estiverem a ser importados, ou FALSE se os raramente usados puderem estar ocultos.

Valor de retorno

Retorna TRUE se os botões do menu foram importados com sucesso do menu, ou FALSE se não.

Observações

CMFCPopupMenuBar::IsDropDownListMode

Indica se a barra de menu pop-up está em modo de lista suspensa.

BOOL IsDropDownListMode() const;

Valor de retorno

Retorna TRUE se a barra de menu pop-up estiver em modo de lista suspensa, ou FALSE se não estiver.

Observações

CMFCPopupMenuBar::IsPaletteMode

Indica se a barra de menu pop-up está em modo paleta.

BOOL IsPaletteMode() const;

Valor de retorno

Retorna TRUE se o modo de paleta estiver ativado, ou FALSE se não estiver.

Observações

Quando a barra de menu está definida para modo paleta, os itens do menu aparecem em várias colunas e num número limitado de linhas.

CMFCPopupMenuBar::IsRibbonPanel

Indica se isto é um painel de fita (FALSE por defeito).

virtual BOOL IsRibbonPanel() const;

Valor de retorno

Devolve FALSE por defeito, indicando que este não é um painel de fita.

Observações

CMFCPopupMenuBar::IsRibbonPanelInRegularMode

Indica se este é um painel de fita em modo normal (FALSE por defeito).

virtual BOOL IsRibbonPanelInRegularMode() const;

Valor de retorno

Devolve FALSE por defeito, indicando que este não é um painel de fita em modo normal.

Observações

CMFCPopupMenuBar::LoadFromHash

Carrega um menu arquivado.

BOOL LoadFromHash(HMENU hMenu);

Parâmetros

hMenu
[dentro] Um handle para o menu arquivado para carregar.

Valor de retorno

Retorna TRUE se o menu for carregado com sucesso, ou FALSE se não.

Observações

CMFCPopupMenuBar::m_bDisableSideBarInXPMode

Um parâmetro booleano que indica se a sua aplicação tem uma barra lateral cinzenta quando tem uma aparência do Windows XP.

BOOL m_bDisableSideBarInXPMode;

Observações

Se esta variável membro estiver definida como FALSE e a sua aplicação tiver uma aparência Windows XP, o framework desenha uma barra lateral cinzenta na sua aplicação.

O valor padrão é FALSE.

CMFCPopupMenuBar::RestoreDelayedSubmenu

Restaura um botão de menu atrasado para fechar a barra pop-up.

virtual void RestoreDelayedSubMenu();

Observações

CMFCPopupMenuBar::SetButtonStyle

Define o estilo do botão da barra de ferramentas no índice indicado. (Sobrepõe CMFCToolBar::SetButtonStyle.)

virtual void SetButtonStyle(
    int nIndex,
    UINT nStyle);

Parâmetros

nIndex
[dentro] O índice baseado em zero do botão da barra de ferramentas cujo estilo deve ser definido.

nStyle
[dentro] O estilo do botão. Consulte os Estilos de Controlo da Barra de Ferramentas para a lista de estilos de botões disponíveis na barra de ferramentas.

Observações

CMFCPopupMenuBar::SetOffset

Define o deslocamento da linha na barra de menu pop-up.

void SetOffset(int iOffset);

Parâmetros

iOffset
[dentro] O número de linhas em que a barra de menu popup deve estar deslocada.

Observações

CMFCPopupMenuBar::StartPopupMenuTimer

Inicia o temporizador para um botão de menu popup atrasado especificado.

void StartPopupMenuTimer(
    CMFCToolBarMenuButton* pMenuButton,
    int nDelayFactor = 1);

Parâmetros

pMenuButton
[dentro] Aponta para o botão do menu para definir o temporizador de atraso.

nDelayFactor
[dentro] Um fator de atraso, igual a pelo menos um, para multiplicar pelo tempo de atraso padrão do menu (geralmente entre meio segundo e cinco segundos).

Observações

Consulte também

Gráfico de Hierarquia
Classes
Classe CMFCColorBar
Classe CMFCPopupMenu