src/Utils/MiscUI/Tooltip.cpp

   1 // TortoiseGit - a Windows shell extension for easy version control
   2
   3 // Copyright (C) 2011 - Sven Strickroth <email@cs-ware.de>
   4 // Copyright (C) 2008-2012 - TortoiseSVN
   5
   6 // This program is free software; you can redistribute it and/or
   7 // modify it under the terms of the GNU General Public License
   8 // as published by the Free Software Foundation; either version 2
   9 // of the License, or (at your option) any later version.
  10
  11 // This program is distributed in the hope that it will be useful,
  12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 // GNU General Public License for more details.
  15
  16 // You should have received a copy of the GNU General Public License
  17 // along with this program; if not, write to the Free Software Foundation,
  18 // 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  19 //
  20
  21 #include "stdafx.h"
  22 #include "Tooltip.h"
  23
  24
  25 BEGIN_MESSAGE_MAP(CToolTips, CToolTipCtrl)
  26         ON_NOTIFY_REFLECT_EX( TTN_NEEDTEXT, &CToolTips::OnTtnNeedText )
  27 END_MESSAGE_MAP()
  28
  29
  30
  31 BOOL CToolTips::OnTtnNeedText(NMHDR *pNMHDR, LRESULT *pResult)
  32 {
  33         if (pNMHDR->code == TTN_NEEDTEXTW)
  34         {
  35                 LPNMTTDISPINFO lpnmtdi = (LPNMTTDISPINFO)pNMHDR;
  36                 UINT_PTR nID = pNMHDR->idFrom;
  37
  38                 if (lpnmtdi->uFlags & TTF_IDISHWND)
  39                 {
  40                         // idFrom is actually the HWND of the tool
  41                         nID = ::GetDlgCtrlID((HWND)nID);
  42                 }
  43                 if (toolTextMap.find((unsigned int)nID) != toolTextMap.end())
  44                 {
  45                         lpnmtdi->lpszText = (LPTSTR)(LPCTSTR)(CString)toolTextMap[(unsigned int)nID];
  46                         lpnmtdi->hinst = AfxGetResourceHandle();
  47                         *pResult = 0;
  48                         return TRUE;
  49                 }
  50         }
  51         return FALSE;
  52 }
  53
  54 BOOL CToolTips::AddTool(CWnd* pWnd, UINT nIDText, LPCRECT lpRectTool /* = NULL */, UINT_PTR nIDTool /* = 0 */)
  55 {
  56         CString sTemp = LoadTooltip(nIDText);
  57         toolTextMap[::GetDlgCtrlID(pWnd->GetSafeHwnd())] = sTemp;
  58         return CToolTipCtrl::AddTool(pWnd, LPSTR_TEXTCALLBACK, lpRectTool, nIDTool);
  59 }
  60
  61 BOOL CToolTips::AddTool(CWnd* pWnd, LPCTSTR lpszText /* = LPSTR_TEXTCALLBACK */, LPCRECT lpRectTool /* = NULL */, UINT_PTR nIDTool /* = 0 */)
  62 {
  63         if (lpszText != LPSTR_TEXTCALLBACK)
  64                 toolTextMap[::GetDlgCtrlID(pWnd->GetSafeHwnd())] = CString(lpszText);
  65         return CToolTipCtrl::AddTool(pWnd, lpszText, lpRectTool, nIDTool);
  66 }
  67
  68 void CToolTips::AddTool(int nIdWnd, UINT nIdText, LPCRECT lpRectTool /* = NULL */, UINT_PTR nIDTool /* = 0 */)
  69 {
  70         AddTool(((CDialog*)m_pParentWnd)->GetDlgItem(nIdWnd), nIdText, lpRectTool, nIDTool);
  71 }
  72
  73 void CToolTips::AddTool(int nIdWnd, CString sBalloonTipText, LPCRECT lpRectTool /* = NULL */, UINT_PTR nIDTool /* = 0 */)
  74 {
  75         AddTool(((CDialog*)m_pParentWnd)->GetDlgItem(nIdWnd), sBalloonTipText, lpRectTool, nIDTool);
  76 }
  77
  78 void CToolTips::DelTool( CWnd* pWnd, UINT_PTR nIDTool /* = 0 */)
  79 {
  80         toolTextMap.erase(::GetDlgCtrlID(pWnd->GetSafeHwnd()));
  81         return CToolTipCtrl::DelTool(pWnd, nIDTool);
  82 }
  83
  84 void CToolTips::DelTool( int nIdWnd, UINT_PTR nIDTool /* = 0 */)
  85 {
  86         return DelTool(((CDialog*)m_pParentWnd)->GetDlgItem(nIdWnd), nIDTool);
  87 }
  88
  89 BOOL CToolTips::ShowBalloon(CWnd *pWnd, UINT nIDText, UINT nIDTitle, UINT icon /* = 0 */)
  90 {
  91         CString sTemp = LoadTooltip(nIDText);
  92
  93         const HWND hwndTT = CreateWindow
  94                 (
  95                 TOOLTIPS_CLASS,
  96                 _T(""),
  97                 TTS_NOPREFIX|TTS_BALLOON|TTS_ALWAYSTIP|TTS_CLOSE,
  98                 CW_USEDEFAULT, CW_USEDEFAULT,
  99                 CW_USEDEFAULT, CW_USEDEFAULT,
 100                 pWnd->GetSafeHwnd(),
 101                 NULL,
 102                 NULL,
 103                 NULL
 104                 );
 105         if (hwndTT == NULL)
 106                 return FALSE;
 107
 108         TOOLINFO ti = { 0 };
 109         ti.cbSize = sizeof(ti);
 110         ti.uFlags = TTF_TRACK | TTF_IDISHWND | TTF_PARSELINKS;
 111         ti.hwnd = pWnd->GetSafeHwnd();
 112         ti.lpszText = sTemp.GetBuffer();
 113         ::SendMessage(hwndTT, TTM_ADDTOOL, 0, (LPARAM)&ti);
 114         ::SendMessage(hwndTT, TTM_SETTITLE, icon, (LPARAM)(LPCTSTR)CString(MAKEINTRESOURCE(nIDTitle)));
 115         ::SendMessage(hwndTT, TTM_SETMAXTIPWIDTH, 0, 800);
 116
 117         // Position the tooltip below the control
 118         RECT rc;
 119         ::GetWindowRect(pWnd->GetSafeHwnd(), &rc);
 120         ::SendMessage(hwndTT, TTM_TRACKPOSITION, 0, MAKELONG(rc.left + 10, rc.bottom));
 121
 122         // Show the tooltip
 123         ::SendMessage(hwndTT, TTM_TRACKACTIVATE, TRUE, (LPARAM)&ti);
 124
 125         return TRUE;
 126 }
 127
 128 void CToolTips::ShowBalloon(int nIdWnd, UINT nIdText, UINT nIDTitle, UINT icon /* = 0 */)
 129 {
 130         ShowBalloon(((CDialog*)m_pParentWnd)->GetDlgItem(nIdWnd), nIdText, nIDTitle, icon);
 131 }
 132
 133 CString CToolTips::LoadTooltip( UINT nIDText )
 134 {
 135         CString sTemp;
 136         sTemp.LoadString(nIDText);
 137         // tooltips can't handle \t and single \n, only spaces and \r\n
 138         sTemp.Replace('\t', ' ');
 139         sTemp.Replace(_T("\r\n"), _T("\n"));
 140         sTemp.Replace(_T("\n"), _T("\r\n"));
 141         return sTemp;
 142 }
 143
 144 void CToolTips::RelayEvent(LPMSG lpMsg, CWnd * dlgWnd)
 145 {
 146         if(dlgWnd && ((lpMsg->message == WM_MOUSEMOVE) || (lpMsg->message == WM_NCMOUSEMOVE)) && (lpMsg->hwnd == dlgWnd->m_hWnd))
 147         {
 148                 // allow tooltips for disabled controls
 149                 CRect  rect;
 150                 POINT  pt;
 151
 152                 pt.x = LOWORD(lpMsg->lParam);
 153                 pt.y = HIWORD(lpMsg->lParam);
 154
 155                 for (std::map<UINT, CString>::iterator it = toolTextMap.begin(); it != toolTextMap.end(); ++it)
 156                 {
 157                         CWnd * pWndCtrl = dlgWnd->GetDlgItem(it->first);
 158                         pWndCtrl->GetWindowRect(&rect);
 159                         if (lpMsg->message == WM_MOUSEMOVE)
 160                                 dlgWnd->ScreenToClient(&rect);
 161
 162                         if(rect.PtInRect(pt) )
 163                         {
 164                                 // save the original parameters
 165                                 HWND origHwnd = lpMsg->hwnd;
 166                                 LPARAM origLParam = lpMsg->lParam;
 167
 168                                 // translate and relay the mouse move message to
 169                                 // the tooltip control as if they were sent
 170                                 // by the disabled control
 171                                 lpMsg->hwnd = pWndCtrl->m_hWnd;
 172
 173                                 if (lpMsg->message == WM_MOUSEMOVE)
 174                                         dlgWnd->ClientToScreen(&pt);
 175                                 pWndCtrl->ScreenToClient(&pt);
 176                                 lpMsg->lParam = MAKELPARAM(pt.x, pt.y);
 177
 178                                 __super::RelayEvent(lpMsg);
 179
 180                                 // restore the original parameters
 181                                 lpMsg->hwnd = origHwnd;
 182                                 lpMsg->lParam = origLParam;
 183                                 return;
 184                         }
 185                 }
 186         }
 187
 188         // Let the ToolTip process this message.
 189         __super::RelayEvent(lpMsg);
 190 }