CEdit::LimitText

Artigo
06/10/2015

Chamar 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) de texto que o usuário pode inserir. Se esse parâmetro é 0, o tamanho do texto é definido em bytes de UINT_MAX . Este é o comportamento padrão.

Comentários

Altere o limite de texto apenas restringe o texto que o usuário pode inserir. Não tem efeito em qualquer texto já no controle de edição, ou afeta o tamanho do texto copiado para o controle de edição pela função de membro de SetWindowText em CWnd. Se um aplicativo usa a função para colocar mais de SetWindowText texto em um controle de edição do que está especificado na chamada a LimitText, o usuário pode excluir um de texto dentro do controle de edição. Em o entanto, o limite de texto impedirá que o usuário substitui o texto existente com o novo texto, a menos que excluir a seleção atual causar queda ao texto abaixo do limite de texto.

Dica

(Em O Windows NT e Windows 95 /98), SetLimitText substitui essa função.

Para obter mais informações, consulte EM_LIMITTEXT em 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);