Classe CMFCMaskedEdit

Artigo
08/25/2010

The CMFCMaskedEdit classe oferece suporte a um controle de edição mascarada, que valida a entrada do usuário em relação a uma máscara e exibe os resultados validados de acordo com um modelo.

class CMFCMaskedEdit : public CEdit

Membros

Construtores públicos

Nome	Descrição
CMFCMaskedEdit::CMFCMaskedEdit	Construtor padrão.
CMFCMaskedEdit::~CMFCMaskedEdit	Destruidor.

Métodos públicos

Nome	Descrição
CMFCMaskedEdit::DisableMask	Desativa a validação da entrada do usuário.
CMFCMaskedEdit::EnableGetMaskedCharsOnly	Especifica se o GetWindowText método recupera somente caracteres mascarados.
CMFCMaskedEdit::EnableMask	Inicializa o mascarado controle de edição.
CMFCMaskedEdit::EnableSelectByGroup	Especifica se o controle de edição mascarada seleciona grupos específicos de entrada do usuário ou todas as entradas do usuário.
CMFCMaskedEdit::EnableSetMaskedCharsOnly	Especifica se o texto é validado apenas mascarado caracteres ou contra a máscara de inteira.
CMFCMaskedEdit::GetThisClass	Usado pela estrutura para obter um ponteiro para o CRuntimeClass objeto que está associado a este tipo de classe.
CMFCMaskedEdit::GetWindowText	Recupera validar texto do controle de edição mascarada.
CMFCMaskedEdit::SetValidChars	Especifica uma seqüência de caracteres de válido caracteres que o usuário pode digitar.
CMFCMaskedEdit::SetWindowText	Exibe um aviso no controle de edição mascarada.

Métodos protegidos

Nome	Descrição
CMFCMaskedEdit::IsMaskedChar	Chamado pela estrutura para validar o caractere especificado contra o caractere de máscara correspondente.

Comentários

Execute as seguintes etapas para usar o CMFCMaskedEdit controle em seu aplicativo:

1.Incorporar um CMFCMaskedEdit objeto para sua classe de janela.

2.telefonar the CMFCMaskedEdit::EnableMask método para especificar a máscara.

3.telefonar the CMFCMaskedEdit::SetValidChars método para especificar a lista de caracteres válido.

4.telefonar the CMFCMaskedEdit::SetWindowText controle de edição de método para especificar o texto padrão para o mascarado.

5.telefonar the CMFCMaskedEdit::GetWindowText método para recuperar o texto validado.

Se não chame um ou mais métodos para inicializar a máscara, sistema autônomo caracteres válido e texto padrão, o controle de edição mascarada se comporta exatamente sistema autônomo se comporta o controle de edição padrão.

Exemplo

O exemplo a seguir demonstra como conjunto uma máscara (por exemplo, um número de telefone) usando o EnableMask método para criar a máscara para editar o mascarado controle, o SetValidChars método para especificar uma seqüência de caracteres válidas que o usuário pode inserir, e SetWindowText método para exibir um aviso com a máscara de controle de edição. Este exemplo faz parte o Exemplo do NewControls: Aplicativo de demonstração de controles MFC.

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