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

Tooltips for Toolbars in Non-CFrameWnd Windows

, 20 May 2003
Rate this:
Please Sign up or sign in to vote.
Explains how to add tool tips for toolbars attached to CDialog or CView descentants.

Sample Image - ToolTipsInDialog.gif

Introduction

When I posted an article discussing the subject of placing a toolbar right in the middle of elsewhere, Daniel Kaminsky pointed out, that the tool tips were not displayed.

So I sat down, and placed the line EnableToolTips() in my dialogs OnInitDialog function. And what shall I tell you, it did not work. Every dialog and every view showed the toolbar, but no tool tips, or occasionally only very odd ones popped up.

Having a look at the help, there it was stated:

Simply calling EnableToolTips is not enough to display tool tips for your child controls unless the parent window is derived from CFrameWnd.

And because a CDialog or CView is not a descendant of CFrameWnd the tool tips will not get displayed. But a solution was also at the bottom of this article, which I implemented without further thinking. It worked well except to the fact that it showed something like: "Your mouse is hovering over the control with the ID 1234". That was something I never used as tool tip text. Because I wanted the text, stored in the resource of the toolbar being displayed, I looked up the source codes of the MFC itself.

The solution provided here is solely from the people of Microsoft. My only creative part, is finding the places to copy!

Step1

Create a toolbar and attach it to your dialog. Use the normal method of creating a variable of type CToolBar, and ... (or look at the source). In the creation process during OnInit...(), make sure that the bar style flag CBRS_TOOLTIPS is set.

m_wndToolBar.SetBarStyle(CBRS_ALIGN_ANY | CBRS_TOOLTIPS | CBRS_FLYBY);

Then call EnableToolTips(true);. If you compile now, and run the application, you can see the tool tips not to work.

Step2

Now comes the typing part. Create a message map entry in your CPP-file.

ON_NOTIFY_EX_RANGE(TTN_NEEDTEXTW, 0, 0xFFFF, OnToolTipNotify)
ON_NOTIFY_EX_RANGE(TTN_NEEDTEXTA, 0, 0xFFFF, OnToolTipNotify)

Or copy these two lines just before the END_MESSAGE_MAP() line in your dialogs CPP-file.

According to the documentation, you must create an entry for both TTN_NEEDTEXTW and TTN_NEEDTEXTA notifications.

In your header file declare a function prototype for OnToolTipNotify:

afx_msg BOOL OnToolTipNotify(UINT id, NMHDR *pNMHDR,LRESULT *pResult);

Or copy this line just before the DECLARE_MESSAGE_MAP() line in your dialogs h-file.

If you compile now, the compiler will tell you, that it needs a function named OnToolTipNotify.

Step 3

Now comes the copy part. Write a new line in your dialogs implementation file (*.cpp):

BOOL CMyDlgOrView:OnToolTipNotify(UINT, NMHDR* pNMHDR, LRESULT* pResult)

Open WINFRM.CPP in your MFC-source directory. Copy the complete function body of BOOL CFrameWnd::OnToolTipText(UINT, NMHDR* pNMHDR, LRESULT* pResult) and paste it just beneath the new written line in your dialogs/view implementation file. Do not compile!

I told you not to! Add #include <afxpriv.h> either at the beginning of the dialogs header file or elsewhere in stdafx.h. Thus the functions AfxExtractSubString and AfxLoadString are known. Find the following lines in AFXISAPI.H (source directory for MFC->Include)

#ifndef _countof
#define _countof(array) (sizeof(array)/sizeof(array[0]))
#endif

and paste them into stdafx.h.

Compile, and see the tool tips work.

Extroduction

If you have no access to the sources of the MFC, open the sources of the demo project. I did already copy and paste. If I understand right, what is said in the documentation, this will work for any CWnd - window. Like CDialogs, CViews, CStatics, CTreeCtrls, just to name a few? Happy copying and pasting.

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

About the Author

G. Steudtel
Software Developer (Senior)
Germany Germany
No Biography provided

Comments and Discussions

 
Questionwhy i can not download the demo? Pinmemberloverc19-May-06 22:49 
GeneralNot work in ChildFramexxx.cpp Pinmemberzilnus27-Jul-05 18:57 
QuestionHelp!How to create a non-rectangular Toolbar? Pinmembertododay21-Dec-03 22:17 
Questionwhat abt in ActiveX controls? PinsussAnonymous17-Jun-03 22:23 
AnswerRe: what abt in ActiveX controls? PinmemberTzoockee11-Jul-03 12:55 
GeneralStatusbar text PinmemberKonrad Windszus7-Jun-03 3:05 
GeneralMaybe you can help me PinmemberJosema21-May-03 6:33 
GeneralRe: Maybe you can help me PinmemberG. Steudtel23-May-03 2:46 
GeneralRe: Maybe you can help me PinmemberJosema25-May-03 8:49 
GeneralRe: Maybe you can help me PinmemberG. Steudtel30-May-03 6:26 
GeneralAnd why not just use CFrameWnd???... Pinmemberigor19605-May-03 19:44 
GeneralRe: And why not just use CFrameWnd???... PinmemberG. Steudtel6-May-03 2:58 
GeneralRe: And why not just use CFrameWnd???... Pinmemberigor19606-May-03 7:16 
GeneralRe: And why not just use CFrameWnd???... PineditorNishant S6-May-03 18:25 
GeneralRe: And why not just use CFrameWnd???... Pinmemberarmentage27-May-03 4:12 

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 21 May 2003
Article Copyright 2003 by G. Steudtel
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid