CMFCMaskedEdit-Klasse

Artikel
02/26/2013

Die CMFCMaskedEdit-Klasse unterstützt ein maskiertes Bearbeitungssteuerelement, das Benutzereingaben anhand einer Maske überprüft und die überprüften Ergebnisse anhand einer Vorlage anzeigt.

class CMFCMaskedEdit : public CEdit

Mitglieder

Öffentliche Konstruktoren

Name	Description
CMFCMaskedEdit::CMFCMaskedEdit	Standardkonstruktor.
CMFCMaskedEdit::~CMFCMaskedEdit	Destruktor.

Öffentliche Methoden

Name	Description
CMFCMaskedEdit::DisableMask	Deaktiviert, die Benutzereingaben überprüfen.
CMFCMaskedEdit::EnableGetMaskedCharsOnly	Gibt an, ob die GetWindowText-Methode nur maskierte Zeichen abruft.
CMFCMaskedEdit::EnableMask	Initialisiert das maskierte Bearbeitungssteuerelement.
CMFCMaskedEdit::EnableSelectByGroup	Gibt an, ob das Bearbeitungssteuerelement maskierte bestimmte Gruppen Benutzereingaben auswählt, oder alle Benutzereingaben an.
CMFCMaskedEdit::EnableSetMaskedCharsOnly	Gibt an, ob der Text für nur maskierte Zeichen überprüft wird, oder für die Ganzmaske an.
CMFCMaskedEdit::GetThisClass	Wird vom Framework, um ein Zeiger auf CRuntimeClass-Objekt abzurufen, das diesem Klassentyp zugeordnet ist.
CMFCMaskedEdit::GetWindowText	Retrieves überprüfte Text vom maskierten Bearbeitungssteuerelement.
CMFCMaskedEdit::SetValidChars	Gibt eine Zeichenfolge mit gültigen Zeichen an, die der Benutzer eingeben kann.
CMFCMaskedEdit::SetWindowText	Zeigt eine Eingabeaufforderung im maskierten Bearbeitungssteuerelement an.

Geschützte Methoden

Name	Description
CMFCMaskedEdit::IsMaskedChar	Aufgerufen durch das Framework, um das angegebene Zeichen für das entsprechende Maskenzeichen zu überprüfen.

Hinweise

Führen Sie die folgenden Schritte aus, um das CMFCMaskedEdit-Steuerelement in Ihrer Anwendung verwenden:

1.Betten Sie ein CMFCMaskedEdit-Objekt in die Fensterklasse ein.

2.Rufen Sie die CMFCMaskedEdit::EnableMask-Methode auf, um die Maske anzugeben.

3.Rufen Sie die CMFCMaskedEdit::SetValidChars-Methode auf, um die Liste der gültigen Zeichen anzugeben.

4.Rufen Sie die CMFCMaskedEdit::SetWindowText-Methode auf, um den Standardtext für das Bearbeitungssteuerelement maskierte anzugeben.

5.Rufen Sie die CMFCMaskedEdit::GetWindowText-Methode auf, um den überprüften Text abzurufen.

Wenn Sie keine oder mehrere Methoden aufrufen, um die Maske, die gültigen Zeichen und den Standardtext zu initialisieren, verhält sich das maskierte Bearbeitungssteuerelement, wie das Standardbearbeitungssteuerelement verhält.

Beispiel

Das folgende Beispiel zeigt, wie eine Maske (beispielsweise eine Telefonnummer) durch wird die EnableMask-Methode, um die Maske zu erstellen installiert, sodass das maskierte Bearbeitungssteuerelement, die SetValidChars-Methode, um eine Zeichenfolge von gültigen Zeichen angeben, die der Benutzer eingeben kann, und SetWindowText-Methode eine Eingabeaufforderung im maskierten Bearbeitungssteuerelement anzeigt.Dieses Beispiel ist Teil Neue Kontrollprobe.

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