CMFCMaskedEdit 類別

發行項
05/16/2015

CMFCMaskedEdit 類別支援一 Masked Edit 控制項、驗證使用者輸入，針對遮罩並根據範本顯示驗證的結果。

class CMFCMaskedEdit : public CEdit

Members

公用建構函式

名稱	描述
CMFCMaskedEdit::CMFCMaskedEdit	預設建構函式。
CMFCMaskedEdit::~CMFCMaskedEdit	解構函式。

公用方法

名稱	描述
CMFCMaskedEdit::DisableMask	驗證使用者輸入的停用。
CMFCMaskedEdit::EnableGetMaskedCharsOnly	指定 GetWindowText 方法是否只擷取遮罩字元。
CMFCMaskedEdit::EnableMask	初始化 Masked Edit 控制項。
CMFCMaskedEdit::EnableSelectByGroup	指定 Masked Edit 控制項是否選取使用者輸入的特定群組，或所有使用者輸入。
CMFCMaskedEdit::EnableSetMaskedCharsOnly	指定文字是否已經驗證只會遮罩字元，或針對整體遮罩。
CMFCMaskedEdit::GetThisClass	由框架以取得指向與這個類別型別的 CRuntimeClass 物件。
CMFCMaskedEdit::GetWindowText	擷取驗證從 Masked Edit 控制項的文字。
CMFCMaskedEdit::SetValidChars	指定使用者可以輸入有效字元的字串。
CMFCMaskedEdit::SetWindowText	顯示在 Masked Edit 控制項的提示。

受保護的方法

名稱	描述
CMFCMaskedEdit::IsMaskedChar	呼叫由架構驗證指定的字元在與對應的遮罩字元。

備註

執行下列步驟 CMFCMaskedEdit 使用控制項在應用程式:

1. 將一 CMFCMaskedEdit 物件插入您的視窗類別。

2. 呼叫方法 CMFCMaskedEdit::EnableMask 指定遮罩。

3. 呼叫方法 CMFCMaskedEdit::SetValidChars 指定有效的字元清單。

4. 呼叫方法以 CMFCMaskedEdit::SetWindowText Masked Edit 控制項指定預設文字。

5. 呼叫方法 CMFCMaskedEdit::GetWindowText 擷取驗證的文字。

如果您未呼叫一或多個方法初始化遮罩、有效字元和預設文字， Masked Edit 控制項的行為就像標準的編輯控制項的行為。

範例

下列範例會示範如何設定遮罩 (例如電話號碼) 使用方法建立 EnableMask Masked Edit 控制項、 SetValidChars 方法指定使用者可以輸入有效字元的字串和 SetWindowText 方法的遮罩可以顯示 Masked Edit 控制項的提示。這個範例是新的控制項範例的一部分。

    CMFCMaskedEdit m_wndMaskEdit1;
    CMFCMaskedEdit m_wndMaskEdit2;
    CMFCMaskedEdit m_wndMaskEdit3;
    CMFCMaskedEdit m_wndMaskEdit4;
    CMFCMaskedEdit m_wndMaskEdit5;

    CString m_strValue1;
    CString m_strValue2;
    CString m_strValue3;
    CString m_strValue4;
    CString m_strValue5;


...


BOOL CPage4::OnInitDialog()
{
    CMFCPropertyPage::OnInitDialog();

    // Mask 1: phone number
    m_wndMaskEdit1.EnableMask(_T(" ddd  ddd dddd"), // The mask string
        _T("(___) ___-____"), // Literal, "_" char = character entry
        _T(' ')); // Default char
    m_wndMaskEdit1.SetValidChars(NULL); // Valid string characters
    m_wndMaskEdit1.SetWindowText(_T("(123) 123-1212"));

    // Mask 2: State, Zip Code
    m_wndMaskEdit2.EnableMask(_T("       cc       ddddd-dddd"), // The mask string
        _T("State: __, Zip: _____-____"), // Literal, "_" char = character entry
        _T(' ')); // Backspace replace char
    m_wndMaskEdit2.SetValidChars(NULL); // Valid string characters
    m_wndMaskEdit2.SetWindowText(_T("State: NY, Zip: 12345-6789"));
    // Mask 3: serial code
    m_wndMaskEdit3.EnableMask(_T("     AAAA AAAA AAAA AAAA"), // The mask string
        _T("S/N: ____-____-____-____"), // Literal, "_" char = character entry
        _T('_')); // Backspace replace char
    m_wndMaskEdit3.SetValidChars(NULL); // Valid string characters
    m_wndMaskEdit3.SetWindowText(_T("S/N: FPR5-5678-1234-8765"));

    // Mask 4: 0xFFFF
    m_wndMaskEdit4.EnableMask(_T("  AAAA"), // The mask string
        _T("0x____"), // Literal, "_" char = character entry
        _T('_')); // Backspace replace char
    m_wndMaskEdit4.SetValidChars(_T("1234567890ABCDEFabcdef")); // Valid string characters
    m_wndMaskEdit4.SetWindowText(_T("0x01AF"));

    // Mask 5: digits only
    m_wndMaskEdit5.DisableMask(); // Don't use the mask
    m_wndMaskEdit5.SetValidChars(_T("1234567890")); // Valid string characters
    m_wndMaskEdit5.SetWindowText(_T("1234567890"));
    
    return TRUE;  // return TRUE unless you set the focus to a control
}

void CPage4::OnButtonGet()
{
    m_wndMaskEdit1.GetWindowText(m_strValue1);
    m_wndMaskEdit2.GetWindowText(m_strValue2);
    m_wndMaskEdit3.GetWindowText(m_strValue3);
    m_wndMaskEdit4.GetWindowText(m_strValue4);
    m_wndMaskEdit5.GetWindowText(m_strValue5);
    UpdateData(FALSE);
}