macro ListView_SetItemPosition (commctrl.h)

Sposta un elemento in una posizione specificata in un controllo visualizzazione elenco (in visualizzazione icona o icona piccola). È possibile utilizzare questa macro o inviare il messaggio di LVM_SETITEMPOSITION in modo esplicito.

Sintassi

BOOL ListView_SetItemPosition(
   HWND hwndLV,
   int  i,
   int  x,
   int  y
);

Parametri

hwndLV

Tipo: HWND

Handle per il controllo visualizzazione elenco.

i

Tipo: int

Indice dell'elemento della visualizzazione elenco.

x

Tipo: int

Nuova posizione x dell'angolo superiore sinistro dell'elemento, nelle coordinate di visualizzazione.

y

Tipo: int

Nuova posizione y dell'angolo superiore sinistro dell'elemento, nelle coordinate di visualizzazione.

Valore restituito

Tipo: BOOL

Restituisce TRUE in caso di esito positivo oppure FALSE in caso contrario.

Osservazioni

Se il controllo visualizzazione elenco ha lo stile LVS_AUTOARRANGE, il controllo visualizzazione elenco viene disposto dopo l'impostazione della posizione dell'elemento.

In Windows Vista chiamare questa macro in un controllo visualizzazione elenco con lo stile LVS_AUTOARRANGE non esegue alcuna operazione e il valore restituito è FALSE.

Fabbisogno