macro ListBox_InsertItemData (windowsx.h)

Inserisce i dati degli elementi in una casella di riepilogo nella posizione specificata. È possibile utilizzare questa macro o inviare il messaggio di LB_INSERTSTRING in modo esplicito.

Sintassi

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

Parametri

hwndCtl

Tipo: HWND

Handle per il controllo.

index

Tipo: int

Indice in base zero nell'elenco in corrispondenza del quale inserire i dati dell'elemento o -1 per aggiungerlo alla fine dell'elenco.

data

Tipo: LPARAM

Puntatore ai dati dell'elemento da inserire.

Valore restituito

Tipo: int

Il valore restituito è l'indice in base zero dell'elemento nella casella di riepilogo. Se si verifica un errore, il valore restituito viene LB_ERR. Se non è disponibile spazio sufficiente per archiviare la nuova stringa, il valore restituito è LB_ERRSPACE.

Osservazioni

Utilizzare questa macro per una casella di riepilogo con uno stile disegnato dal proprietario, ma senza lo stile LBS_HASSTRINGS. Per altre informazioni, vedere LB_INSERTSTRING.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	windowsx.h