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 |
|
Confira também
-
Referência
-
Outros recursos