Partilhar via


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
Winuser.h (inclua Windows.h)

Confira também

CB_GETLBTEXTLEN