Share via


CEdit::LimitText

Llame a esta función para restringir la longitud de texto que el usuario escriba en un control de edición.

void LimitText(
   int nChars = 0 
);

Parámetros

  • nChars
    Especifica la longitud (en bytes) del texto que el usuario escriba.Si este parámetro es 0, el texto se establece en los bytes de UINT_MAX .Éste es el comportamiento predeterminado.

Comentarios

Cambiar el límite de texto sólo restringe el texto que el usuario escriba.No tiene ningún efecto en ningún texto ya en el control de edición, ni afecta a la longitud del texto copiado en el control de edición por la función miembro de SetWindowText en CWnd.Si una aplicación utiliza la función de SetWindowText para colocar más texto en un control de edición que se especifica en la llamada a LimitText, puede eliminar el texto cualquiera de los dentro del control de edición.Sin embargo, el límite de texto evitará que el usuario reemplace el texto existente por el nuevo texto, a menos que eliminar la selección actual produce el texto con la extensión debajo del límite de texto.

[!NOTA]

en Win32 (Windows NT y Windows 95 /98), SetLimitText reemplaza esta función.

Para obtener más información, vea EM_LIMITTEXT en Windows SDK.

Ejemplo

// Limit the number of characters to be the maximum number visible.

// Get the text metrics for the edit; needed for the
// average character width.
TEXTMETRIC tm;
CDC* pDC = m_myEdit.GetDC();
pDC->GetTextMetrics(&tm);
m_myEdit.ReleaseDC(pDC);

CRect r;
m_myEdit.GetRect(&r);
m_myEdit.LimitText(r.Width()/tm.tmAveCharWidth);

Requisitos

encabezado: afxwin.h

Vea también

Referencia

Clase de CEdit

Gráfico de jerarquía

CWnd::SetWindowText

CEdit::GetLimitText

CEdit::SetLimitText