Classe CMFCMaskedEdit

Articolo
06/10/2015

La classe CMFCMaskedEdit supporta un controllo di modifica mascherato, che convalida input per una maschera e visualizzare i risultati convalidati in base a un modello.

class CMFCMaskedEdit : public CEdit

Membri

Costruttori pubblici

Nome	Descrizione
CMFCMaskedEdit::CMFCMaskedEdit	Costruttore predefinito.
CMFCMaskedEdit::~CMFCMaskedEdit	Distruttore

Metodi pubblici

Nome	Descrizione
CMFCMaskedEdit::DisableMask	Disabilita convalidare l'input utente.
CMFCMaskedEdit::EnableGetMaskedCharsOnly	Specifica se il metodo GetWindowText recupera solo caratteri mascherati.
CMFCMaskedEdit::EnableMask	Inizializza il controllo di modifica mascherato.
CMFCMaskedEdit::EnableSelectByGroup	Specifica se il controllo di modifica mascherato selezionare i gruppi specifici di input, o tutto l'input utente.
CMFCMaskedEdit::EnableSetMaskedCharsOnly	Specifica se il testo viene convalidato solo con i caratteri mascherati, o nella maschera intera.
CMFCMaskedEdit::GetThisClass	Utilizzato dal framework per ottenere un puntatore all'oggetto CRuntimeClass associato a questo tipo della classe.
CMFCMaskedEdit::GetWindowText	Retrieves ha convalidato il testo dal controllo di modifica mascherato.
CMFCMaskedEdit::SetValidChars	Specifica una stringa di caratteri validi in cui l'utente può immettere.
CMFCMaskedEdit::SetWindowText	Viene visualizzata una richiesta nel controllo di modifica mascherato.

Metodi protetti

Nome	Descrizione
CMFCMaskedEdit::IsMaskedChar	Chiamato dal framework per convalidare il carattere specificato con il carattere corrispondente della maschera.

Note

Eseguire i passaggi seguenti per utilizzare il controllo CMFCMaskedEdit nell'applicazione:

1. Importare un oggetto CMFCMaskedEdit nella classe della finestra.

2. Chiamare il metodo CMFCMaskedEdit::EnableMask per specificare la maschera.

3. Chiamare il metodo CMFCMaskedEdit::SetValidChars per specificare l'elenco di caratteri validi.

4. Chiamare il metodo CMFCMaskedEdit::SetWindowText per specificare il testo predefinito per il controllo di modifica mascherato.

5. Chiamare il metodo CMFCMaskedEdit::GetWindowText per recuperare il testo convalidato.

Se non si chiama uno o più metodi per inizializzare la maschera, i caratteri validi e il testo predefinito, il controllo di modifica mascherato si comporta come se il controllo edit standard funziona.

Esempio

Nell'esempio seguente viene illustrato come configurare una maschera ad esempio un numero di telefono) utilizzando il metodo EnableMask per creare la maschera per il controllo di modifica mascherato, il metodo SetValidChars per specificare una stringa di caratteri validi in cui l'utente può immettere e il metodo SetWindowText visualizzata una richiesta nel controllo di modifica mascherato. Questo esempio fa parte Nuovo esempio di controlli.

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