macro ListView_SetColumnWidth (commctrl.h)

Article
10/24/2024

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

Syntaxe

BOOL ListView_SetColumnWidth(
   HWND hwnd,
   int  iCol,
   int  cx
);

Paramètres

hwnd

Type : HWND

Handle du contrôle list-view.

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 corresponde 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

Type : BOOL

Retourne TRUE en cas de réussite ou FALSE sinon.

Remarques

Supposons que vous disposez d’un contrôle d’affichage liste de 2 colonnes avec 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 colonne (et la dernière) sera de 300 pixels de large.

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

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	commctrl.h

Partager via