Classe CMFCDropDownToolBar

Uma barra de ferramentas que aparece quando o utilizador pressiona e mantém pressionado um botão superior da barra de ferramentas.

Para mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da sua instalação no Visual Studio.

Sintaxe

class CMFCDropDownToolBar : public CMFCToolBar

Membros

Métodos Públicos

Observações

Um CMFCDropDownToolBar objeto combina a aparência visual de uma barra de ferramentas com o comportamento de um menu pop-up. Quando um utilizador pressiona e mantém pressionado um botão de barra de ferramentas suspensa (ver CMFCDropDownToolbarButton Class), aparece uma barra de ferramentas suspensa, e o utilizador pode selecionar um botão da barra de ferramentas suspensa, deslocando-se até ele e soltando o botão do rato. Depois de o utilizador selecionar um botão na barra de ferramentas suspensa, esse botão é apresentado como o botão atual na barra de ferramentas de nível superior.

Uma barra de ferramentas suspensa não pode ser personalizada nem acoplada, e não tem um estado de remoção.

A ilustração seguinte mostra um CMFCDropDownToolBar objeto:

Cria-se um CMFCDropDownToolBar objeto da mesma forma que cria uma barra de ferramentas comum (ver CMFCToolBar Class).

Para inserir a barra de ferramentas suspensa numa barra de ferramentas de pais:

1. Reserve um ID de recurso fictício para o botão no recurso da barra de ferramentas dos pais.

2. Crie um CMFCDropDownToolBarButton objeto que contenha a barra de ferramentas suspensa (para mais informações, veja CMFCDropDownToolbarButton::CMFCDropDownToolbarButton).

3. Substitui o botão fictício pelo CMFCDropDownToolBarButton objeto usando o CMFCToolBar::ReplaceButton.

Para mais informações sobre botões da barra de ferramentas, consulte Guia: Colocar Controlos nas Barras de Ferramentas. Para um exemplo de uma barra de ferramentas suspensa, veja o projeto de exemplo VisualStudioDemo.

Example

O exemplo seguinte demonstra como usar o Create método na CMFCDropDownToolBar aula. Este excerto de código faz parte do exemplo de demonstração do Visual Studio.

CMFCDropDownToolBar m_wndToolbarResource;

// Create Resource toolbar:
// The this pointer points to CMainFrame class which extends the CMDIFrameWndEx class
if (!m_wndToolbarResource.Create(this, WS_CHILD | CBRS_TOP | CBRS_TOOLTIPS | CBRS_FLYBY | CBRS_HIDE_INPLACE | CBRS_SIZE_DYNAMIC | CBRS_GRIPPER | CBRS_BORDER_3D, IDR_TOOLBAR_RESOURCE) || !m_wndToolbarResource.LoadToolBar(IDR_TOOLBAR_RESOURCE))
{
   TRACE0("Failed to create build toolbar\n");
   return FALSE;      // fail to create
}

Hierarquia de herança

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

CMFCDropDownToolBar

Requerimentos

Cabeçalho: afxdropdowntoolbar.h

CMFCDropDownToolBar::AllowShowOnPaneMenu

virtual BOOL AllowShowOnPaneMenu() const;

Valor de retorno

Observações

CMFCDropDownToolBar::LoadBitmap

Carrega imagens da barra de ferramentas a partir dos recursos da aplicação.

virtual BOOL LoadBitmap(
    UINT uiResID,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    BOOL bLocked=FALSE,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0);

Parâmetros

uiResID
[dentro] O ID do recurso do bitmap que se refere às imagens da barra de ferramentas quente.

uiColdResID
[dentro] O ID do recurso do bitmap que se refere às imagens frias da barra de ferramentas.

uiMenuResID
[dentro] O ID do recurso do bitmap que se refere às imagens normais do menu.

bLocked
[dentro] TRUE para bloquear a barra de ferramentas; caso contrário, FALSO.

uiDisabledResID
[dentro] O ID do recurso do bitmap que se refere às imagens da barra de ferramentas desativadas.

uiMenuDisabledResID
[dentro] O ID do recurso do bitmap que se refere às imagens do menu desativadas.

Valor de retorno

Não nulo se o método tiver sucesso; caso contrário, 0.

Observações

O método CMFCToolBar::LoadToolBarEx chama este método para carregar as imagens associadas à barra de ferramentas. Substitua este método para realizar um carregamento personalizado dos recursos da imagem.

Chama o LoadBitmapEx método para carregar imagens adicionais depois de criares a barra de ferramentas.

CMFCDropDownToolBar::LoadToolBar

virtual BOOL LoadToolBar(
    UINT uiResID,
    UINT uiColdResID = 0,
    UINT uiMenuResID = 0,
    BOOL = FALSE,
    UINT uiDisabledResID = 0,
    UINT uiMenuDisabledResID = 0,
    UINT uiHotResID = 0);

Parâmetros

[dentro] uiResID

[dentro] uiColdResID

[dentro] uiMenuResID

[dentro] BOOL

[dentro] uiDisabledResID

[dentro] uiMenuDisabledResID

[dentro] uiHotResID

Valor de retorno

Observações

CMFCDropDownToolBar::OnLButtonUp

afx_msg void OnLButtonUp(
    UINT nFlags,
    CPoint point);

Parâmetros

[dentro] nFlags

[dentro] ponto

Observações

CMFCDropDownToolBar::OnMouseMove

afx_msg void OnMouseMove(
    UINT nFlags,
    CPoint point);

Parâmetros

[dentro] nFlags

[dentro] ponto

Observações

CMFCDropDownToolBar::OnSendCommand

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

Parâmetros

[dentro] pButton

Valor de retorno

Observações

CMFCDropDownToolBar::OnUpdateCmdUI

virtual void OnUpdateCmdUI(
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler);

Parâmetros

[dentro] pTarget

[dentro] bDisableSeNoHndler

Observações

Consulte também

Gráfico de Hierarquia
Classes
Classe CMFCToolBar
CMFCToolBar::Create
CMFCToolBar::ReplaceButton
CMFCDropDownToolbarButton Class
Guia: Colocar Controlos nas Barras de Ferramentas