macro ListView_GetItemState (commctrl.h)

  • Articolo

Ottiene lo stato di un elemento della visualizzazione elenco. È possibile utilizzare questa macro o inviare il messaggio di LVM_GETITEMSTATE in modo esplicito.

Sintassi

UINT ListView_GetItemState(
   HWND hwndLV,
   int  i,
   UINT mask
);

Parametri

hwndLV

Tipo: HWND

Handle per il controllo visualizzazione elenco.

i

Tipo: int

Indice dell'elemento della visualizzazione elenco.

mask

Tipo: UINT

Informazioni sullo stato da recuperare. Questo parametro 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.
LVIS_OVERLAYMASK
 Usare questa maschera per recuperare l'indice dell'immagine di sovrapposizione dell'elemento.
LVIS_STATEIMAGEMASK
 Usare questa maschera per recuperare l'indice dell'immagine di stato dell'elemento.

Valore restituito

Tipo: UINT

Restituisce lo stato corrente per l'elemento specificato. Gli unici bit validi nel valore restituito sono quelli che corrispondono ai bit impostati nel parametro mask .

Osservazioni

Le informazioni sullo stato di un elemento includono un set di flag di bit, nonché indici di elenco di immagini che indicano l'immagine dello stato dell'elemento e l'immagine di sovrapposizione.

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_SetItemState