Click here to Skip to main content
Click here to Skip to main content
Go to top

How to display tooltips for a toolbar in a dialog

, 10 Jan 2000
Rate this:
Please Sign up or sign in to vote.
Simple technique for getting tooltips when you have a toolbar in a dialog
<!-- Article Starts -->

It is relatively easy to place a toolbar in a dialog box, but I had a hard time making the tooltips appear since none of the TTN_xxxx message handlers are present in a CDialog derived class. This article describes a simple technique for getting tooltips when you have a toolbar in a dialog. It also gives a brief overview of the steps involved in adding a toolbar to a dialog box.

Step 1

In the dialog's header file you must add a CToolBar instance and an entry in the message map to handle the tooltip messages.

protected:
    CToolBar cToolBar;

at the bottom of the wizard generated message map entries add:

    //}}AFX_MSG
    afx_msg BOOL OnToolTipText(UINT nID, NMHDR* pNMHDR, LRESULT* pResult);
    DECLARE_MESSAGE_MAP()

Step 2

In dialog's implementation file add the following to the end of OnInitDialog to show the toolbar.

    //add the tool bar to the dialog
    cToolBar.Create(this);
    cToolBar.LoadToolBar(IDR_TOOLBAR);
    cToolBar.ShowWindow(SW_SHOW);
    cToolBar.SetBarStyle(CBRS_ALIGN_TOP | CBRS_TOOLTIPS | CBRS_FLYBY);
    RepositionBars(AFX_IDW_CONTROLBAR_FIRST, AFX_IDW_CONTROLBAR_LAST, 0);

At the bottom of the message map add the following:

ON_NOTIFY_EX_RANGE(TTN_NEEDTEXTW, 0, 0xFFFF, OnToolTipText)
ON_NOTIFY_EX_RANGE(TTN_NEEDTEXTA, 0, 0xFFFF, OnToolTipText)
END_MESSAGE_MAP()

Finally add the message handler method as entered in the message map:

BOOL CToolBarTipTestDialog::OnToolTipText(UINT, NMHDR* pNMHDR, LRESULT* pResult)
{
    ASSERT(pNMHDR->code == TTN_NEEDTEXTA || pNMHDR->code == TTN_NEEDTEXTW);

    // if there is a top level routing frame then let it handle the message
    if (GetRoutingFrame() != NULL) return FALSE;

    // to be thorough we will need to handle UNICODE versions of the message also !!
    TOOLTIPTEXTA* pTTTA = (TOOLTIPTEXTA*)pNMHDR;
    TOOLTIPTEXTW* pTTTW = (TOOLTIPTEXTW*)pNMHDR;
    TCHAR szFullText[512];
    CString strTipText;
    UINT nID = pNMHDR->idFrom;

    if (pNMHDR->code == TTN_NEEDTEXTA && (pTTTA->uFlags & TTF_IDISHWND) ||
        pNMHDR->code == TTN_NEEDTEXTW && (pTTTW->uFlags & TTF_IDISHWND))
    {
        // idFrom is actually the HWND of the tool 
        nID = ::GetDlgCtrlID((HWND)nID);
    }

    if (nID != 0) // will be zero on a separator
    {
        AfxLoadString(nID, szFullText);
        strTipText=szFullText;

#ifndef _UNICODE
        if (pNMHDR->code == TTN_NEEDTEXTA)
        {
            lstrcpyn(pTTTA->szText, strTipText, sizeof(pTTTA->szText));
        }
        else
        {
            _mbstowcsz(pTTTW->szText, strTipText, sizeof(pTTTW->szText));
        }
#else
        if (pNMHDR->code == TTN_NEEDTEXTA)
        {
            _wcstombsz(pTTTA->szText, strTipText,sizeof(pTTTA->szText));
        }
        else
        {
            lstrcpyn(pTTTW->szText, strTipText, sizeof(pTTTW->szText));
        }
#endif

        *pResult = 0;

        // bring the tooltip window above other popup windows
        ::SetWindowPos(pNMHDR->hwndFrom, HWND_TOP, 0, 0, 0, 0,
            SWP_NOACTIVATE|SWP_NOSIZE|SWP_NOMOVE|SWP_NOOWNERZORDER);
        
        return TRUE;
    }

    return FALSE;
}

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

Share

About the Author

Randy More

United States United States
No Biography provided

Comments and Discussions

 
QuestionAfxLoadString PinmemberChris F.15-Sep-11 6:01 
AnswerRe: AfxLoadString PinmemberMember 1093212418-Sep-14 1:34 
QuestionExcelent!! Pinmemberdonghyuk80kim26-Jul-11 15:14 
GeneralIt's better: PinmemberMember #1631198-Jan-07 5:24 
Questiondll-modeless dialogbox-toolbar-tooltips Pinmemberjgcollins26-Aug-05 12:26 
AnswerRe: dll-modeless dialogbox-toolbar-tooltips PinmemberMiles Davies6-Oct-05 3:28 
AnswerRe: dll-modeless dialogbox-toolbar-tooltips Pinmembermartypku6-Jun-07 4:36 
AnswerRe: dll-modeless dialogbox-toolbar-tooltips PinmemberToBach28-Nov-07 22:49 
AnswerRe: dll-modeless dialogbox-toolbar-tooltips Pinmembershazzababs27-May-08 21:41 
GeneralThanks a lot Pinmemberrussel_ak25-May-05 18:01 
GeneralDialog in dll doesn't send these notification! Pinmemberdaveice8-Apr-05 0:01 
GeneralI meet this problem too PinsussAnonymous17-May-05 17:06 
GeneralRe: I meet this problem too Pinmemberdaveice17-May-05 17:50 
GeneralRe: I meet this problem too Pinmembermeijun24-May-05 20:07 
GeneralRe: I meet this problem too PinmemberMycro31-Oct-07 18:31 
GeneralA fix for a crash PinmemberYawar Maajed25-Apr-04 19:08 
GeneralRe: A fix for a crash PinmemberMichel Wassink25-Apr-04 20:28 
GeneralRe: A fix for a crash PinmemberYawar Maajed26-Apr-04 6:09 
GeneralTooltips on menu items Pinmemberj3ves15-Feb-04 22:59 
GeneralDoesn't work with modeless dialogs PinmemberS Macdonald21-Oct-03 4:37 
QuestionHow to make the certain toolbar button disable under certain case? PinmemberJack_Cai25-Mar-03 4:38 
AnswerRe: How to make the certain toolbar button disable under certain case? Pinsussjan_mfff28-Apr-03 7:45 
GeneralRe: How to make the certain toolbar button disable under certain case? Pinmemberhorsewww5-Sep-04 17:24 
GeneralToolTips from ToolBar on the StatusBar in Dialog Pinmemberkostax1-Aug-02 21:57 
GeneralDockable Toolbars in Dialogs PinmemberRabentochter17-Jul-02 1:07 

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.140916.1 | Last Updated 11 Jan 2000
Article Copyright 2000 by Randy More
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid