CMFCMaskedEdit Class

Artículo
06/10/2015

La clase de CMFCMaskedEdit admite un control de edición enmascarado, que valida los datos proporcionados por el usuario en una máscara y muestra los resultados validados como una plantilla.

class CMFCMaskedEdit : public CEdit

Members

Constructores públicos

Name	Descripción
CMFCMaskedEdit::CMFCMaskedEdit	Constructor predeterminado.
CMFCMaskedEdit::~CMFCMaskedEdit	Un destructor.

Métodos públicos

Name	Descripción
CMFCMaskedEdit::DisableMask	Deshabilita validar los datos proporcionados por el usuario.
CMFCMaskedEdit::EnableGetMaskedCharsOnly	Especifica si el método de GetWindowText recupera únicamente caracteres enmascarados.
CMFCMaskedEdit::EnableMask	Inicializa el control de edición enmascarado.
CMFCMaskedEdit::EnableSelectByGroup	Especifica si el control de edición enmascarado selecciona los grupos concretos de datos proporcionados por el usuario, o todos los datos proporcionados por el usuario.
CMFCMaskedEdit::EnableSetMaskedCharsOnly	Especifica si el texto se validará con únicamente caracteres enmascarados, o con la máscara entera.
CMFCMaskedEdit::GetThisClass	Utiliza el marco para obtener un puntero al objeto de Recursos que está asociado a este tipo de clase.
CMFCMaskedEdit::GetWindowText	Texto validado recupera del control de edición enmascarado.
CMFCMaskedEdit::SetValidChars	Especifica una cadena de caracteres válido que el usuario puede especificar.
CMFCMaskedEdit::SetWindowText	Muestra un indicador en el control de edición enmascarado.

Métodos protegidos

Name	Descripción
CMFCMaskedEdit::IsMaskedChar	Llamado por el marco para validar el carácter especificado con el carácter correspondiente de la máscara.

Comentarios

Realice los pasos siguientes para utilizar el control de CMFCMaskedEdit en su aplicación:

1. Inserte un objeto de CMFCMaskedEdit en la clase de ventana.

2. Llame al método de CMFCMaskedEdit::EnableMask para especificar la máscara.

3. Llame al método de CMFCMaskedEdit::SetValidChars para especificar la lista de caracteres válidos.

4. Llame al método de CMFCMaskedEdit::SetWindowText para especificar el texto predeterminado para el control de edición enmascarado.

5. Llame al método de CMFCMaskedEdit::GetWindowText para recuperar el texto validado.

Si no se llama a uno o varios métodos para inicializar la máscara, los caracteres válidos, y el texto del valor predeterminado, el control de edición enmascarado se comporta igual que el control edit estándar se comporta.

Ejemplo

El ejemplo siguiente muestra cómo configurar una máscara (como un número de teléfono) mediante el método de EnableMask para crear la máscara para que el control de edición enmascarado, el método de SetValidChars para especificar una cadena de caracteres válido que el usuario puede especificar, y el método de SetWindowText muestren un marcador en el control de edición enmascarado. Este ejemplo forma parte de nuevo ejemplo 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);
}