Share via


CMFCToolBar::EnableCustomizeButton

Enables or disables the Customize button that appears on the toolbar.

void EnableCustomizeButton(
   BOOL bEnable,
   int iCustomizeCmd,
   const CString& strCustomizeText,
   BOOL bQuickCustomize=TRUE 
);
void EnableCustomizeButton(
   BOOL bEnable,
   int iCustomizeCmd,
   UINT uiCustomizeTextResId,
   BOOL bQuickCustomize=TRUE 
);

Parameters

  • [in] bEnable
    Enables or disables the Customize button.

  • [in] iCustomizeCmd
    The command ID of the Customize button.

  • [in] strCustomizeText
    The text label of the Customize button.

  • [in] uiCustomizeTextResId
    The resource string ID of the Customize button label.

  • [in] bQuickCustomize
    Enables or disables the Add or Remove Buttons option on the menu that drops down from the button.

Remarks

If iCustomizeCmd is -1, the framework displays the Customize button when multiple toolbar buttons do not fit in the toolbar area. The button displays a double left-pointing arrow, or chevron, which indicates that there are more buttons.

If iCustomizeCmd specifies a valid command ID, and bEnable is TRUE, the Customize button is always displayed. The button has a small down arrow and opens a menu that contains a command. This command uses the text label specified by strCustomizeText. If bQuickCustomize is also TRUE, the menu displays the Add or Remove Buttons option.

The framework dynamically adds to the menu any buttons that do not fit in the toolbar area before the item that is specified by iCustomizeCmd. The chevron is displayed next to the down arrow.

Requirements

Header: afxtoolbar.h

See Also

Reference

CMFCToolBar Class

Hierarchy Chart