Condividi tramite

macro ListView_InsertItem (commctrl.h)

  • Articolo

Inserisce un nuovo elemento in un controllo visualizzazione elenco. È possibile utilizzare questa macro o inviare il messaggio di LVM_INSERTITEM in modo esplicito.

Sintassi

int ListView_InsertItem(
         HWND     hwnd,
   const LPLVITEM pitem
);

Parametri

hwnd

Tipo: HWND

Handle per il controllo visualizzazione elenco.

pitem

Tipo: const LPLVITEM

Puntatore a una struttura LVITEM che specifica gli attributi dell'elemento della visualizzazione elenco. Utilizzare il membro iItem per specificare l'indice in base zero in corrispondenza del quale deve essere inserito il nuovo elemento. Se questo valore è maggiore del numero di elementi attualmente contenuti dal controllo listview, il nuovo elemento verrà aggiunto alla fine dell'elenco e assegnato l'indice corretto. Esaminare il valore restituito della macro per determinare l'indice effettivo assegnato all'elemento.

Valore restituito

Tipo: int

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

Osservazioni

Non è possibile utilizzare ListView_InsertItem o LVM_INSERTITEM per inserire elementi secondari. Il membro iSubItem della struttura LVITEM deve essere zero. Per informazioni sull'impostazione degli elementi secondari, vedere LVM_SETITEM.

Se per un controllo visualizzazione elenco è impostato lo stile LVS_EX_CHECKBOXES, qualsiasi valore posizionato in bit da 12 a 15 dello stato membro della struttura LVITEM verrà ignorato. Quando un elemento viene aggiunto con questo set di stili, verrà sempre impostato sullo stato non selezionato.

Se un controllo visualizzazione elenco ha lo stile LVS_SORTASCENDING o LVS_SORTDESCENDING finestra, un messaggio di LVM_INSERTITEM avrà esito negativo se si tenta di inserire un elemento con LPSTR_TEXTCALLBACK come membro pszText della struttura LVITEM.

La macro ListView_InsertItem inserirà il nuovo elemento nella posizione corretta nell'ordinamento se sono presenti le condizioni seguenti:

  • Si usa uno degli stili LVS_SORTXXX.
  • Non si usa lo stile LVS_OWNERDRAW.
  • Il membro pszText della struttura a cui punta pitem non è impostato su LPSTR_TEXTCALLBACK.

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