Compartilhar via


EM_SETLIMITTEXT mensagem

Define o limite de texto de um controle de edição. O limite de texto é a quantidade máxima de texto, em TCHARs, que o usuário pode digitar no controle de edição. Você pode enviar essa mensagem para um controle de edição ou um controle de edição avançada.

Para controles de edição e Microsoft Rich Edit 1.0, bytes são usados. Para o Microsoft Rich Edit 2.0 e posterior, os caracteres são usados.

A mensagem EM_SETLIMITTEXT é idêntica à mensagem EM_LIMITTEXT .

Parâmetros

wParam

O número máximo de TCHARs que o usuário pode inserir. Para texto ANSI, esse é o número de bytes; para texto Unicode, esse é o número de caracteres. Esse número não inclui o caractere nulo de terminação.

Controles de edição avançada: Se esse parâmetro for zero, o comprimento do texto será definido como 64.000 caracteres.

Se esse parâmetro for zero, o comprimento do texto será definido como 0x7FFFFFFE caracteres para controles de edição de linha única ou 1 para controles de edição multilinha.

lParam

Este parâmetro não é usado.

Valor retornado

Esta mensagem não retorna um valor.

Comentários

A mensagem EM_SETLIMITTEXT limita apenas o texto que o usuário pode inserir. Ele não afeta nenhum texto já no controle de edição quando a mensagem é enviada, nem afeta o comprimento do texto copiado para o controle de edição pela mensagem de WM_SETTEXT . Se um aplicativo usar a mensagem WM_SETTEXT para colocar mais texto em um controle de edição do que é especificado na mensagem EM_SETLIMITTEXT , o usuário poderá editar todo o conteúdo do controle de edição.

Antes que EM_SETLIMITTEXT seja chamado, o limite padrão para a quantidade de texto que um usuário pode inserir em um controle de edição é de 32.767 caracteres.

Para controles de edição de linha única, o limite de texto é 0x7FFFFFFE bytes ou o valor do parâmetro wParam , o que for menor. Para controles de edição multilinha, esse valor é 1 bytes ou o valor do parâmetro wParam , o que for menor.

Edição avançada: Com suporte no Microsoft Rich Edit 1.0 e posterior. Use a mensagem EM_EXLIMITTEXT para valores de comprimento de texto maiores que 64.000. Para obter informações sobre a compatibilidade de versões de edição avançada com as várias versões do sistema, consulte Sobre controles de edição avançada.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Winuser.h (inclua Windows.h)

Confira também

EM_GETLIMITTEXT