macro ListView_SetItemState (commctrl.h)

Modifica lo stato di un elemento in un controllo visualizzazione elenco. È possibile utilizzare questa macro o inviare il messaggio di LVM_SETITEMSTATE in modo esplicito.

Sintassi

void ListView_SetItemState(
   HWND hwndLV,
   int  i,
   UINT data,
   UINT mask
);

Parametri

hwndLV

Tipo: HWND

Handle per il controllo visualizzazione elenco.

i

Tipo: int

Indice dell'elemento della visualizzazione elenco. Se questo parametro è -1, la modifica dello stato viene applicata a tutti gli elementi.

data

Tipo: UINT

Nuovi bit di stato per l'elemento. Il parametro mask indica i bit validi del parametro dati . La macro ignora i bit nel parametro dati se il bit corrispondente non è impostato nel parametro mask . Il byte di ordine basso contiene un set di flag di bit che indicano lo stato dell'elemento. Questo byte può essere una combinazione dei valori seguenti:

Valore	Significato
LVIS_CUT	L'elemento è contrassegnato per un'operazione taglia e incolla.
LVIS_DROPHILITED	L'elemento è evidenziato come destinazione di trascinamento della selezione.
LVIS_FOCUSED	L'elemento ha lo stato attivo, quindi è circondato da un rettangolo di stato attivo standard. Anche se è possibile selezionare più di un elemento, solo un elemento può avere lo stato attivo.
LVIS_SELECTED	L'elemento è selezionato. L'aspetto di un elemento selezionato dipende dal fatto che abbia lo stato attivo e anche sui colori di sistema utilizzati per la selezione. Gli elementi verranno visualizzati come selezionati solo se viene utilizzato lo stato attivo del controllo visualizzazione elenco o lo stile LVS_SHOWSELALWAYS.

mask

Tipo: UINT

Bit del parametro dati da impostare o cancellare. È possibile usare ListView_SetItemState sia per impostare che per cancellare i bit. Per impostare l'indice dell'immagine di sovrapposizione di un elemento, impostare i bit di LVIS_OVERLAYMASK. Per impostare l'indice di immagine dello stato di un elemento, impostare i bit LVIS_STATEIMAGEMASK.

Valore restituito

Nessuno

Osservazioni

Il valore dello stato di un elemento include un set di flag di bit che indicano lo stato dell'elemento. Il valore dello stato può includere anche indici dell'elenco di immagini che indicano l'immagine dello stato dell'elemento e l'immagine di sovrapposizione.

Il parametro mask specifica i bit di stato da modificare e il parametro dati specifica il nuovo valore per tali bit. Per impostare un bit nello stato interno dell'elemento, impostarlo sia nel maschera che nei parametri dati. Per cancellare un po' nello stato interno dell'elemento, impostarlo nel parametro maschera e cancellarlo nel parametro dati . Per lasciare un po' invariato nello stato interno dell'elemento, cancellarlo nel parametro maschera .

I bit da 8 a 11 dei dati parametro specificano l'indice in base uno di un'immagine di sovrapposizione negli elenchi di immagini del controllo. Sia l'elenco di immagini a icona a dimensione intera che l'elenco di immagini a icona piccola possono avere immagini sovrapposte. L'immagine di sovrimpressione viene sovrapposta all'immagine dell'icona dell'elemento. Se questi bit sono zero, l'elemento non ha un'immagine di sovrapposizione. Per isolare questi bit, usare la maschera LVIS_OVERLAYMASK. Per specificare un indice di sovrapposizione, utilizzare la macro INDEXTOOVERLAYMASK .

I bit da 12 a 15 dei dati parametro specificano l'indice in base uno di un'immagine nell'elenco di immagini dello stato del controllo. L'immagine di stato viene visualizzata accanto all'icona di un elemento per indicare uno stato definito dall'applicazione. Se questi bit sono zero, l'elemento non ha un'immagine di stato. Per isolare questi bit, usare la maschera LVIS_STATEIMAGEMASK. Per specificare un indice di immagine di stato, utilizzare la macro INDEXTOSTATEIMAGEMASK.

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

Vedere anche

ListView_GetItemState