CB_GETLBTEXTLEN mensagem

Obtém o comprimento, em caracteres, de uma cadeia de caracteres na lista de uma caixa de combinação.

Parâmetros

wParam

O índice baseado em zero da cadeia de caracteres.

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. Se uma cadeia de caracteres ANSI for o número de bytes e se for uma cadeia de caracteres Unicode, esse será o número de caracteres. 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.

Se o parâmetro wParam não especificar um índice válido, o valor retornado será CB_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; para que você sempre possa 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 .

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