CMFCMaskedEdit, classe

Article
06/10/2015

La classe d' CMFCMaskedEdit prend un contrôle d'édition masqué, qui valide les entrées d'utilisateur à un masque et affiche les résultats validées en fonction d'un modèle.

class CMFCMaskedEdit : public CEdit

Membres

Constructeurs publics

Nom	Description
CMFCMaskedEdit::CMFCMaskedEdit	Constructeur par défaut.
CMFCMaskedEdit::~CMFCMaskedEdit	Destructor.

Méthodes publiques

Nom	Description
CMFCMaskedEdit::DisableMask	Désactive la validation des entrées d'utilisateur.
CMFCMaskedEdit::EnableGetMaskedCharsOnly	Spécifie si la méthode d' GetWindowText récupère uniquement les caractères masqués.
CMFCMaskedEdit::EnableMask	Initialise le contrôle d'édition masqué.
CMFCMaskedEdit::EnableSelectByGroup	Spécifie si le contrôle d'édition masqué sélectionne les groupes particuliers d'entrée d'utilisateur, ou toute entrée utilisateur.
CMFCMaskedEdit::EnableSetMaskedCharsOnly	Spécifie si le texte est validé par rapport à uniquement les caractères masqués, ou sur le masque entière.
CMFCMaskedEdit::GetThisClass	Utilisé par l'infrastructure pour obtenir un pointeur vers l'objet de CRuntimeClass associé à ce type de classe.
CMFCMaskedEdit::GetWindowText	Retrieves a validé le texte du contrôle d'édition masqué.
CMFCMaskedEdit::SetValidChars	Spécifie une chaîne de caractères valides que l'utilisateur peut entrer.
CMFCMaskedEdit::SetWindowText	Affiche une invite dans le contrôle d'édition masqué.

Méthodes protégées

Nom	Description
CMFCMaskedEdit::IsMaskedChar	Appelé par l'infrastructure pour valider le caractère spécifié par rapport à le caractère correspondant de masque.

Notes

Exécutez les étapes suivantes pour utiliser le contrôle d' CMFCMaskedEdit dans votre application :

1. Incluez un objet d' CMFCMaskedEdit dans votre classe de fenêtre.

2. Appelez la méthode d' CMFCMaskedEdit::EnableMask pour spécifier le masque.

3. Appelez la méthode de CMFCMaskedEdit::SetValidChars pour spécifier la liste de caractères valides.

4. Appelez la méthode de CMFCMaskedEdit::SetWindowText pour spécifier le texte par défaut pour le contrôle d'édition masqué.

5. Appelez la méthode de CMFCMaskedEdit::GetWindowText pour récupérer le texte validé.

Si vous n'appelez pas une ou plusieurs méthodes pour initialiser le masque, les caractères valides, et le texte par défaut, le contrôle d'édition masqué se comporte comme le contrôle d'édition standard se comporte.

Exemple

L'exemple suivant montre comment configurer un masque (par exemple un numéro de téléphone) à l'aide de la méthode d' EnableMask pour créer le masque pour le contrôle d'édition masqué, la méthode d' SetValidChars pour spécifier une chaîne de caractères valides que l'utilisateur peut entrer, et la méthode d' SetWindowText affiche une invite dans le contrôle d'édition masqué. Cet exemple fait partie de Nouvel exemples de contrôles.

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