macro Header_InsertItem (commctrl.h)

Articolo
10/24/2024

Inserisce un nuovo elemento in un controllo intestazione. È possibile utilizzare questa macro o inviare il messaggio di HDM_INSERTITEM in modo esplicito.

Sintassi

int Header_InsertItem(
         HWND     hwndHD,
         int      i,
   const LPHDITEM phdi
);

Parametri

hwndHD

Tipo: HWND

Handle per il controllo intestazione.

i

Tipo: int

Indice dell'elemento dopo il quale deve essere inserito il nuovo elemento. Il nuovo elemento viene inserito alla fine del controllo intestazione se è maggiore o uguale al numero di elementi nel controllo. Se è zero, il nuovo elemento viene inserito all'inizio del controllo intestazione.

phdi

Tipo: const LPHDITEM

Puntatore a una struttura HDITEM che contiene informazioni sul nuovo elemento.

Valore restituito

Tipo: int

Restituisce l'indice del nuovo elemento in caso di esito positivo o -1 in caso contrario.

Osservazioni

La macro Header_InsertItem è definita come segue:

#define Header_InsertItem(hwndHD, i, phdi) \

    (int)SendMessage((hwndHD), HDM_INSERTITEM, (WPARAM)(int)(i), \

    (LPARAM)(const LPHDITEM)(phdi))

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	commctrl.h

Condividi tramite