ListView_SetColumnWidth macro (commctrl.h)

Permet de modifier la largeur d’une colonne en mode État ou la largeur de toutes les colonnes en mode affichage liste. Vous pouvez utiliser cette macro ou envoyer le message LVM_SETCOLUMNWIDTH explicitement.

Syntaxe

void ListView_SetColumnWidth(
   hwnd,
   iCol,
   cx
);

Paramètres

hwnd

Type : HWND

Handle pour le contrôle d’affichage de liste.

iCol

Type : int

Index de base zéro d’une colonne valide. Pour le mode d’affichage de liste, ce paramètre doit être défini sur zéro.

cx

Type : int

Nouvelle largeur de la colonne, en pixels. Pour le mode d’affichage de rapport, les valeurs spéciales suivantes sont prises en charge :

Valeur	Signification
LVSCW_AUTOSIZE	Dimensionne automatiquement la colonne.
LVSCW_AUTOSIZE_USEHEADER	Dimensionne automatiquement la colonne pour qu’elle s’adapte au texte d’en-tête. Si vous utilisez cette valeur avec la dernière colonne, sa largeur est définie pour remplir la largeur restante du contrôle d’affichage de liste.

Valeur de retour

None

Remarques

Supposons que vous disposez d’un contrôle d’affichage de liste à 2 colonnes d’une largeur de 500 pixels. Si la largeur de la colonne zéro est définie sur 200 pixels et que vous effectuez l’appel suivant.

ListView_SetColumnWidth(hwnd, 1, LVSCW_AUTOSIZE_USEHEADER)

La deuxième (et dernière) colonne aura une largeur de 300 pixels.

Notez que ListView_SetColumnWidth convertit le paramètre cx en valeur 16 bits.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	commctrl.h