CB_GETLBTEXT mensagem
Obtém uma cadeia de caracteres da lista de uma caixa de combinação.
Parâmetros
-
wParam
-
O índice baseado em zero da cadeia de caracteres a ser recuperada.
-
lParam
-
Um ponteiro para o buffer que recebe a cadeia de caracteres. O buffer deve ter espaço suficiente para a cadeia de caracteres e um caractere nulo de terminação. Você pode enviar uma mensagem CB_GETLBTEXTLEN antes da mensagem CB_GETLBTEXT para recuperar o comprimento, em TCHARs, da cadeia de caracteres. Se for uma cadeia de caracteres ANSI, esse será o número de bytes, mas se for uma cadeia de caracteres Unicode, esse será o número de caracteres.
Valor retornado
O valor retornado é o comprimento da cadeia de caracteres, em TCHARs, excluindo o caractere nulo de terminação. Se wParam não especificar um índice válido, o valor retornado será CB_ERR.
Comentários
Aviso de segurança: Usar essa mensagem incorretamente pode comprometer a segurança do programa. Essa mensagem não fornece uma maneira de você saber o tamanho do buffer. Se você usar essa mensagem, primeiro chame CB_GETLBTEXTLEN para obter o número de caracteres necessários e, em seguida, chame a mensagem para recuperar a cadeia de caracteres. Você deve examinar as Considerações de Segurança: Controles do Microsoft Windows antes de continuar.
Se você criar a caixa de combinação com um estilo desenhado pelo proprietário, mas sem o estilo CBS_HASSTRINGS , o buffer apontado por lParam receberá os dados associados ao item.
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 |
|