CB_GETLBTEXT

Um aplicativo envia uma mensagem CB_GETLBTEXT para recuperar uma Cadeia de caracteres da lista de uma caixa de combinação.

CB_GETLBTEXT wParam = índice (WPARAM);                / / item índice lParam = lpszBuffer (LPARAM) (LPCSTR);  / / endereço de buffer 

 

Parâmetros

índice
Valor de wParam. Especifica o índice baseado em zero da Cadeia de caracteres para recuperar.
lpszBuffer
Valor de lParam. Ponteiro para a reserva que recebe a seqüência 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 de CB_GETLBTEXTLEN antes a mensagem CB_GETLBTEXT para recuperar o comprimento, em bytes, da seqüência de caracteres.

Retornar valores

O valor de retorno é o comprimento da Cadeia de caracteres, em bytes, excluindo o encerrando null caractere. Se o índice parâmetro não especificar um índice válido, o valor de retorno é CB_ERR.

Observações

Se você cria a caixa de combinação com um estilo owner-drawn mas sem o estilo CBS_HASSTRINGS, a reserva apontado pelo lpszBuffer parâmetro da mensagem recebe o 32-bit valor associado com o item (os dados item).

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.

Ver também

Visão geral de caixas de combinação, as mensagens de caixa de combinação, CB_GETLBTEXTLEN

Index