Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
A type of toolbar button that behaves like a regular button when it is clicked. However, it opens a drop-down toolbar (CMFCDropDownToolBar Class if the user presses and holds the toolbar button down.
class CMFCDropDownToolbarButton : public CMFCToolBarButton
Members
Public Constructors
| Name | Description | 
|---|---|
| Constructs a CMFCDropDownToolbarButton object. | |
| CMFCDropDownToolbarButton::~CMFCDropDownToolbarButton | Destructor. | 
Public Methods
| Name | Description | 
|---|---|
| Copies the properties of another toolbar button to the current button. (Overrides CMFCToolBarButton::CopyFrom.) | |
| CMFCDropDownToolbarButton::CreateObject | Used by the framework to create a dynamic instance of this class type. | 
| Opens a drop-down toolbar. | |
| Copies text from the toolbar button to a menu. (Overrides CMFCToolBarButton::ExportToMenuButton.) | |
| Retrieves the drop-down toolbar that is associated with the button. | |
| CMFCDropDownToolbarButton::GetThisClass | Used by the framework to obtain a pointer to the CRuntimeClass object that is associated with this class type. | 
| Determines whether the drop-down toolbar is currently open. | |
| Determines whether the button can be displayed with an extended border. (Overrides CMFCToolBarButton::IsExtraSize.) | |
| Called by the framework to calculate the size of the button for the specified device context and docking state. (Overrides CMFCToolBarButton::OnCalculateSize.) | |
| CMFCDropDownToolbarButton::OnCancelMode | Called by the framework to handle the WM_CANCELMODE message. (Overrides CMCToolBarButton::OnCancelMode.) | 
| Called by the framework when the button is inserted into a new toolbar. (Overrides CMFCToolBarButton::OnChangeParentWnd.) | |
| Called by the framework when the user clicks the mouse button. (Overrides CMFCToolBarButton::OnClick.) | |
| Called by the framework when the user releases the mouse button. (Overrides CMFCToolBarButton::OnClickUp.) | |
| Called by the framework when the parent toolbar handles a WM_HELPHITTEST message. (Overrides CMFCToolBarButton::OnContextHelp.) | |
| Modifies the provided menu when the application displays a shortcut menu on the parent toolbar. (Overrides CMFCToolBarButton::OnCustomizeMenu.) | |
| Called by the framework to draw the button by using the specified styles and options. (Overrides CMFCToolBarButton::OnDraw.) | |
| Called by the framework to draw the button in the Commands pane of the Customize dialog box. (Overrides CMFCToolBarButton::OnDrawOnCustomizeList.) | |
| Reads this object from an archive or writes it to an archive. (Overrides CMFCToolBarButton::Serialize.) | |
| Sets the default command that the framework uses when a user clicks the button. | 
Data Members
| Name | Description | 
|---|---|
| Specifies the length of time that a user must hold the mouse button down before the drop-down toolbar appears. | 
Remarks
A CMFCDropDownToolBarButton differs from an ordinary button in that it has a small arrow in the lower-right corner of the button. After the user selects a button from the drop-down toolbar, the framework displays its icon on the top-level toolbar button (the button with the small arrow in the lower-right corner).
For information about how to implement a drop-down toolbar, see CMFCDropDownToolBar Class.
The CMFCDropDownToolBarButton object can be exported to a CMFCToolBarMenuButton Class object and displayed as a menu button with a pop-up menu.
Inheritance Hierarchy
Requirements
Header: afxdropdowntoolbar.h
See Also
Concepts
How to: Put Controls On Toolbars