給 Edit Ctrl 添加 Inner Prompt 功能

WindowsLive Messenger 9 密碼輸入框在沒有輸入密碼的時候, 框內會出現"請輸入密碼"的淺灰提示, 我把這個提示稱之為Inner Prompt.  之前我喜歡把輸入提示放置于Tooltips中. 現在看來 , Inner Prompt也是不錯的選擇, 它的開銷更小.

如何實現 Inner Prompt?

很簡單, 用"繼承"大法, 寫一個派生類重載OnPaint就能輕易實現這一功能( 事實上已經有人實現了 XEditPrompt - CEdit-derived control with web-like prompt ), 但問題在於, 我已經用到了好幾個派生于CEdit的類-- CFloatEdit / CFilterEdit ...... Oh............我可不想繼續派生下去, 不想再寫一大堆的Class.

是的, 繼承/派生不是解決問題的唯一途徑, 我們有其他辦法, 我們有更通用/更簡潔/更優雅的解決方案.

代碼比口水更能說明問題:
EditHelper.h
// EditHelper.h, ver 0.1 // Hutu_cn, 2008-7-12 // #pragma once class CEditHelper { CString m_strInnerPrompt; HWND m_hWnd; WNDPROC m_wndprocOld; static LRESULT CALLBACK HelperWindowProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam); public: CEditHelper(void); virtual ~CEditHelper(void); BOOL Attach(HWND hWnd); BOOL Detatch(); void SetInnerPrompt(const CString & strInnerPrompt) {m_strInnerPrompt = strInnerPrompt;} protected: virtual LRESULT PaintX(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam); };
EditHelper.cpp

// EditHelper.cpp, ver 0.1 // Hutu_cn, 2008-7-13 // #include "StdAfx.h" #include "EditHelper.h" const TCHAR PROP_EDITHELPER[] = _T("Inner Prompt Edit Ctrl Helper Instance"); CEditHelper::CEditHelper(void) { m_hWnd = NULL; m_wndprocOld = NULL; m_strInnerPrompt = _T(""); } CEditHelper::~CEditHelper(void) { Detatch(); } BOOL CEditHelper::Attach(HWND hWnd) { BOOL bRet = FALSE; if (::IsWindow(hWnd) && m_wndprocOld == NULL) { if (SetProp(hWnd, PROP_EDITHELPER, this)) { m_wndprocOld = (WNDPROC)SetWindowLong(hWnd, GWL_WNDPROC, (LONG)HelperWindowProc); if (m_wndprocOld) { m_hWnd = hWnd; bRet = TRUE; } } } return bRet; } BOOL CEditHelper::Detatch() { BOOL bRet = FALSE; if (m_wndprocOld!= NULL && m_hWnd != NULL && ::IsWindow(m_hWnd)) { if (SetWindowLong(m_hWnd, GWL_WNDPROC, (LONG)m_wndprocOld) == (LONG)HelperWindowProc) { RemoveProp(m_hWnd, PROP_EDITHELPER); m_wndprocOld = NULL; m_hWnd = NULL; bRet = TRUE; } } return bRet; } LRESULT CEditHelper::HelperWindowProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam) { LRESULT result = 0; CEditHelper * pThis = (CEditHelper *)GetProp(hWnd, PROP_EDITHELPER); if (pThis) { if (uMsg == WM_PAINT) { result = pThis->PaintX(hWnd, uMsg, wParam,lParam); } else result = CallWindowProc(pThis->m_wndprocOld, hWnd, uMsg, wParam,lParam); } else result = DefWindowProc( hWnd, uMsg, wParam, lParam); return result; } LRESULT CEditHelper::PaintX(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam) { LRESULT result = 0; CWnd *pWnd = CWnd::FromHandle(hWnd); CString strText; pWnd->GetWindowText(strText); int nLen = m_strInnerPrompt.GetLength(); if (strText.IsEmpty() && nLen >0) { // Draw Inner Prompt CPaintDC dc(pWnd); CRect rect; pWnd->GetClientRect(&rect); dc.FillSolidRect(&rect, RGB(255,255,255)); COLORREF color = dc.GetTextColor(); dc.SetTextColor(RGB(200,200,200)); dc.DrawText(m_strInnerPrompt, nLen, &rect, DT_LEFT|DT_VCENTER); dc.SetTextColor(color); result = 1; } else result = CallWindowProc(this->m_wndprocOld, hWnd, uMsg, wParam,lParam); return result; }

CEditHelper的關鍵之處在於通過窗口屬性 保存/獲取 實例的 "this" 指針, 然後攔截指定的消息 WM_PAINT繪製 Inner Prompt. 當然, 你也可攔截其他消息,做更多的事情.

上面的 PaintX很粗糙, 也許你有更好想法, 比如你還可給帶有ES_PASSWORD風格的Edit Ctrl添加隨密碼強度變色的功能, 等等等等......

你也許覺得 Attach/SetInnerPrompt 不夠乾淨俐落, 嗯, 把這2個函數合併到構造函數中去也是個不錯的主意.

如何使用?

  直接 Attach需要設置Inner Prompt的EditCtrl, 然後 SetInnerPrompt 即可, 不用對原來的 CFilterEdit/CEdit/CFloatEdit等對象做任何修改.

  需要注意的是, CEditHelper對象的生存期

例子:

---

#pragma once
class CEditHelper;

// CTestDlg dialog
class CTestDlg : public CDialog
{
    CEditHelper * m_pHelper1;
    CEditHelper * m_pHelper2;

 

    ......

};

---

CTestDlg::CTestDlg(CWnd* pParent /*=NULL*/)
    : CDialog(CTestDlg::IDD, pParent)
{
    ......

    m_pHelper1 = NULL;
    m_pHelper2 = NULL;
}

BOOL CTestDlg::OnInitDialog()
{
    CDialog::OnInitDialog();

    // TODO: Add extra initialization here

    ......
    // 喔, 原來ComboBox也可以的!!! 如果使用"繼承"大法, 我該怎麼辦?!
    m_pHelper1 = new CEditHelper;
    m_pHelper1->Attach(GetDlgItem(IDC_COMBO1)->GetDlgItem(1001)->m_hWnd);
    m_pHelper1->SetInnerPrompt(_T("<Please Select>"));

    m_pHelper2 = new CEditHelper;
    m_pHelper2->Attach(GetDlgItem(IDC_EDIT2)->m_hWnd);
    m_pHelper2->SetInnerPrompt(_T("note: value must be beteen 2 and 98"));

    return TRUE;  // return TRUE  unless you set the focus to a control
}

void CTestDlg::OnDestroy()
{
    CDialog::OnDestroy();

    // TODO: Add your message handler code here
    ......

    if (m_pHelper1)
    {
        delete m_pHelper1;
        m_pHelper1 = NULL;
    }

    if (m_pHelper2)
    {
        delete pHelper2;
        m_pHelper1 = NULL;
    }
}