CMFCDropDownToolBar-Klasse

Artikel
06/10/2015

Eine Symbolleiste, die angezeigt wird, wenn der Benutzer eine Symbolleisten-Schaltfläche der obersten Ebene drückt und enthält.

class CMFCDropDownToolBar : public CMFCToolBar

Mitglieder

Öffentliche Methoden

Name	Description
CMFCDropDownToolBar::AllowShowOnPaneMenu	(Überschreibungen CPane::AllowShowOnPaneMenu.)
CMFCDropDownToolBar::LoadBitmap	(Überschreibungen CMFCToolBar::LoadBitmap.)
CMFCDropDownToolBar::LoadToolBar	(Überschreibungen CMFCToolBar::LoadToolBar.)
CMFCDropDownToolBar::OnLButtonUp
CMFCDropDownToolBar::OnMouseMove
CMFCDropDownToolBar::OnSendCommand	(Überschreibungen CMFCToolBar::OnSendCommand.)
CMFCDropDownToolBar::OnUpdateCmdUI	(Überschreibungen CMFCToolBar::OnUpdateCmdUI.)

Hinweise

Ein Objekt CMFCDropDownToolBar kombiniert das Aussehen einer Symbolleiste mit dem Verhalten eines Popupmenüs. Wenn ein Benutzer und Threads eine Dropdown-Symbolleistenschaltfläche (siehe), CMFCDropDownToolbarButton-Klasse drückt, wird eine Dropdown-Symbolleiste, und der Benutzer kann eine Schaltfläche von der Dropdown-Symbolleiste auswählen, indem er darauf bewegt werden und die Maustaste loslässt. Nachdem der Benutzer eine Schaltfläche in der Dropdown-Symbolleiste auswählt, wird diese Schaltfläche als die aktuelle Schaltfläche auf der Symbolleiste der obersten Ebene angezeigt.

Eine Dropdown-Symbolleiste kann nicht angepasst werden oder angedockt werden, und weist keinen Tearoffen Zustand.

Die folgende Abbildung zeigt ein CMFCDropDownToolBar-Objekt:

Beispiel für CMFCDropDownToolbar

Sie erstellen ein CMFCDropDownToolBar-Objekt auf die gleiche Weise, wie Sie eine gewöhnliche Symbolleiste erstellen (siehe CMFCToolBar-Klasse).

Um die Dropdown-Symbolleiste in eine Symbolleiste Elemente einfügen:

1. Reservieren Sie ein blindes Ressourcen-ID für die Schaltfläche in der übergeordneten Symbolleistenressource.

2. Erstellen Sie ein CMFCDropDownToolBarButton-Objekt, das die Dropdown-Symbolleiste enthält (weitere Informationen finden Sie unter, CMFCDropDownToolbarButton::CMFCDropDownToolbarButton).

3. Ersetzen Sie die blinde Schaltfläche durch CMFCDropDownToolBarButton-Objekt, indem Sie CMFCToolBar::ReplaceButton verwenden.

Weitere Informationen zu Symbolleisten-Schaltflächen, finden Sie unter Exemplarische Vorgehensweise: Steuerelemente in eine Symbolleiste einfügen. Ein Beispiel einer Dropdown-Symbolleiste, finden Sie das Beispielprojekt VisualStudioDemo.

Beispiel

Das folgende Beispiel zeigt, wie die Create-Methode in der Klasse CMFCDropDownToolBar verwendet. Dieser Codeausschnitt ist Teil Visual Studio-Demobeispiel.

  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
    }