ComboBox_InsertItemData macro (windowsx.h)

Insere dados de item em uma lista em uma caixa de combinação no local especificado. Você pode usar essa macro ou enviar a mensagem CB_INSERTSTRING explicitamente.

Sintaxe

int ComboBox_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

Os dados do item a serem inseridos.

Valor de retorno

Tipo: int

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

Observações

Use essa macro para uma lista em uma caixa de combinação com um estilo desenhado pelo proprietário, mas sem o estilo CBS_HASSTRINGS. Para obter mais informações, consulte CB_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