Click here to Skip to main content
13,506,210 members
Click here to Skip to main content
Add your own
alternative version


55 bookmarked
Posted 5 Jan 2000

Multiline Titletips

Rate this:
Please Sign up or sign in to vote.
A class that allows you to display data for a control that is otherwise not large enough to display the full text
  • Download demo project - 23 Kb
  • Download source files - 5 Kb
  • Sample Image - Multiline_Titletips.gif

    <!-- Article Starts -->

    A titletip is similar to a tooltip, but is used to display data in a control that is otherwise not large enough to display the full text. We are all used to seeing cell titletips that display contents that are hidden by the width of the cell. These titletips typically use a single line. If the contents are greater than the single line, they were truncated.

    The code presents a titletip class that can show the complete contents of a cell regardless of its size. The titletip window will adjust itself up or down depending on the cell being displayed, and will take into account the size of the parent's client area, and that of the screen. It will do its utmost to show you that data!

    This article is based on code written by Zafir Anjum, but has been extensively reworked to add a great deal of new functionality.

    How to use CTitleTip

    Using the class is extremely easy. Just declare an object of type CTitleTip in your main windows' header, and then create the title tip window in your dialog's OnInitDialog, or your view's OnInitialUpdate:

    // dialog header file
    class CTitleTipDemoDlg : public CDialog
    	CTitleTip m_TitleTip;
    BOOL CTitleTipDemoDlg::OnInitDialog()
    	return TRUE;  // return TRUE  unless you set the focus to a control

    You then need to add a mouse over handler so that when the mouse cursor moves over controls that may contain large amounts of text, you can popup a title tip to display that text. For instance, in our demo dialog we have a static control (m_staticText) that displays a lot of text. Just add an OnMouseMove handler and add the following code:

    void CTitleTipDemoDlg::OnMouseMove(UINT nFlags, CPoint point) 
    	// Get the dimensions of the static control
    	CRect rect;
    	// If the mouse is over the control, display the titletip. 
    	// Note: The title tip will only be displayed if the text
    	// in the static control is too large for the static control
    	if (rect.PtInRect(point))
    		CString str;
    		m_TitleTip.Show(rect, str, 0, 80);
    	CDialog::OnMouseMove(nFlags, point);

    The CTitleTip::Show function has the following syntax

    void Show(CRect rectTitle,            // Bounds of the control containing the text
              LPCTSTR lpszTitleText,      // The text to display
              int xoffset = 0,            // offset to display text within title tip
              int nMaxChars = -1,         // Maximum number of characters per line to display
              LPRECT lpHoverRect = NULL,  // Once the mouse moves outside of this
                                          //   rect, the title tip will disappear
              LPLOGFONT lpLogFont = NULL) // The font in which to display the text

    If nMaxChars is less than 0, then the text will only wrap where there is insufficient room to display the entire line.

    if lpHoverRect is NULL then it will be set as rectTitle.


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


    About the Authors

    Chris Maunder
    Founder CodeProject
    Canada Canada
    Chris is the Co-founder, Administrator, Architect, Chief Editor and Shameless Hack who wrote and runs The Code Project. He's been programming since 1988 while pretending to be, in various guises, an astrophysicist, mathematician, physicist, hydrologist, geomorphologist, defence intelligence researcher and then, when all that got a bit rough on the nerves, a web developer. He is a Microsoft Visual C++ MVP both globally and for Canada locally.

    His programming experience includes C/C++, C#, SQL, MFC, ASP, ASP.NET, and far, far too much FORTRAN. He has worked on PocketPCs, AIX mainframes, Sun workstations, and a CRAY YMP C90 behemoth but finds notebooks take up less desk space.

    He dodges, he weaves, and he never gets enough sleep. He is kind to small animals.

    Chris was born and bred in Australia but splits his time between Toronto and Melbourne, depending on the weather. For relaxation he is into road cycling, snowboarding, rock climbing, and storm chasing.

    Mark Findlay
    United States United States
    No Biography provided

    You may also be interested in...

    Comments and Discussions

    QuestionCGridCtrl version 2.27 has not AddPoint Method Pin
    AYDIN EBRAHIMI HOMAY26-Mar-13 3:41
    memberAYDIN EBRAHIMI HOMAY26-Mar-13 3:41 
    GeneralGood Job Pin
    clxye13-Dec-07 15:50
    memberclxye13-Dec-07 15:50 
    GeneralCTitleTip Class not found Pin
    123Asha4-Sep-07 20:40
    member123Asha4-Sep-07 20:40 
    GeneralTo display Custom tooltiptext in taskbar Pin
    123Asha4-Sep-07 20:37
    member123Asha4-Sep-07 20:37 
    QuestionCan this be used with app's taskbar button tooltip ??? Pin
    ana_v12311-Apr-06 13:01
    memberana_v12311-Apr-06 13:01 
    GeneralStrage behaviour Pin
    iasen_st23-Aug-04 3:01
    memberiasen_st23-Aug-04 3:01 
    Generalproblem! pls help! Pin
    ns12-Nov-03 7:53
    memberns12-Nov-03 7:53 
    GeneralTrying to use an edit box Pin
    ns7-Nov-03 4:22
    memberns7-Nov-03 4:22 
    Questionnice work...and bug? Pin
    HighJack11-Feb-03 21:52
    memberHighJack11-Feb-03 21:52 
    GeneralExcellent Pin
    JohnJ3-Jan-03 0:41
    memberJohnJ3-Jan-03 0:41 
    QuestionHow can I use this titletip in CGridctrl. Pin
    Anonymous3-Nov-02 18:32
    sussAnonymous3-Nov-02 18:32 
    AnswerRe: How can I use this titletip in CGridctrl. Pin
    Chopper18-Dec-02 0:21
    memberChopper18-Dec-02 0:21 
    Generalnice work Pin
    Kevin Smith26-Aug-02 9:44
    memberKevin Smith26-Aug-02 9:44 
    GeneralSDI app Pin
    Kevin Smith23-Aug-02 8:52
    sussKevin Smith23-Aug-02 8:52 
    GeneralCan't detect double click Pin
    hierro30-Nov-01 3:17
    memberhierro30-Nov-01 3:17 
    GeneralRe: Can't detect double click Pin
    Roger Allen16-Apr-02 6:25
    memberRoger Allen16-Apr-02 6:25 
    GeneralAn easier way... Pin
    R5-Aug-02 5:48
    memberR5-Aug-02 5:48 

    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.

    Permalink | Advertise | Privacy | Terms of Use | Mobile
    Web01 | 2.8.180417.1 | Last Updated 6 Jan 2000
    Article Copyright 2000 by Chris Maunder, Mark Findlay
    Everything else Copyright © CodeProject, 1999-2018
    Layout: fixed | fluid