LB_GETTEXT

Um aplicativo envia uma mensagem LB_GETTEXT para recuperar uma Cadeia de caracteres de uma caixa de listagem.

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

 

Parâmetros

índice
Valor de wParam. Especifica o índice baseado em zero da Cadeia de caracteres para recuperar.

Windows 95 e Windows 98: O wParam parâmetro é limitado a 16-bit valores. Isso significa que as caixas de listagem não podem conter mais de 32.767 itens. Embora o número de itens é restrito, o tamanho total em bytes dos itens em uma caixa de listagem é limitado apenas pela memória disponível.

lpszBuffer
Valor de lParam. Ponteiro para o buffer que receberá a Cadeia de caracteres. O buffer deve ter espaço suficiente para a Cadeia de caracteres e um caractere nulo de terminação. Uma LB_GETTEXTLEN mensagem pode ser enviada antes da mensagem LB_GETTEXT para recuperar o comprimento, em caracteres, da seqüência de caracteres.

Retornar valores

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

Observações

Se você criar a caixa lista com um estilo owner-drawn mas sem o estilo LBS_HASSTRINGS, a reserva apontado pelo lpszBuffer parâmetro receberá 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 lista, caixa de listagem mensagens, LB_GETTEXTLEN

Index