Compartilhar via


CEdit::LimitText

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.

ObservaçãoObservação

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

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe de CEdit

Gráfico de hierarquia

CWnd::SetWindowText

CEdit::GetLimitText

CEdit::SetLimitText