CMFCDropDownToolbarButton Class
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
Tasks
Walkthrough: Putting Controls On Toolbars