CMFCDropDownToolbarButton::DropDownToolbar

Opens a drop-down toolbar.

BOOL DropDownToolbar(
   CWnd* pWnd
);

Parameters

  • [in] pWnd
    The parent window of the drop-down frame, or NULL to use the parent window of the drop-down toolbar button.

Return Value

Nonzero if the method is successful; otherwise 0.

Remarks

The CMFCDropDownToolbarButton::OnClick method calls this method to open the drop-down toolbar when the user presses and holds the toolbar button down.

This methods creates the drop-down toolbar by using the CMFCDropDownFrame::Create method. If the parent toolbar is docked vertically, this method positions the drop-down toolbar either to the left-hand or right-hand side of the parent toolbar, depending on the fit. Otherwise, this method positions the drop-down toolbar underneath the parent toolbar.

This method fails if pWnd is NULL and the drop-down toolbar button does not have a parent window.

Requirements

Header: afxdropdowntoolbar.h

See Also

Reference

CMFCDropDownToolbarButton Class

Hierarchy Chart

CMFCDropDownToolbarButton::OnClick

CMFCDropDownFrame::Create