Classe CMFCDropDownToolBar

Articolo
06/10/2015

Una barra degli strumenti visualizzato quando l'utente preme e utilizza un pulsante della barra degli strumenti di primo livello.

class CMFCDropDownToolBar : public CMFCToolBar

Membri

Metodi pubblici

Nome	Descrizione
CMFCDropDownToolBar::AllowShowOnPaneMenu	(Override CPane::AllowShowOnPaneMenu).
CMFCDropDownToolBar::LoadBitmap	(Override CMFCToolBar::LoadBitmap).
CMFCDropDownToolBar::LoadToolBar	(Override CMFCToolBar::LoadToolBar).
CMFCDropDownToolBar::OnLButtonUp
CMFCDropDownToolBar::OnMouseMove
CMFCDropDownToolBar::OnSendCommand	(Override CMFCToolBar::OnSendCommand).
CMFCDropDownToolBar::OnUpdateCmdUI	(Override CMFCToolBar::OnUpdateCmdUI).

Note

Un oggetto CMFCDropDownToolBar combina l'aspetto di una barra degli strumenti con il comportamento di un menu di scelta rapida. Quando un utente preme e contiene un pulsante della barra degli strumenti a discesa (vedere Classe CMFCDropDownToolbarButton), una barra degli strumenti a discesa viene visualizzata e l'utente può selezionare un pulsante della barra degli strumenti a discesa scorrere su e rilasciando il pulsante del mouse. Dopo la selezione di un pulsante nella barra degli strumenti a discesa, il pulsante viene visualizzato come il pulsante corrente nella barra degli strumenti di primo livello.

Una barra degli strumenti a discesa non può essere personalizzata o ancorata e non presenta uno stato di sradicamento.

Nella figura seguente viene illustrato un oggetto CMFCDropDownToolBar :

Esempio di CMFCDropDownToolbar

Creare un oggetto CMFCDropDownToolBar la stessa modalità con cui si crea una barra degli strumenti comuni (vedere Classe CMFCToolBar).

Per inserire la barra degli strumenti a discesa nella barra degli strumenti padre:

1. Riservare un ID di risorsa fittizio al pulsante nella risorsa padre della barra degli strumenti.

2. Creare un oggetto CMFCDropDownToolBarButton contenente la barra degli strumenti a discesa (per ulteriori informazioni, vedere CMFCDropDownToolbarButton::CMFCDropDownToolbarButton).

3. Sostituire il pulsante fittizio con l'oggetto CMFCDropDownToolBarButton utilizzando CMFCToolBar::ReplaceButton.

Per ulteriori informazioni sui pulsanti della barra degli strumenti, vedere Procedura dettagliata: inserimento di controlli nelle barre degli strumenti. Per un esempio di una barra degli strumenti a discesa, vedere il progetto di esempio VisualStudioDemo.

Esempio

Il seguente esempio viene illustrato come utilizzare il metodo Create nella classe CMFCDropDownToolBar. Questo frammento di codice fa parte Esempio demo di 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
    }