Klasa CMFCMaskedEdit

Artykuł
02/27/2013

CMFCMaskedEdit Klasy obsługuje formant edycji maskowane sprawdza poprawność danych wejściowych użytkownika przed maski i wyświetla potwierdzonych wyników na podstawie szablonu.

class CMFCMaskedEdit : public CEdit

Członkowie

Publiczne konstruktory

Nazwa	Opis
CMFCMaskedEdit::CMFCMaskedEdit	Konstruktor domyślny.
CMFCMaskedEdit::~CMFCMaskedEdit	Destruktor.

Metody publiczne

Nazwa	Opis
CMFCMaskedEdit::DisableMask	Wyłącza sprawdzanie poprawności danych wejściowych użytkownika.
CMFCMaskedEdit::EnableGetMaskedCharsOnly	Określa, czy GetWindowText metoda pobiera tylko znaki maskowane.
CMFCMaskedEdit::EnableMask	Formant edycji inicjuje maskowane.
CMFCMaskedEdit::EnableSelectByGroup	Określa, czy formant edycji maskowane wybiera poszczególnych grup danych wejściowych użytkownika lub wszystkich danych wejściowych użytkownika.
CMFCMaskedEdit::EnableSetMaskedCharsOnly	Określa, czy tekst jest sprawdzany tylko maskowane znaków lub przeciwko całej maski.
CMFCMaskedEdit::GetThisClass	Używane w ramach uzyskać wskaźnik do CRuntimeClass obiekt, który jest skojarzony z tego typu klasy.
CMFCMaskedEdit::GetWindowText	Pobiera zatwierdzone tekst z maskowane edycyjnym.
CMFCMaskedEdit::SetValidChars	Określa ciąg prawidłowe znaki, które użytkownik może wprowadzić.
CMFCMaskedEdit::SetWindowText	Wyświetla monit w formancie edycyjnym maskowane.

Metody chronione

Nazwa	Opis
CMFCMaskedEdit::IsMaskedChar	Wywołana przez ramy do sprawdzania poprawności określonego znaku w stosunku do odpowiednich znaków maski.

Uwagi

Wykonaj następujące czynności, aby użyć CMFCMaskedEdit kontroli w aplikacji:

1.Osadź CMFCMaskedEdit obiekt klasy okna.

2.Wywołanie CMFCMaskedEdit::EnableMask metodę, aby określić maskę.

3.Wywołanie CMFCMaskedEdit::SetValidChars metodę, aby określić listę prawidłowych znaków.

4.Wywołanie CMFCMaskedEdit::SetWindowText metodę, aby określić domyślny tekst do edycji maskowane.

5.Wywołanie CMFCMaskedEdit::GetWindowText metoda pobierania zatwierdzonych tekstu.

Jeśli nie wymagają jedną lub kilka metod zainicjować maski, prawidłowe znaki i domyślny tekst maskowane edycyjnym zachowuje się tak samo, jak zachowuje się standardowy edycyjnym.

Przykład

Poniższy przykład ilustruje sposób zdefiniować maskę (na przykład numer telefonu) za pomocą EnableMask metody do utworzenia maski dla maskowanego edycji, SetValidChars metodę, aby określić ciąg prawidłowe znaki, które można wprowadzać i SetWindowText formant edycji metodę wyświetlania monitu w maskowane.W tym przykładzie jest częścią nowych formantów próbki.

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