Compartilhar via


CRichEditCtrl::LimitText

Limitar o tamanho 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) de texto que o usuário pode inserir. Se esse parâmetro é 0 (o valor padrão), o tamanho do texto é definido em bytes 64K.

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

Para o limite de texto, cada item do OLE conta como um único caractere.

Para obter mais informações, consulte EM_EXLIMITTEXT 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_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 da hierarquia

CRichEditCtrl::GetLimitText