Click here to Skip to main content
Click here to Skip to main content

ToolBar with Customization and Controls

, 18 Dec 2001
Rate this:
Please Sign up or sign in to vote.
A ToolBar class with customization and Controls

Sample Image - ToolBarEx.jpg

Introduction

The CToolbarEx class supports basic customization (As in IE) with controls on it. Additionally it can hide the controls when the toolbar is docked vertically. This class uses the framework provided by ToolBarCtrl to do the customization of the Toolbar. It also supports Large Icons and Text on Buttons.

It uses a modified CCustomizeDialog class by Nikolay Denisov to provide extra options in the Toolbar customize Dialog.

I have hardcoded a few things in CCustomizeDialog to avoid resource dependences It also overrides CDockBar with CDockBarEx to provide 3D looks and overcome some docking bugs.

To use these in your project, do the following steps:

  1. Add ToolBarEx.cpp and ToolBarEx.h in your Project.
  2. Include ToolbarEx.h in MainFrame.h and Replace CToolBar with CToolBarEx in CMainFrame
    #include <span class="code-string">"ToolBarEx.h"</span>
    . .
    
    // CToolBar      m_wndToolBar;
    CToolBarEx    m_wndToolBar;
    
  3. In your OnCreate override in your CMainFrame class, when the creation of the Toolbar is done (including controls), call SetToolBarInfoForCustomization to set the Customization Data in the Toolbar. This function should be called after the creation of the toolbar, controls and dropdown is done.
    CRect rt(0,0,200,120);
    
    //Insert Control
    m_pComboBox =(CComboBox *) m_wndToolBar.InsertControl(
        RUNTIME_CLASS(CComboBox),_T(""),
        rt,ID_FIND,WS_VSCROLL|CBS_DROPDOWNLIST);
    m_pComboBox->AddString(_T("One"));
    m_pComboBox->AddString(_T("Two"));
    m_pComboBox->AddString(_T("Three"));
    
    //Add DropDown
    m_wndToolBar.AddDropDownButton(ID_OP,IDR_OP,TRUE);
    
    //Enable Customization
    m_wndToolBar.SetToolBarInfoForCustomization();
  4. Restore the last saved data of the Toolbar
    //Restore State
    m_wndToolBar.RestoreState();

    Similarly you can also add SaveState in OnClose of the CMainFrame.

  5. Then delete the buttons you do not want to show as default and call MarkDefaultState to set the default state of the toolbar. The default state is set when Reset button on the Customize Dialog Box is pressed.
    //Delete the button which do not need to shown initially.
    m_wndToolBar.GetToolBarCtrl().DeleteButton(
        m_wndToolBar.CommandToIndex(ID_CUSTOMIZE));
    
    
    // Mark the default state for reset
    m_wndToolBar.MarkDefaultState();
  6. Call FrameEnableDocking instead of EnableDocking to use CDockBarEx instead of CDockBar.
    //     EnableDocking(CBRS_ALIGN_ANY);
    FrameEnableDocking(this,CBRS_ALIGN_ANY);

Member Functions & Data Members

CWnd* InsertControl(CRuntimeClass* pClass,LPCTSTR lpszWindowName,
    CRect& rect,UINT nID,DWORD dwStyle );

This function creates and inserts the control into the Toolbar and returns the window inserted. In rect parameter, pass only the width and height.

CWnd* InsertControl(CWnd* pCtrl,CRect& rect,UINT nID);

This function inserts the already created control into the Toolbar. In rect parameter, pass only the width and height.

BOOL AddDropDownButton(UINT nIDButton,UINT nIDMenu,BOOL bArrow=TRUE);

This function a button to a Dropdown with a menu attached to it. Set bArrow to TRUE if you want to show arrow next to it.

void SetToolBarInfoForCustomization();

This function sets the Customization information for the Toolbar. The Names used for the buttons in Customize dialog box are taken from the Tooltip of the Button. (String after Last '\n' of Prompt in Button Properties in Toolbar resource editing.) Call this function after the creation of the Toolbar is done. i.e. Controls, Dropdown have been added.

void MarkDefaultState();

This function sets the default state of the Toolbar. The default state is set when Reset button of Customize Dialog Box is pressed.

void SaveState()

This function saves the State of the Toolbar in the Registry.

void RestoreState()

This function restores the State of the Toolbar from the Registry.

BOOL m_bHideChildWndOnVertical;

This flag controls whether the Controls are visible in the Vertical docking mode. Default Value is TRUE

BOOL HasButtonText( int nID)

This function is used to determine whether the button has Text in "Selective Text on Right". At present it returns TRUE for all. Override this to provide new logic. nID is the command Identifier.

Minimum Requirements

It requires 5.80 version of the Commctl32.dll. It uses few features of 5.81 version, but they seem to work fine on 5.80 also. Please look at the Demo for full details.

Thanks to all Code Project /Code Guru Developers.

History

  • 16 Oct 2001 - updated download files
  • 20 Dec 2001 - updated files, new .NET style!

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

About the Author

Deepak Khajuria
Web Developer
United States United States
Programming in MFC/ATL for 2-3 years.

Comments and Discussions

 
BugApplication crashes... PinmemberDenny V Abraham27-Jun-12 19:57 
Generala bug with 'toTextOnRight' option Pinmember01_mental23-Aug-09 22:35 
QuestionHow to Save/Restore CToolBar in/from *.INI file? Pinmemberp2002ad5-Aug-09 14:11 
GeneralThanks... PinmemberMaximilien10-Feb-09 8:36 
QuestionProblem with docking on left or right (vertical) [modified] Pinmemberldaoust15-Sep-07 14:26 
AnswerRe: Problem with docking on left or right (vertical) Pinmemberldaoust15-Sep-07 15:57 
GeneralA Bug? :~ PinmemberKarstenK5-Apr-06 22:00 
QuestionProblem with tooltip Pinmemberduronebis7-Jan-06 8:56 
I have a strange problem with toolptip:
My application is a Multitemplate MDI and every template Shows its own toolbars using
ShowControlBar(pControlBar, TRUE, FALSE);
in my Templates Toolbar the tootips start to work only if stay with the cursor over a Toolbar Separator.
After that tolltips works well,
Before nothing to do, they don't show up....
In the first empty view of my application (I start it without an open document) the tooltips are ok.
 
Any Ideas?
I debugged all the afternoon and the messages to the tooltips seem ok, but they don't show up...
 
Great work, BTW!
 
ciao
Stefano
GeneralCutting Toolbar in VC++ 7.1, and customizing not work in dialogs Pinmembercsavie8-Aug-05 14:47 
GeneralXP Theme Support PinmemberJustin Hallet24-Jun-05 5:23 
GeneralIt works but the example source is a jungle... PinmemberPanic2k318-Apr-05 12:01 
GeneralCustomization for a Dialog Pinmembercsavie5-Apr-05 1:37 
GeneralRe: Customization for a Dialog Pinmembershawkins2-Feb-06 14:03 
GeneralA handle to the MENU of a drop down button PinmemberAlex Evans16-Nov-04 13:34 
GeneralFeature request: Inserting CToolBarEx into a CDialog PinmemberBrian van der Beek7-May-04 12:02 
GeneralRe: Feature request: Inserting CToolBarEx into a CDialog PinsussAnonymous14-Jun-04 5:08 
GeneralHaving several toolbars in one row by default PinmemberDonGuitar27-Apr-04 23:50 
GeneralNice, but bad size when docking isn't enabled Pinmembertangens23-Jan-04 5:14 
GeneralRe: Nice, but bad size when docking isn't enabled PinmemberDeelip13-Aug-05 20:05 
GeneralIcon Background in Customize Dialog PinmemberNicolas Bonamy14-Mar-03 0:29 
GeneralLoading bitmap on toolbar PinsussAnonymous11-Nov-02 4:05 
Generalcontext menu error when more than one toolbar Pinmemberarc25-Sep-02 15:01 
GeneralRe: context menu error when more than one toolbar PinmemberKirk318-Dec-02 1:17 
GeneralRe: context menu error when more than one toolbar PinmemberDonGuitar27-Apr-04 23:29 
GeneralBasic CToolBar PinmemberAnthonyWinters8-Aug-02 8:03 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web02 | 2.8.140721.1 | Last Updated 19 Dec 2001
Article Copyright 2001 by Deepak Khajuria
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid