macro ListView_SetColumnWidth (commctrl.h)

Articolo
10/24/2024

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

BOOL ListView_SetColumnWidth(
   HWND hwnd,
   int  iCol,
   int  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, espressa 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

Tipo: BOOL

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

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.

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

Condividi tramite