CRichEditCtrl::LimitText

Limita o comprimento do texto que o usuário pode inserir em um controle de edição.

void LimitText(
   long 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 valor padrão), o comprimento do texto é definido como 64 K bytes.

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:

Para o limite de texto, cada item OLE conta sistema autônomo um único caractere.

Para obter mais informações, consulte EM_EXLIMITTEXT 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_myRichEditCtrl.GetDC();
pDC->GetTextMetrics(&tm);
m_myRichEditCtrl.ReleaseDC(pDC);

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

Requisitos

Cabeçalho: afxcmn.h

Consulte também

Referência

Classe CRichEditCtrl

Gráfico de hierarquia

CRichEditCtrl::GetLimitText

Outros recursos

CRichEditCtrl membros