src/Utils/MiscUI/StandAloneDlg.h

   1 // TortoiseGit - a Windows shell extension for easy version control
   2
   3 // Copyright (C) 2003-2015 - TortoiseSVN
   4
   5 // This program is free software; you can redistribute it and/or
   6 // modify it under the terms of the GNU General Public License
   7 // as published by the Free Software Foundation; either version 2
   8 // of the License, or (at your option) any later version.
   9
  10 // This program is distributed in the hope that it will be useful,
  11 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 // GNU General Public License for more details.
  14
  15 // You should have received a copy of the GNU General Public License
  16 // along with this program; if not, write to the Free Software Foundation,
  17 // 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  18 //
  19 #pragma once
  20
  21 #include "ResizableDialog.h"
  22 #include "TaskbarUUID.h"
  23 #include "Tooltip.h"
  24
  25 #pragma comment(lib, "htmlhelp.lib")
  26
  27 #define DIALOG_BLOCKHORIZONTAL 1
  28 #define DIALOG_BLOCKVERTICAL 2
  29
  30 /**
  31  * \ingroup TortoiseProc
  32  *
  33  * A template which can be used as the base-class of dialogs which form the main dialog
  34  * of a 'dialog-style application'
  35  * Just provides the boiler-plate code for dealing with application icons
  36  *
  37  * \remark Replace all references to CDialog or CResizableDialog in your dialog class with
  38  * either CResizableStandAloneDialog, CStandAloneDialog or CStateStandAloneDialog, as appropriate
  39  */
  40 template <typename BaseType> class CStandAloneDialogTmpl : public BaseType
  41 {
  42 protected:
  43         CStandAloneDialogTmpl(UINT nIDTemplate, CWnd* pParentWnd = NULL) : BaseType(nIDTemplate, pParentWnd)
  44         {
  45                 m_hIcon = AfxGetApp()->LoadIcon(IDR_MAINFRAME);
  46                 m_nResizeBlock = 0;
  47                 m_height = 0;
  48                 m_width = 0;
  49         }
  50         virtual BOOL OnInitDialog()
  51         {
  52                 BaseType::OnInitDialog();
  53
  54                 // Set the icon for this dialog.  The framework does this automatically
  55                 //  when the application's main window is not a dialog
  56                 SetIcon(m_hIcon, TRUE);                 // Set big icon
  57                 SetIcon(m_hIcon, FALSE);                // Set small icon
  58
  59                 RECT rect;
  60                 GetWindowRect(&rect);
  61                 m_height = rect.bottom - rect.top;
  62                 m_width = rect.right - rect.left;
  63                 EnableToolTips();
  64                 m_tooltips.Create(this);
  65
  66                 return FALSE;
  67         }
  68
  69         virtual BOOL PreTranslateMessage(MSG* pMsg)
  70         {
  71                 m_tooltips.RelayEvent(pMsg, this);
  72                 if (pMsg->message == WM_KEYDOWN)
  73                 {
  74                         int nVirtKey = (int) pMsg->wParam;
  75
  76                         if (nVirtKey == 'A' && (GetKeyState(VK_CONTROL) & 0x8000 ) )
  77                         {
  78                                 TCHAR buffer[129];
  79                                 ::GetClassName(pMsg->hwnd, buffer,128);
  80
  81                                 if(_tcsnicmp(buffer,_T("EDIT"),128) == 0)
  82                                 {
  83                                         ::PostMessage(pMsg->hwnd,EM_SETSEL,0,-1);
  84                                         return TRUE;
  85                                 }
  86                         }
  87                 }
  88                 return BaseType::PreTranslateMessage(pMsg);
  89         }
  90         afx_msg void OnPaint()
  91         {
  92                 if (IsIconic())
  93                 {
  94                         CPaintDC dc(this); // device context for painting
  95
  96                         SendMessage(WM_ICONERASEBKGND, reinterpret_cast<WPARAM>(dc.GetSafeHdc()), 0);
  97
  98                         // Center icon in client rectangle
  99                         int cxIcon = GetSystemMetrics(SM_CXICON);
 100                         int cyIcon = GetSystemMetrics(SM_CYICON);
 101                         CRect rect;
 102                         GetClientRect(&rect);
 103                         int x = (rect.Width() - cxIcon + 1) / 2;
 104                         int y = (rect.Height() - cyIcon + 1) / 2;
 105
 106                         // Draw the icon
 107                         dc.DrawIcon(x, y, m_hIcon);
 108                 }
 109                 else
 110                 {
 111                         BaseType::OnPaint();
 112                 }
 113         }
 114         /**
 115          * Wrapper around the CWnd::EnableWindow() method, but
 116          * makes sure that a control that has the focus is not disabled
 117          * before the focus is passed on to the next control.
 118          */
 119         BOOL DialogEnableWindow(UINT nID, BOOL bEnable)
 120         {
 121                 CWnd * pwndDlgItem = GetDlgItem(nID);
 122                 if (pwndDlgItem == NULL)
 123                         return FALSE;
 124                 if (bEnable)
 125                         return pwndDlgItem->EnableWindow(bEnable);
 126                 if (GetFocus() == pwndDlgItem)
 127                 {
 128                         SendMessage(WM_NEXTDLGCTL, 0, FALSE);
 129                 }
 130                 return pwndDlgItem->EnableWindow(bEnable);
 131         }
 132
 133         /**
 134          * Adjusts the size of a checkbox or radio button control.
 135          * Since we always make the size of those bigger than 'necessary'
 136          * for making sure that translated strings can fit in those too,
 137          * this method can reduce the size of those controls again to only
 138          * fit the text.
 139          */
 140         RECT AdjustControlSize(UINT nID)
 141         {
 142                 CWnd * pwndDlgItem = GetDlgItem(nID);
 143                 // adjust the size of the control to fit its content
 144                 CString sControlText;
 145                 pwndDlgItem->GetWindowText(sControlText);
 146                 // next step: find the rectangle the control text needs to
 147                 // be displayed
 148
 149                 CDC * pDC = pwndDlgItem->GetWindowDC();
 150                 RECT controlrect;
 151                 RECT controlrectorig;
 152                 pwndDlgItem->GetWindowRect(&controlrect);
 153                 ::MapWindowPoints(NULL, GetSafeHwnd(), (LPPOINT)&controlrect, 2);
 154                 controlrectorig = controlrect;
 155                 if (pDC)
 156                 {
 157                         CFont * font = pwndDlgItem->GetFont();
 158                         CFont * pOldFont = pDC->SelectObject(font);
 159                         if (pDC->DrawText(sControlText, -1, &controlrect, DT_WORDBREAK | DT_EDITCONTROL | DT_EXPANDTABS | DT_LEFT | DT_CALCRECT))
 160                         {
 161                                 // now we have the rectangle the control really needs
 162                                 if ((controlrectorig.right - controlrectorig.left) > (controlrect.right - controlrect.left))
 163                                 {
 164                                         // we're dealing with radio buttons and check boxes,
 165                                         // which means we have to add a little space for the checkbox
 166                                         // the value of 3 pixels added here is necessary in case certain visual styles have
 167                                         // been disabled. Without this, the width is calculated too short.
 168                                         const int checkWidth = GetSystemMetrics(SM_CXMENUCHECK) + 2*GetSystemMetrics(SM_CXEDGE) + 3;
 169                                         controlrectorig.right = controlrectorig.left + (controlrect.right - controlrect.left) + checkWidth;
 170                                         pwndDlgItem->MoveWindow(&controlrectorig);
 171                                 }
 172                         }
 173                         pDC->SelectObject(pOldFont);
 174                         ReleaseDC(pDC);
 175                 }
 176                 return controlrectorig;
 177         }
 178
 179         /**
 180         * Adjusts the size of a static control.
 181         * \param nID control ID
 182         * \param rc the position of the control where this control shall
 183         *           be positioned next to on its right side.
 184         * \param spacing number of pixels to add to rc.right
 185         */
 186         RECT AdjustStaticSize(UINT nID, RECT rc, long spacing)
 187         {
 188                 CWnd * pwndDlgItem = GetDlgItem(nID);
 189                 // adjust the size of the control to fit its content
 190                 CString sControlText;
 191                 pwndDlgItem->GetWindowText(sControlText);
 192                 // next step: find the rectangle the control text needs to
 193                 // be displayed
 194
 195                 CDC * pDC = pwndDlgItem->GetWindowDC();
 196                 RECT controlrect;
 197                 RECT controlrectorig;
 198                 pwndDlgItem->GetWindowRect(&controlrect);
 199                 ::MapWindowPoints(NULL, GetSafeHwnd(), (LPPOINT)&controlrect, 2);
 200                 controlrect.right += 200;   // in case the control needs to be bigger than it currently is (e.g., due to translations)
 201                 controlrectorig = controlrect;
 202
 203                 long height = controlrectorig.bottom-controlrectorig.top;
 204                 long width = controlrectorig.right-controlrectorig.left;
 205                 controlrectorig.left = rc.right + spacing;
 206                 controlrectorig.right = controlrectorig.left + width;
 207                 controlrectorig.bottom = rc.bottom;
 208                 controlrectorig.top = controlrectorig.bottom - height;
 209
 210                 if (pDC)
 211                 {
 212                         CFont * font = pwndDlgItem->GetFont();
 213                         CFont * pOldFont = pDC->SelectObject(font);
 214                         if (pDC->DrawText(sControlText, -1, &controlrect, DT_WORDBREAK | DT_EDITCONTROL | DT_EXPANDTABS | DT_LEFT | DT_CALCRECT))
 215                         {
 216                                 // now we have the rectangle the control really needs
 217                                 controlrectorig.right = controlrectorig.left + (controlrect.right - controlrect.left);
 218                                 pwndDlgItem->MoveWindow(&controlrectorig);
 219                         }
 220                         pDC->SelectObject(pOldFont);
 221                         ReleaseDC(pDC);
 222                 }
 223                 return controlrectorig;
 224         }
 225
 226         /**
 227          * Display a balloon with close button, anchored at a given edit control on this dialog.
 228          */
 229         void ShowEditBalloon(UINT nIdControl, UINT nIdText, UINT nIdTitle, int nIcon = TTI_WARNING)
 230         {
 231                 CString text(MAKEINTRESOURCE(nIdText));
 232                 CString title(MAKEINTRESOURCE(nIdTitle));
 233                 ShowEditBalloon(nIdControl, text, title, nIcon);
 234         }
 235         void ShowEditBalloon(UINT nIdControl, const CString& text, const CString& title, int nIcon = TTI_WARNING)
 236         {
 237                 EDITBALLOONTIP bt;
 238                 bt.cbStruct = sizeof(bt);
 239                 bt.pszText  = text;
 240                 bt.pszTitle = title;
 241                 bt.ttiIcon = nIcon;
 242                 SendDlgItemMessage(nIdControl, EM_SHOWBALLOONTIP, 0, (LPARAM)&bt);
 243         }
 244
 245         /**
 246          * Refreshes the cursor by forcing a WM_SETCURSOR message.
 247          */
 248         void RefreshCursor()
 249         {
 250                 POINT pt;
 251                 GetCursorPos(&pt);
 252                 SetCursorPos(pt.x, pt.y);
 253         }
 254
 255         void BlockResize(int block)
 256         {
 257                 m_nResizeBlock = block;
 258         }
 259
 260 protected:
 261         CToolTips       m_tooltips;
 262         int                     m_nResizeBlock;
 263         long            m_width;
 264         long            m_height;
 265
 266         DECLARE_MESSAGE_MAP()
 267
 268 private:
 269         HCURSOR OnQueryDragIcon()
 270         {
 271                 return static_cast<HCURSOR>(m_hIcon);
 272         }
 273
 274         virtual void HtmlHelp(DWORD_PTR dwData, UINT nCmd = 0x000F)
 275         {
 276                 CWinApp* pApp = AfxGetApp();
 277                 ASSERT_VALID(pApp);
 278                 ASSERT(pApp->m_pszHelpFilePath != NULL);
 279                 // to call HtmlHelp the m_fUseHtmlHelp must be set in
 280                 // the application's constructor
 281                 ASSERT(pApp->m_eHelpType == afxHTMLHelp);
 282
 283                 CWaitCursor wait;
 284
 285                 PrepareForHelp();
 286                 // run the HTML Help engine
 287                 if (!::HtmlHelp(m_hWnd, pApp->m_pszHelpFilePath, nCmd, dwData))
 288                 {
 289                         AfxMessageBox(AFX_IDP_FAILED_TO_LAUNCH_HELP);
 290                 }
 291         }
 292
 293         afx_msg LRESULT OnTaskbarButtonCreated(WPARAM /*wParam*/, LPARAM /*lParam*/)
 294         {
 295                 SetUUIDOverlayIcon(m_hWnd);
 296                 return 0;
 297         }
 298
 299         HICON m_hIcon;
 300 };
 301
 302 class CStateDialog : public CDialog, public CResizableWndState
 303 {
 304 public:
 305         CStateDialog()
 306         : CDialog()
 307         , m_bEnableSaveRestore(false)
 308         , m_bRectOnly(false)
 309         {}
 310         CStateDialog(UINT nIDTemplate, CWnd* pParentWnd = NULL)
 311         : CDialog(nIDTemplate, pParentWnd)
 312         , m_bEnableSaveRestore(false)
 313         , m_bRectOnly(false)
 314         {}
 315         CStateDialog(LPCTSTR lpszTemplateName, CWnd* pParentWnd = NULL)
 316         : CDialog(lpszTemplateName, pParentWnd)
 317         , m_bEnableSaveRestore(false)
 318         , m_bRectOnly(false)
 319         {}
 320         virtual ~CStateDialog() {};
 321
 322 private:
 323         // flags
 324         bool m_bEnableSaveRestore;
 325         bool m_bRectOnly;
 326
 327         // internal status
 328         CString m_sSection;                     // section name (identifies a parent window)
 329
 330 protected:
 331         // section to use in app's profile
 332         void EnableSaveRestore(LPCTSTR pszSection, bool bRectOnly = FALSE)
 333         {
 334                 m_sSection = pszSection;
 335
 336                 m_bEnableSaveRestore = true;
 337                 m_bRectOnly = bRectOnly;
 338
 339                 // restore immediately
 340                 LoadWindowRect(pszSection, bRectOnly);
 341         };
 342
 343         virtual CWnd* GetResizableWnd() const
 344         {
 345                 // make the layout know its parent window
 346                 return CWnd::FromHandle(m_hWnd);
 347         };
 348
 349         afx_msg void OnDestroy()
 350         {
 351                 if (m_bEnableSaveRestore)
 352                         SaveWindowRect(m_sSection, m_bRectOnly);
 353                 CDialog::OnDestroy();
 354         };
 355
 356         DECLARE_MESSAGE_MAP()
 357
 358 };
 359
 360 class CResizableStandAloneDialog : public CStandAloneDialogTmpl<CResizableDialog>
 361 {
 362 public:
 363         CResizableStandAloneDialog(UINT nIDTemplate, CWnd* pParentWnd = NULL);
 364
 365 private:
 366         DECLARE_DYNAMIC(CResizableStandAloneDialog)
 367
 368 protected:
 369         afx_msg void    OnSizing(UINT fwSide, LPRECT pRect);
 370         afx_msg void    OnMoving(UINT fwSide, LPRECT pRect);
 371         afx_msg void    OnNcMButtonUp(UINT nHitTest, CPoint point);
 372         afx_msg void    OnNcRButtonUp(UINT nHitTest, CPoint point);
 373         afx_msg LRESULT OnNcHitTest(CPoint point);
 374
 375         DECLARE_MESSAGE_MAP()
 376
 377 private:
 378         bool            m_bVertical;
 379         bool            m_bHorizontal;
 380         CRect           m_rcOrgWindowRect;
 381 };
 382
 383 class CStandAloneDialog : public CStandAloneDialogTmpl<CDialog>
 384 {
 385 public:
 386         CStandAloneDialog(UINT nIDTemplate, CWnd* pParentWnd = NULL);
 387 protected:
 388         DECLARE_MESSAGE_MAP()
 389 private:
 390         DECLARE_DYNAMIC(CStandAloneDialog)
 391 };
 392
 393 class CStateStandAloneDialog : public CStandAloneDialogTmpl<CStateDialog>
 394 {
 395 public:
 396         CStateStandAloneDialog(UINT nIDTemplate, CWnd* pParentWnd = NULL);
 397 protected:
 398         DECLARE_MESSAGE_MAP()
 399 private:
 400         DECLARE_DYNAMIC(CStateStandAloneDialog)
 401 };