Registrations are now open. Join us today!
There is still a lot of work to do on the wiki yet! More information about editing can be found here.
Already have an account?

Microsoft KB Archive/172276

From BetaArchive Wiki
Knowledge Base

Article ID: 172276

Article Last Modified on 11/21/2006


  • Microsoft Foundation Class Library 4.2

This article was previously published under Q172276


Applications that use CWnd::EnableTooltips to use a default CToolTipCtrl do not display the tooltip text for child windows after the Visual Studio Service Pack 1 (SP1) or Service Pack 2 (SP2) has been installed.

Other CToolTipCtrls and Tooltips inside of CToolBars work correctly.


The cbSize parameter of the TOOLINFO struct was changed to be of size AfxOldTOOLINFO to be compatible with older versions of the COMCTL32.DLL.

CWnd::OnToolHitTest() was not changed, and is dependent on the cbSize to be equal to the size of the new TOOLINFO struct. Since cbSize is always set to AfxOldTOOLINFO, this function fails.


Override the virtual function CWnd::OnToolHitTest() to take into account the new cbSize value.


Microsoft has confirmed this to be a bug in the Microsoft products listed at the beginning of this article. This bug has been fixed in Visual Studio 97 Service Pack 3.

For more information, please see the following article in the Microsoft Knowledge Base:

170365 INFO: Visual Studio 97 Service Packs - What, Where, and Why


Here is a sample OnToolHitTest() that implements the workaround:

   #include <WTYPES.H>
   #include "..\src\afximpl.h"

   int CSuperTipFormView::OnToolHitTest(CPoint point, TOOLINFO* pTI) const

      HWND hWndChild = NULL;
      // find child window which hits the point
      // (don't use WindowFromPoint, because it ignores disabled windows)
      // see _AfxChildWindowFromPoint(m_hWnd, point);
      ::ClientToScreen(m_hWnd, &point);
      HWND hChild = ::GetWindow(m_hWnd, GW_CHILD);
      for (; hChild != NULL; hChild = ::GetWindow(hChild, GW_HWNDNEXT))
         if (_AfxGetDlgCtrlID(hChild) != (WORD)-1 &&
               (::GetWindowLong(hChild, GWL_STYLE) & WS_VISIBLE))
            // see if point hits the child window
            CRect rect;
            ::GetWindowRect(hChild, rect);
            if (rect.PtInRect(point))
               hWndChild = hChild;

      if (hWndChild != NULL)
         // return positive hit if control ID isn't -1
         int nHit = _AfxGetDlgCtrlID(hWndChild);

         // hits against child windows always center the tip
         if (pTI != NULL && pTI->cbSize >= sizeof(AfxOldTOOLINFO))
            // setup the TOOLINFO structure
            pTI->hwnd = m_hWnd;
            pTI->uId = (UINT)hWndChild;
            pTI->uFlags |= TTF_IDISHWND;
            pTI->lpszText = LPSTR_TEXTCALLBACK;

       // set TTF_NOTBUTTON and TTF_CENTERTIP if it isn't a button
       if (!(::SendMessage(hWndChild, WM_GETDLGCODE, 0, 0) &
               pTI->uFlags |= TTF_NOTBUTTON|TTF_CENTERTIP;
         return nHit;
      return -1;  // not found


For additional information, please see the following article in the Microsoft Knowledge Base:

167650 FIX: Problems with ToolTips on Windows 95

Keywords: kbbug kbfix kbnoupdate kbtooltip kbuidesign kbvs97sp3fix KB172276