ListBox_InsertItemData macro (windowsx.h)

Artigo
10/24/2024

Insere dados de item em uma caixa de listagem no local especificado. Você pode usar essa macro ou enviar a mensagem LB_INSERTSTRING explicitamente.

Sintaxe

int ListBox_InsertItemData(
   HWND   hwndCtl,
   int    index,
   LPARAM data
);

Parâmetros

hwndCtl

Tipo: HWND

Um identificador para o controle.

index

Tipo: int

O índice baseado em zero na lista na qual inserir os dados do item ou –1 para adicioná-los ao final da lista.

data

Tipo: LPARAM

Um ponteiro para os dados do item a serem inseridos.

Valor de retorno

Tipo: int

O valor retornado é o índice baseado em zero do item na caixa de listagem. Se ocorrer um erro, o valor retornado será LB_ERR. Se não houver espaço suficiente para armazenar a nova cadeia de caracteres, o valor retornado será LB_ERRSPACE.

Observações

Use essa macro para uma caixa de listagem com um estilo desenhado pelo proprietário, mas sem o estilo LBS_HASSTRINGS. Para obter mais informações, consulte LB_INSERTSTRING.

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