LB_GETTEXTLEN

Um aplicativo envia uma mensagem LB_GETTEXTLEN para recuperar o comprimento de uma Cadeia de caracteres em uma caixa de listagem.

LB_GETTEXTLEN wParam = índice (WPARAM);    / / item índice lParam = 0;                 / / não é usado; deve ser zero 

 

Parâmetros

índice
Valor de wParam. Especifica o índice baseado em zero da Cadeia de caracteres.

Windows 95 e Windows 98: O wParam parâmetro é limitado a 16-bit valores. Isso significa que as caixas de listagem não podem conter mais de 32.767 itens. Embora o número de itens é restrito, o tamanho total em bytes dos itens em uma caixa de listagem é limitado apenas pela memória disponível.

Retornar valores

O valor de retorno é o comprimento da Cadeia de caracteres, em caracteres, excluindo o encerrando null caractere. Sob certas condições, esse valor pode realmente ser maior que o comprimento do texto. Para obter mais informações, consulte a seguinte seção Comentários.

Se o índice parâmetro não especificar um índice válido, o valor de retorno é LB_ERR.

Observações

Sob certas condições, o valor de retorno é maior que o comprimento real do texto. Isso ocorre com determinados mixtures de ANSI e Unicode e é devido ao sistema operacional permitindo a possível existência de double-byte character set (DBCS) caracteres dentro do texto. O valor de retorno, no entanto, será sempre pelo menos tão grande quanto o real tamanho do texto; Você pode, portanto, sempre usá-lo para orientar a alocação do buffer. Este comportamento pode ocorrer quando um aplicativo usa funções ANSI e em diálogos comuns, que usam Unicode.

Para obter o tamanho exato do texto, use os WM_GETTEXT, LB_GETTEXT ou CB_GETLBTEXT mensagens, ou a GetWindowText função.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.

Ver também

Visão geral de caixas de lista, caixa de listagem mensagens, CB_GETLBTEXT, GetWindowText, LB_GETTEXT, WM_GETTEXT

Index