ListBox_GetText macro (windowsx.h)

Artigo
10/24/2024

Obtém uma cadeia de caracteres de uma caixa de listagem. Você pode usar essa macro ou enviar a mensagem LB_GETTEXT explicitamente.

Sintaxe

int ListBox_GetText(
   HWND    hwndCtl,
   int     index,
   LPCTSTR lpszBuffer
);

Parâmetros

hwndCtl

Tipo: HWND

Um identificador para o controle.

index

Tipo: int

O índice baseado em zero do item.

lpszBuffer

Tipo: LPCTSTR

Um 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. Antes de alocar o buffer, você pode chamar ListBox_GetTextLen para recuperar o comprimento da cadeia de caracteres.

Valor de retorno

Tipo: int

A contagem de caracteres na cadeia de caracteres, excluindo o caractere nulo de terminação. Se índice não especificar um item válido, o valor retornado será LB_ERR.

Observações

Para obter mais informações, consulte LB_GETTEXT.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	windowsx.h

Compartilhar via