Classe CMFCDropDownToolBar

Artigo
06/10/2015

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

class CMFCDropDownToolBar : public CMFCToolBar

Membros

Métodos públicos

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

Comentários

Um objeto de CMFCDropDownToolBar 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 um botão da barra de ferramentas drop-down (consulte) Classe CMFCDropDownToolbarButton, uma barra de ferramentas lista suspensa aparece, e o usuário pode selecionar um botão da barra de ferramentas e enrolando a ele e liberando o botão do mouse. Depois que o usuário seleciona um botão na barra de ferramentas lista suspensa, o botão é exibido como o botão na barra de ferramentas atual de nível superior.

Uma barra de ferramentas e não pode ser personalizada ou conectado, e não tem um estado de rasgo - fora.

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

Exemplo de CMFCDropDownToolbar

Você cria um objeto de CMFCDropDownToolBar a mesma forma que cria uma barra de ferramentas Classe CMFCToolBarcomum (consulte).

Para inserir a barra de ferramentas drop-down em uma barra de ferramentas pai:

1. Reservar uma identificação de recurso fictício no botão no recurso pai da barra de ferramentas.

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

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

Para obter mais informações sobre os botões da barra de ferramentas, consulte Instruções passo a passo: colocando controles em barras de ferramentas. Para um exemplo de uma barra de ferramentas lista suspensa, consulte o projeto VisualStudioDemo de exemplo.

Exemplo

O exemplo seguinte demonstra como usar o método de Create na classe de CMFCDropDownToolBar . Este trecho de código é parte de 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
    }