Método ITextHost::TxGetMaxLength (textserv.h)

Obtém o comprimento máximo permitido do host de texto para o texto.

Sintaxe

HRESULT TxGetMaxLength(
  DWORD *plength
);

Parâmetros

plength

Tipo: DWORD*

O comprimento máximo permitido do texto, em número de caracteres. Se INFINITE for retornado, o objeto de serviços de texto poderá usar a quantidade de memória necessária para armazenar qualquer texto especificado.

Valor retornado

Tipo: HRESULT

O valor retornado é S_OK.

Comentários

Quando esse máximo for atingido, o objeto de serviços de texto deverá rejeitar qualquer inserção de caractere adicional e texto colado. TxSetText , no entanto, ainda deve aceitar (e definir) texto maior que o comprimento máximo. Isso ocorre porque esse método é usado para associação e é fundamental para manter a integridade dos dados aos quais o controle está associado.

Esse método faz um paralelo com a mensagem EM_LIMITTEXT .

Se o limite retornado for menor que o número de caracteres atualmente no objeto de serviços de texto, nenhum dado será perdido. Em vez disso, nenhuma edição tem permissão para o texto diferente da exclusão até que o texto seja reduzido para abaixo do limite.

Requisitos

Confira também

Conceitual

EM_LIMITTEXT

ITextHost

Referência

Controles de edição avançada sem janelas