Click here to Skip to main content
15,860,861 members
Articles / Desktop Programming / MFC
Article

CToolbarDialog - dialog with floating toolbar

Rate me:
Please Sign up or sign in to vote.
4.80/5 (22 votes)
6 Apr 20043 min read 158.4K   6.3K   56   30
A CDialog derived class that contains a floating toolbar.

Sample Image - toolbardialog.jpg

Introduction

This article shows how to add a floating/docking toolbar to a dialog.

In MSDN, there is a sample (dlgcbr32) in which is presented a way to add a fixed toolbar to a dialog. I have extended that example and created a CDialog derived class that contains a toolbar which can be either fixed, floating or hidden. The floating toolbar effect is obtained by dynamically creating a modeless dialog box which contains a fixed toolbar.

Using the code

To use the code, you must do the following steps:

  1. Include ToolbarDialog.h and ToolbarDialog.cpp in your project.
  2. Derive your dialog from CToolbarDialog:
    #include "ToolbarDialog.h"
    class CTDDlg : public CToolbarDialog

    Also make sure that you pass at least the ID of the toolbar resource you want to use to the CToolbarDialog constructor. This constructor has four parameters: the first two are the dialog ID and parent (just like CDialog), the third is the ID of the toolbar resource and the fourth is the initial state of the toolbar. Possible values are:

    TS_HIDDEN       //toolbar is not shown
    TS_FLOATING     //toolbar is floating
    
    TS_LEFT         //toolbar is fixed in the left size of the dialog
    TS_TOP          //toolbar is fixed at the top of the dialog
    TS_RIGHT        //toolbar is fixed in the right size of the dialog
    TS_BOTTOM       //toolbar is fixed at the bottom of the dialog

    Here is an example:

    CTDDlg::CTDDlg(CWnd* pParent /*=NULL*/)
        :CToolbarDialog(CTDDlg::IDD, pParent,IDR_TOOLBAR1,TS_HIDDEN)
  3. In your class, declare and implement the function:

    virtual LONG ToolbarButtonCommand(UINT uButtonID);

    This function receives as parameter the ID of the toolbar button that was pressed. By implementing this function, you can add handlers to the toolbar buttons.

    Example:

    LONG CTDDlg::ToolbarButtonCommand(UINT uButtonID)
    {
        CString msg;
        msg.Format("Button with ID %d was pressed in toolbar",uButtonID);
        AfxMessageBox(msg);
        return 0;
    }
  4. If you want to set the state of the toolbar dynamically, just call PositionToolbar(DWORD dwPosition). The values the parameter can have are the ones described earlier.

    For example, to show the toolbar floating, just add the following function call to your code:

    PositionToolbar(TS_FLOATING);
  5. To enable/disable the toolbar buttons, just add the UpdateCommandUI handlers to your dialog and edit the methods as you would, in every Frame/View application.

    For example:

    ON_UPDATE_COMMAND_UI_RANGE(ID_BUTTON32771,ID_BUTTON32775,OnUpdateBtn)
    
    void CTDDlg::OnUpdateBtn(CCmdUI* pCmd)
    {
          if(pCmd->m_nID == ID_BUTTON32771)
                pCmd->Enable(FALSE);
    }
  6. If you want to have tooltips for the toolbar buttons, follow the steps described in Randy More's article.

You now have a dialog that support floating toolbars.

I have tested this class only on Windows 2000, but I think it will also work on Win9x and WinXP.

Revision History

Version 1.0.0 - 2004 April 7

  • First release.

Version 1.0.1 - 2004 April 8

  • FIXED BUG: when toolbar is attached to the right or the left, no dragging possible by clicking on the handle (thanks to ReorX for informing me about this bug).
  • FIXED BUG: when the floating toolbar is docked, the parent dialog does not receives the focus.

Version 1.0.2 - 2004 April 9

  • ADDED: VC6 compatibility
  • ADDED: Tooltips support (thanks to Randy More for his article about adding tooltips to toolbars in dialogs)
  • FIXED BUG: UPDATE_COMMAND_UI does not work (thanks to =[ Abin ]= for informing me about this bug)

Acknowledgments

  • Thanks to Cristian Teodorescu for giving me the idea of using a dynamic dialog for the floating toolbar.
  • Thanks to Microsoft Corporation for their Dlgcbr32 sample

Usage

You are free to use this software in any personal or freeware application. If you use this software in any shareware or commercial application, you MUST get my permission first. If you modify it or extend it, please to consider posting new code here for everyone to share. This software is provided "as is" with no expressed or implied warranty. I accept no liability for any damage or loss of business that this software may cause.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


Written By
Software Developer (Senior) CS Romania
Romania Romania
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
GeneralMy vote of 5 Pin
Ștefan-Mihai MOGA12-Oct-23 20:01
professionalȘtefan-Mihai MOGA12-Oct-23 20:01 
Questionfile is bad! Pin
xuhuan10-Jan-14 1:00
xuhuan10-Jan-14 1:00 
Questionhi,very nice Pin
codeangel13-Sep-07 18:35
codeangel13-Sep-07 18:35 
GeneralUPDATE_COMMAND_UI problem in a Single Document application Pin
Bumbala13-Nov-06 4:29
Bumbala13-Nov-06 4:29 
GeneralTrue Colour Toolbars - How To: Pin
Dangta18-Sep-06 15:30
Dangta18-Sep-06 15:30 
QuestionRe: True Colour Toolbars - How To: Pin
Member 1437903311-Nov-21 14:36
Member 1437903311-Nov-21 14:36 
GeneralWorks Great! Pin
ajselvig8-Feb-06 6:41
ajselvig8-Feb-06 6:41 
GeneralNice work, but how to disable the docking function Pin
taxtdod4-Oct-05 18:56
taxtdod4-Oct-05 18:56 
GeneralRe: Nice work, but how to disable the docking function Pin
tim6356-Oct-05 0:27
tim6356-Oct-05 0:27 
GeneralDouble Click on Toolbar Pin
Morteza Ghasemi29-Jun-05 3:40
Morteza Ghasemi29-Jun-05 3:40 
GeneralRe: Double Click on Toolbar Pin
Lucian Barbulescu29-Jun-05 22:06
Lucian Barbulescu29-Jun-05 22:06 
GeneralRe: Double Click on Toolbar Pin
psj6994-Oct-05 15:16
psj6994-Oct-05 15:16 
Generalnice article, 1 more question :) Pin
mynh7916-Aug-04 3:12
mynh7916-Aug-04 3:12 
QuestionFail to ??? Pin
KW-Rix10-Aug-04 21:43
KW-Rix10-Aug-04 21:43 
AnswerRe: Fail to ??? Pin
KW-Rix10-Aug-04 21:54
KW-Rix10-Aug-04 21:54 
GeneralRe: Fail to ??? Pin
Lucian Barbulescu11-Aug-04 21:52
Lucian Barbulescu11-Aug-04 21:52 
QuestionGreat ,But Questions ?? Pin
KW-Rix9-Aug-04 22:34
KW-Rix9-Aug-04 22:34 
AnswerRe: Great ,But Questions ?? Pin
Lucian Barbulescu9-Aug-04 23:14
Lucian Barbulescu9-Aug-04 23:14 
GeneralRe: Great ,But Questions ?? Pin
KW-Rix10-Aug-04 20:46
KW-Rix10-Aug-04 20:46 
QuestionHow I Add more than 1 toolbar Pin
Member 68173416-Jun-04 21:23
Member 68173416-Jun-04 21:23 
AnswerRe: How I Add more than 1 toolbar Pin
Lucian Barbulescu16-Jun-04 21:45
Lucian Barbulescu16-Jun-04 21:45 
GeneralAnother way... Pin
Anna-Jayne Metcalfe12-Apr-04 23:48
Anna-Jayne Metcalfe12-Apr-04 23:48 
GeneralOh, and UPDATE_COMMAND_UI Pin
Abin8-Apr-04 23:30
Abin8-Apr-04 23:30 
GeneralRe: Oh, and UPDATE_COMMAND_UI Pin
Lucian Barbulescu9-Apr-04 3:46
Lucian Barbulescu9-Apr-04 3:46 
GeneralRe: Oh, and UPDATE_COMMAND_UI Pin
Abin9-Apr-04 5:06
Abin9-Apr-04 5:06 

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

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