Classe CMFCDropDownToolBar

Artigo
08/25/2010

Uma barra de ferramentas que aparece quando o usuário pressiona e mantém um botão de barra de ferramentas de nível superior.

class CMFCDropDownToolBar : public CMFCToolBar

Membros

Métodos públicos

Nome	Descrição
CMFCDropDownToolBar::AllowShowOnPaneMenu	(Substitui CPane::AllowShowOnPaneMenu.)
CMFCDropDownToolBar::LoadBitmap	(Substitui CMFCToolBar::LoadBitmap.)
CMFCDropDownToolBar::LoadToolBar	(Substitui CMFCToolBar::LoadToolBar.)
CMFCDropDownToolBar::OnLButtonUp
CMFCDropDownToolBar::OnMouseMove
CMFCDropDownToolBar::OnSendCommand	(Substitui CMFCToolBar::OnSendCommand.)
CMFCDropDownToolBar::OnUpdateCmdUI	(Substitui CMFCToolBar::OnUpdateCmdUI.)

Comentários

A CMFCDropDownToolBar objeto combina a aparência visual de uma barra de ferramentas com o comportamento de um menu pop-up. Quando um usuário pressiona e mantém uma barra de ferramentas da lista suspensa botão (consulte Classe CMFCDropDownToolbarButton), uma barra de ferramentas lista suspensa aparece e o usuário pode selecionar um botão de barra de ferramentas suspensa rolando a ele e soltar o botão do mouse. Após o usuário seleciona um botão na barra de ferramentas da lista suspensa, esse botão é exibido sistema autônomo o botão da barra de nível superior corrente.

Uma barra de ferramentas da lista suspensa não pode ser personalizada ou encaixada e não tem um estado destacável.

A ilustração a seguir mostra um CMFCDropDownToolBar objeto:

Criar um CMFCDropDownToolBar objeto da mesma forma que cria uma barra de ferramentas (consulte comum Classe CMFCToolBar).

Para inserir a barra de ferramentas lista suspensa em uma barra de ferramentas pai:

1.Reserve uma recurso fictício sua ID do recurso de barra de ferramentas do pai.

2.Criar um CMFCDropDownToolBarButton objeto que contém a barra de ferramentas drop-down (para obter mais informações, consulte CMFCDropDownToolbarButton::CMFCDropDownToolbarButton).

3.Substituir o botão fictício com o CMFCDropDownToolBarButton objeto usando CMFCToolBar::ReplaceButton.

Para obter mais informações sobre botões da barra de ferramentas, consulte Como: Colocar controles em barras de ferramentas. Para obter um exemplo de uma barra de ferramentas da lista suspensa, consulte o projeto de amostra VisualStudioDemo.

Exemplo

O exemplo a seguir demonstra como usar o Create método na CMFCDropDownToolBar classe. Neste trecho de código faz parte o Exemplo do VisualStudioDemo: Aplicativo do MFC 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
    }