EM_LIMITTEXT 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.
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 de várias linhas.
-
lParam
-
Este parâmetro não é usado.
Valor retornado
Esta mensagem não retorna um valor.
Comentários
A mensagem EM_LIMITTEXT limita apenas o texto que o usuário pode inserir. Ele não afeta nenhum texto que já esteja no controle de edição quando a mensagem é enviada, nem afeta o comprimento do texto copiado para o controle de edição pela mensagem WM_SETTEXT . Se um aplicativo usar a mensagem WM_SETTEXT para colocar mais texto em um controle de edição do que o especificado na mensagem EM_LIMITTEXT , o usuário poderá editar todo o conteúdo do controle de edição.
Antes que EM_LIMITTEXT 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 de várias linhas, esse valor é -1 byte 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 |
|
Confira também
-
Referência
-
Outros recursos