Classe CMFCMaskedEdit

Artigo
06/10/2015

A classe de CMFCMaskedEdit suporta um controle de edição mascarado, que valide a entrada do usuário contra uma máscara e exibe os resultados validados de acordo com um modelo.

class CMFCMaskedEdit : public CEdit

Membros

Construtores public

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

Métodos públicos

Nome	Descrição
CMFCMaskedEdit::DisableMask	Desativa verificação que validam a entrada do usuário.
CMFCMaskedEdit::EnableGetMaskedCharsOnly	Especifica se o método de GetWindowText retorna apenas caracteres mascarados.
CMFCMaskedEdit::EnableMask	Inicializa o controle de edição mascarado.
CMFCMaskedEdit::EnableSelectByGroup	Especifica se o controle de edição mascarado seleciona grupos específicos de entrada do usuário, ou qualquer entrada do usuário.
CMFCMaskedEdit::EnableSetMaskedCharsOnly	Especifica se o texto é validado contra apenas caracteres mascarados, ou com a máscara inteira.
CMFCMaskedEdit::GetThisClass	Usado pela estrutura para obter um ponteiro para o objeto de CRuntimeClass que está associado com esse tipo da classe.
CMFCMaskedEdit::GetWindowText	Retrieves validou o texto do controle de edição mascarado.
CMFCMaskedEdit::SetValidChars	Especifica uma cadeia de caracteres de caracteres válidos que o usuário pode inserir.
CMFCMaskedEdit::SetWindowText	Exibe um aviso o controle de edição mascarado.

Métodos protegidos

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

Comentários

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

1. Inserir um objeto de CMFCMaskedEdit em sua classe de janela.

2. Chame o método de CMFCMaskedEdit::EnableMask para especificar a máscara.

3. Chame o método de CMFCMaskedEdit::SetValidChars para especificar a lista de caracteres válidos.

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

5. Chame o método de CMFCMaskedEdit::GetWindowText para recuperar o texto validado.

Se você não chama um ou mais métodos para inicializar a máscara, caracteres válidos, e o texto padrão, o controle de edição mascarado se comporta exatamente como o controle de edição padrão se comporta.

Exemplo

O exemplo a seguir demonstra como configurar uma máscara (por exemplo um número de telefone) usando o método de EnableMask para criar a máscara para o controle de edição mascarado, o método de SetValidChars para especificar uma cadeia de caracteres de caracteres válidos que o usuário pode inserir, e o método de SetWindowText exibe um aviso o controle de edição mascarado. Este exemplo é parte de novo exemplo de controles.

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