Partilhar via


LB_GETTEXT mensagem

Obtém uma cadeia de caracteres de uma caixa de listagem.

Parâmetros

wParam

O índice baseado em zero da cadeia de caracteres a ser recuperada.

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

lParam

Um ponteiro para o buffer que receberá a cadeia de caracteres; é do tipo LPTSTR que é convertido posteriormente em um LPARAM. O buffer deve ter espaço suficiente para a cadeia de caracteres e um caractere nulo de terminação. Uma mensagem LB_GETTEXTLEN pode ser enviada antes da mensagem LB_GETTEXT para recuperar o comprimento, em TCHARs, da cadeia 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á LB_ERR.

Comentários

Se a caixa de listagem tiver um estilo desenhado pelo proprietário, mas não o estilo de LBS_HASSTRINGS , o buffer apontado pelo parâmetro lParam receberá o valor associado ao item (os dados do 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

LB_GETTEXTLEN