LB_GETTEXTLEN mensagem

Obtém o comprimento de uma cadeia de caracteres em uma caixa de listagem.

Parâmetros

wParam

O índice baseado em zero da cadeia de caracteres.

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

lParam

Este parâmetro não é usado.

Valor retornado

O valor retornado é o comprimento da cadeia de caracteres, em TCHARs, excluindo o caractere nulo de terminação. Em determinadas condições, esse valor pode ser, na verdade, maior que o comprimento do texto. Para obter mais informações, consulte a seção Comentários a seguir.

Se o parâmetro wParam não especificar um índice válido, o valor retornado será LB_ERR.

Comentários

Em determinadas condições, o valor retornado é maior que o comprimento real do texto. Isso ocorre com determinadas misturas de ANSI e Unicode e se deve ao sistema operacional que permite a possível existência de caracteres DBCS (conjunto de caracteres de byte duplo) dentro do texto. O valor retornado, no entanto, sempre será pelo menos tão grande quanto o comprimento real do texto; Assim, você sempre pode usá-lo para orientar a alocação de buffer. Esse comportamento pode ocorrer quando um aplicativo usa funções ANSI e caixas de diálogo comuns, que usam Unicode.

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

Se a caixa de listagem tiver um estilo desenhado pelo proprietário, mas não o estilo LBS_HASSTRINGS , o valor retornado será sempre o tamanho, em bytes, de um DWORD.

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

Referência

CB_GETLBTEXT

LB_GETTEXT

Outros recursos

Getwindowtext

WM_GETTEXT