Cleanup

[TortoiseGit.git] / src / Utils / MiscUI / StandAloneDlg.h

// TortoiseGit - a Windows shell extension for easy version control

// Copyright (C) 2003-2008 - TortoiseSVN

// This program is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public License
// as published by the Free Software Foundation; either version 2
// of the License, or (at your option) any later version.

// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.

// You should have received a copy of the GNU General Public License
// along with this program; if not, write to the Free Software Foundation,
// 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
//
#pragma once

#include "ResizableDialog.h"

#pragma comment(lib, "htmlhelp.lib")

/**
 * \ingroup TortoiseProc
 *
 * A template which can be used as the base-class of dialogs which form the main dialog
 * of a 'dialog-style application'
 * Just provides the boiler-plate code for dealing with application icons
 *
 * \remark Replace all references to CDialog or CResizableDialog in your dialog class with
 * either CResizableStandAloneDialog, CStandAloneDialog or CStateStandAloneDialog, as appropriate
 */
template <typename BaseType> class CStandAloneDialogTmpl : public BaseType
{
protected:
        CStandAloneDialogTmpl(UINT nIDTemplate, CWnd* pParentWnd = NULL) : BaseType(nIDTemplate, pParentWnd)
        {
                m_hIcon = AfxGetApp()->LoadIcon(IDR_MAINFRAME);
        }
        virtual BOOL OnInitDialog()
        {
                BaseType::OnInitDialog();

                // Set the icon for this dialog.  The framework does this automatically
                //  when the application's main window is not a dialog
                SetIcon(m_hIcon, TRUE);                 // Set big icon
                SetIcon(m_hIcon, FALSE);                // Set small icon

                return FALSE;
        }

        virtual BOOL PreTranslateMessage(MSG* pMsg)
        {
                if (pMsg->message == WM_KEYDOWN)
                {
                        int nVirtKey = (int) pMsg->wParam;

                        if (nVirtKey == 'A' && (GetKeyState(VK_CONTROL) & 0x8000 ) )
                        {
                                TCHAR buffer[129];
                                ::GetClassName(pMsg->hwnd, buffer,128);

                                if(_tcsnicmp(buffer,_T("EDIT"),128) == 0)
                                {
                                        ::PostMessage(pMsg->hwnd,EM_SETSEL,0,-1);
                                        return TRUE;
                                }
                        }
                }
                return BaseType::PreTranslateMessage(pMsg);
        }
        afx_msg void OnPaint()
        {
                if (IsIconic())
                {
                        CPaintDC dc(this); // device context for painting

                        SendMessage(WM_ICONERASEBKGND, reinterpret_cast<WPARAM>(dc.GetSafeHdc()), 0);

                        // Center icon in client rectangle
                        int cxIcon = GetSystemMetrics(SM_CXICON);
                        int cyIcon = GetSystemMetrics(SM_CYICON);
                        CRect rect;
                        GetClientRect(&rect);
                        int x = (rect.Width() - cxIcon + 1) / 2;
                        int y = (rect.Height() - cyIcon + 1) / 2;

                        // Draw the icon
                        dc.DrawIcon(x, y, m_hIcon);
                }
                else
                {
                        BaseType::OnPaint();
                }
        }
        /**
         * Wrapper around the CWnd::EnableWindow() method, but
         * makes sure that a control that has the focus is not disabled
         * before the focus is passed on to the next control.
         */
        BOOL DialogEnableWindow(UINT nID, BOOL bEnable)
        {
                CWnd * pwndDlgItem = GetDlgItem(nID);
                if (pwndDlgItem == NULL)
                        return FALSE;
                if (bEnable)
                        return pwndDlgItem->EnableWindow(bEnable);
                if (GetFocus() == pwndDlgItem)
                {
                        SendMessage(WM_NEXTDLGCTL, 0, FALSE);
                }
                return pwndDlgItem->EnableWindow(bEnable);
        }

        /**
         * Adjusts the size of a checkbox or radio button control.
         * Since we always make the size of those bigger than 'necessary'
         * for making sure that translated strings can fit in those too,
         * this method can reduce the size of those controls again to only
         * fit the text.
         */
        RECT AdjustControlSize(UINT nID)
        {
                CWnd * pwndDlgItem = GetDlgItem(nID);
                // adjust the size of the control to fit its content
                CString sControlText;
                pwndDlgItem->GetWindowText(sControlText);
                // next step: find the rectangle the control text needs to
                // be displayed

                CDC * pDC = pwndDlgItem->GetWindowDC();
                RECT controlrect;
                RECT controlrectorig;
                pwndDlgItem->GetWindowRect(&controlrect);
                ::MapWindowPoints(NULL, GetSafeHwnd(), (LPPOINT)&controlrect, 2);
                controlrectorig = controlrect;
                if (pDC)
                {
                        CFont * font = pwndDlgItem->GetFont();
                        CFont * pOldFont = pDC->SelectObject(font);
                        if (pDC->DrawText(sControlText, -1, &controlrect, DT_WORDBREAK | DT_EDITCONTROL | DT_EXPANDTABS | DT_LEFT | DT_CALCRECT))
                        {
                                // now we have the rectangle the control really needs
                                if ((controlrectorig.right - controlrectorig.left) > (controlrect.right - controlrect.left))
                                {
                                        // we're dealing with radio buttons and check boxes,
                                        // which means we have to add a little space for the checkbox
                                        // the value of 3 pixels added here is necessary in case certain visual styles have
                                        // been disabled. Without this, the width is calculated too short.
                                        const int checkWidth = GetSystemMetrics(SM_CXMENUCHECK) + 2*GetSystemMetrics(SM_CXEDGE) + 3;
                                        controlrectorig.right = controlrectorig.left + (controlrect.right - controlrect.left) + checkWidth;
                                        pwndDlgItem->MoveWindow(&controlrectorig);
                                }
                        }
                        pDC->SelectObject(pOldFont);
                        ReleaseDC(pDC);
                }
                return controlrectorig;
        }

        /**
        * Adjusts the size of a static control.
        * \param rc the position of the control where this control shall
        *           be positioned next to on its right side.
        * \param spacing number of pixels to add to rc.right
        */
        RECT AdjustStaticSize(UINT nID, RECT rc, long spacing)
        {
                CWnd * pwndDlgItem = GetDlgItem(nID);
                // adjust the size of the control to fit its content
                CString sControlText;
                pwndDlgItem->GetWindowText(sControlText);
                // next step: find the rectangle the control text needs to
                // be displayed

                CDC * pDC = pwndDlgItem->GetWindowDC();
                RECT controlrect;
                RECT controlrectorig;
                pwndDlgItem->GetWindowRect(&controlrect);
                ::MapWindowPoints(NULL, GetSafeHwnd(), (LPPOINT)&controlrect, 2);
                controlrect.right += 200;   // in case the control needs to be bigger than it currently is (e.g., due to translations)
                controlrectorig = controlrect;

                long height = controlrectorig.bottom-controlrectorig.top;
                long width = controlrectorig.right-controlrectorig.left;
                controlrectorig.left = rc.right + spacing;
                controlrectorig.right = controlrectorig.left + width;
                controlrectorig.bottom = rc.bottom;
                controlrectorig.top = controlrectorig.bottom - height;

                if (pDC)
                {
                        CFont * font = pwndDlgItem->GetFont();
                        CFont * pOldFont = pDC->SelectObject(font);
                        if (pDC->DrawText(sControlText, -1, &controlrect, DT_WORDBREAK | DT_EDITCONTROL | DT_EXPANDTABS | DT_LEFT | DT_CALCRECT))
                        {
                                // now we have the rectangle the control really needs
                                controlrectorig.right = controlrectorig.left + (controlrect.right - controlrect.left);
                                pwndDlgItem->MoveWindow(&controlrectorig);
                        }
                        pDC->SelectObject(pOldFont);
                        ReleaseDC(pDC);
                }
                return controlrectorig;
        }

        /**
         * Display a balloon with close button, anchored at a given edit control on this dialog.
         */
        void ShowEditBalloon(UINT nIdControl, UINT nIdText, UINT nIdTitle, int nIcon = TTI_WARNING)
        {
                CString text(MAKEINTRESOURCE(nIdText));
                CString title(MAKEINTRESOURCE(nIdTitle));
                ShowEditBalloon(nIdControl, text, title, nIcon);
        }
        void ShowEditBalloon(UINT nIdControl, const CString& text, const CString& title, int nIcon = TTI_WARNING)
        {
                EDITBALLOONTIP bt;
                bt.cbStruct = sizeof(bt);
                bt.pszText  = text;
                bt.pszTitle = title;
                bt.ttiIcon = nIcon;
                SendDlgItemMessage(nIdControl, EM_SHOWBALLOONTIP, 0, (LPARAM)&bt);
        }

        /**
         * Refreshes the cursor by forcing a WM_SETCURSOR message.
         */
        void RefreshCursor()
        {
                POINT pt;
                GetCursorPos(&pt);
                SetCursorPos(pt.x, pt.y);
        }
private:
        HCURSOR OnQueryDragIcon()
        {
                return static_cast<HCURSOR>(m_hIcon);
        }

        virtual void HtmlHelp(DWORD_PTR dwData, UINT nCmd = 0x000F)
        {
                CWinApp* pApp = AfxGetApp();
                ASSERT_VALID(pApp);
                ASSERT(pApp->m_pszHelpFilePath != NULL);
                // to call HtmlHelp the m_fUseHtmlHelp must be set in
                // the application's constructor
                ASSERT(pApp->m_eHelpType == afxHTMLHelp);

                CWaitCursor wait;

                PrepareForHelp();
                // run the HTML Help engine
                if (!::HtmlHelp(m_hWnd, pApp->m_pszHelpFilePath, nCmd, dwData))
                {
                        AfxMessageBox(AFX_IDP_FAILED_TO_LAUNCH_HELP);
                }
        }


        HICON m_hIcon;
};

class CStateDialog : public CDialog, public CResizableWndState
{
public:
        CStateDialog()
        : m_bEnableSaveRestore(false)
        , m_bRectOnly(false)
        {}
        CStateDialog(UINT /*nIDTemplate*/, CWnd* /*pParentWnd = NULL*/)
        : m_bEnableSaveRestore(false)
        , m_bRectOnly(false)
        {}
        CStateDialog(LPCTSTR /*lpszTemplateName*/, CWnd* /*pParentWnd = NULL*/)
        : m_bEnableSaveRestore(false)
        , m_bRectOnly(false)
        {}
        virtual ~CStateDialog();

private:
        // flags
        bool m_bEnableSaveRestore;
        bool m_bRectOnly;

        // internal status
        CString m_sSection;                     // section name (identifies a parent window)

protected:
        // section to use in app's profile
        void EnableSaveRestore(LPCTSTR pszSection, bool bRectOnly = FALSE)
        {
                m_sSection = pszSection;

                m_bEnableSaveRestore = true;
                m_bRectOnly = bRectOnly;

                // restore immediately
                LoadWindowRect(pszSection, bRectOnly);
        };

        virtual CWnd* GetResizableWnd() const
        {
                // make the layout know its parent window
                return CWnd::FromHandle(m_hWnd);
        };

        afx_msg void OnDestroy()
        {
                if (m_bEnableSaveRestore)
                        SaveWindowRect(m_sSection, m_bRectOnly);
                CDialog::OnDestroy();
        };

        DECLARE_MESSAGE_MAP()

};

class CResizableStandAloneDialog : public CStandAloneDialogTmpl<CResizableDialog>
{
public:
        CResizableStandAloneDialog(UINT nIDTemplate, CWnd* pParentWnd = NULL);

private:
        DECLARE_DYNAMIC(CResizableStandAloneDialog)

protected:
        afx_msg void    OnSizing(UINT fwSide, LPRECT pRect);
        afx_msg void    OnMoving(UINT fwSide, LPRECT pRect);
        afx_msg void    OnNcMButtonUp(UINT nHitTest, CPoint point);
        afx_msg void    OnNcRButtonUp(UINT nHitTest, CPoint point);

        DECLARE_MESSAGE_MAP()

private:
        bool            m_bVertical;
        bool            m_bHorizontal;
        CRect           m_rcOrgWindowRect;
};

typedef CStandAloneDialogTmpl<CDialog> CStandAloneDialog;
typedef CStandAloneDialogTmpl<CStateDialog> CStateStandAloneDialog;