CMFCMaskedEdit 클래스

아티클
02/21/2013

CMFCMaskedEdit 클래스는 마스크에 대 한 사용자 입력의 유효성을 검사 하 고 검증된 결과 템플릿에 따라 표시 된 masked edit 컨트롤을 지원 합니다.

class CMFCMaskedEdit : public CEdit

Members

Public 생성자

Name	설명
CMFCMaskedEdit::CMFCMaskedEdit	기본 생성자입니다.
CMFCMaskedEdit::~CMFCMaskedEdit	소멸자.

Public 메서드

Name	설명
CMFCMaskedEdit::DisableMask	사용자 입력 유효성 검사를 비활성화 합니다.
CMFCMaskedEdit::EnableGetMaskedCharsOnly	지정 여부는 GetWindowText 메서드는 마스크 된 문자만 검색 합니다.
CMFCMaskedEdit::EnableMask	초기화는 masked 컨트롤 편집.
CMFCMaskedEdit::EnableSelectByGroup	Masked edit 컨트롤의 입력, 사용자 또는 모든 사용자 입력의 특정 그룹을 선택할지 여부를 지정 합니다.
CMFCMaskedEdit::EnableSetMaskedCharsOnly	텍스트에 문자를 마스크에 유효 여부에 대 한 전체 마스크를 지정 합니다.
CMFCMaskedEdit::GetThisClass	프레임 워크에서 사용 되는 포인터를 얻을 수 있는 CRuntimeClass 이 클래스 형식에 연결 된 개체입니다.
CMFCMaskedEdit::GetWindowText	Masked edit 컨트롤에서 텍스트의 유효성을 검색 합니다.
CMFCMaskedEdit::SetValidChars	사용자가 입력할 수 있는 유효한 문자의 문자열을 지정 합니다.
CMFCMaskedEdit::SetWindowText	Masked edit 컨트롤에 표시 됩니다.

Protected 메서드

Name	설명
CMFCMaskedEdit::IsMaskedChar	지정 된 문자가 해당 마스크 문자에 대해 유효성을 검사 하는 프레임 워크에서 호출 합니다.

설명

사용 하려면 다음 단계를 수행의 CMFCMaskedEdit 응용 프로그램에서 제어:

1.포함 된 CMFCMaskedEdit 창 클래스에 대 한 개체.

2.호출 하는 CMFCMaskedEdit::EnableMask 메서드는 마스크를 지정 합니다.

3.호출 하는 CMFCMaskedEdit::SetValidChars 메서드를 사용할 수 있는 문자 목록을 지정 합니다.

4.호출 하는 CMFCMaskedEdit::SetWindowText 메서드는 masked 편집 컨트롤에 대 한 기본 텍스트를 지정 합니다.

5.호출을 CMFCMaskedEdit::GetWindowText 메서드를 유효성 검사 텍스트를 검색 합니다.

단지 표준 편집 컨트롤의 동작에 따라 마스크, 유효한 문자 및 기본 텍스트를 초기화 하는 하나 이상의 메서드를 호출 하지 않으면 masked edit 컨트롤을 작동 합니다.

예제

마스크 (예: 전화 번호)를 사용 하 여 설정 하는 방법 다음 예제는 EnableMask 컨트롤의 masked edit에 대 한 마스크를 만들려면 메서드는 SetValidChars 메서드는 사용자가 입력할 수 있는 유효한 문자의 문자열을 지정할 수 및 SetWindowText 마스크의 프롬프트를 표시 하는 메서드 편집 컨트롤.이 이때의 일부인의 새 컨트롤 샘플.

    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);
}