CEdit::LimitText

Artigo
08/25/2010

Chame essa função para limitar o tamanho do texto que o usuário pode inserir em um controle de edição.

void LimitText(
   int nChars = 0 
);

Parâmetros

nChars
Especifica o comprimento (em bytes) do que o usuário pode digitar texto.Se este parâmetro for 0, o comprimento do texto será definido como UINT_MAX bytes.Esse é o comportamento padrão.

Comentários

Alterar o limite de texto restringe apenas o texto que o usuário pode digitar.Ele não tem efeito sobre qualquer texto já no controle de edição nem afeta o tamanho do texto copiado para o controle de edição pela SetWindowText função membro CWnd. Se um aplicativo usar o SetWindowText função para inserir mais texto em um controle de edição que é especificado na telefonar para LimitText, o usuário pode excluir qualquer texto dentro do controle de edição. No entanto, o limite de texto irá impedir que o usuário substituindo o texto existente pelo novo texto, a menos que excluir a seleção corrente faz com que o texto cair abaixo do limite de texto.

Observação:
No Win32 (Windows NT e Windows 95/98) SetLimitText substitui essa função.

Para obter mais informações, consulte EM_LIMITTEXT in the Windows SDK.

Exemplo

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