macro ListView_SetColumnWidth (commctrl.h)

Consente di modificare la larghezza di una colonna nella visualizzazione report o la larghezza di tutte le colonne in modalità visualizzazione elenco. È possibile utilizzare questa macro o inviare il messaggio di LVM_SETCOLUMNWIDTH in modo esplicito.

Sintassi

void ListView_SetColumnWidth(
   hwnd,
   iCol,
   cx
);

Parametri

hwnd

Tipo: HWND

Handle per il controllo visualizzazione elenco.

iCol

Tipo: int

Indice in base zero di una colonna valida. Per la modalità di visualizzazione elenco, questo parametro deve essere impostato su zero.

cx

Tipo: int

Nuova larghezza della colonna, in pixel. Per la modalità di visualizzazione report sono supportati i valori speciali seguenti:

Valore	Significato
LVSCW_AUTOSIZE	Ridimensiona automaticamente la colonna.
LVSCW_AUTOSIZE_USEHEADER	Ridimensiona automaticamente la colonna in base al testo dell'intestazione. Se si utilizza questo valore con l'ultima colonna, la larghezza viene impostata per riempire la larghezza rimanente del controllo visualizzazione elenco.

Valore restituito

nessuno

Osservazioni

Si supponga di avere un controllo visualizzazione elenco a 2 colonne con una larghezza di 500 pixel. Se la larghezza della colonna zero è impostata su 200 pixel e si effettua la chiamata seguente.

ListView_SetColumnWidth(hwnd, 1, LVSCW_AUTOSIZE_USEHEADER)

La seconda colonna (e l'ultima) sarà larga 300 pixel.

Si noti che ListView_SetColumnWidth converte il parametro cx in un valore a 16 bit.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	commctrl.h