Structure LVCOLUMNW (commctrl.h)

  • Article

Contient des informations sur une colonne en mode Rapport. Cette structure est utilisée à la fois pour créer et manipuler des colonnes. Cette structure remplace la structure LV_COLUMN.

Syntaxe

typedef struct tagLVCOLUMNW {
  UINT   mask;
  int    fmt;
  int    cx;
  LPWSTR pszText;
  int    cchTextMax;
  int    iSubItem;
  int    iImage;
  int    iOrder;
  int    cxMin;
  int    cxDefault;
  int    cxIdeal;
} LVCOLUMNW, *LPLVCOLUMNW;

Membres

mask

Type : UINT

Variable spécifiant les membres qui contiennent des informations valides. Ce membre peut être égal à zéro, ou à une ou plusieurs des valeurs suivantes :

Valeur Signification
LVCF_FMT
 Le membre fmt est valide.
LVCF_WIDTH
 Le membre cx est valide.
LVCF_TEXT
 Le membre pszText est valide.
LVCF_SUBITEM
 Le membre iSubItem est valide.
LVCF_IMAGE

Version 4.70. Le membre iImage est valide.
LVCF_ORDER

Version 4.70. Le membre iOrder est valide.
LVCF_MINWIDTH

Version 6.00 et Windows Vista.Le membre cxMin est valide.
LVCF_DEFAULTWIDTH

Version 6.00 et Windows Vista.Le membre cxDefault est valide.
LVCF_IDEALWIDTH

Version 6.00 et Windows Vista.Le membre cxIdeal est valide.

fmt

Type : int

Alignement de l’en-tête de colonne et du texte sous-élément dans la colonne. L’alignement de la colonne la plus à gauche est toujours LVCFMT_LEFT ; elle ne peut pas être modifiée. Ce membre peut être une combinaison des valeurs suivantes. Notez que toutes les combinaisons ne sont pas valides.

Valeur Signification
LVCFMT_LEFT
 Le texte est aligné à gauche.
LVCFMT_RIGHT
 Le texte est aligné à droite.
LVCFMT_CENTER
 Le texte est centré.
LVCFMT_JUSTIFYMASK
 Masque de bits utilisé pour sélectionner les bits de fmt qui contrôlent la justification du champ. Pour case activée le format d’une colonne, utilisez un « et » logique pour combiner LCFMT_JUSTIFYMASK avec fmt. Vous pouvez ensuite utiliser une instruction switch pour déterminer si les bits LVCFMT_LEFT, LVCFMT_RIGHT ou LVCFMT_CENTER sont définis.
LVCFMT_IMAGE

Version 4.70. L’élément affiche une image d’une liste d’images.
LVCFMT_BITMAP_ON_RIGHT

Version 4.70. La bitmap apparaît à droite du texte. Cela n’affecte pas une image d’une liste d’images affectée à l’élément d’en-tête.
LVCFMT_COL_HAS_IMAGES

Version 4.70. L’élément d’en-tête contient une image dans la liste d’images.
LVCFMT_FIXED_WIDTH

Version 6.00 et Windows Vista. Impossible de redimensionner la colonne ; identique à HDF_FIXEDWIDTH.
LVCFMT_NO_DPI_SCALE

Version 6.00 et Windows Vista. Si ce n’est pas le cas, CCM_DPISCALE régira la mise à l’échelle de la largeur fixe.
LVCFMT_FIXED_RATIO

Version 6.00 et Windows Vista. La largeur augmente avec la hauteur de ligne.
LVCFMT_SPLITBUTTON

Version 6.00 et Windows Vista. Colonne est un bouton fractionné (identique à HDF_SPLITBUTTON). L’en-tête de la colonne affiche un bouton fractionné (identique à HDF_SPLITBUTTON).

cx

Type : int

Largeur de la colonne, en pixels.

pszText

Type : LPTSTR

Si les informations de colonne sont définies, ce membre est l’adresse d’une chaîne terminée par null qui contient le texte d’en-tête de colonne. Si la structure reçoit des informations sur une colonne, ce membre spécifie l’adresse de la mémoire tampon qui reçoit le texte d’en-tête de colonne.

cchTextMax

Type : int

Taille en TCHARde la mémoire tampon pointée par le membre pszText . Si la structure ne reçoit pas d’informations sur une colonne, ce membre est ignoré.

iSubItem

Type : int

Index du sous-élément associé à la colonne.

iImage

Type : int

Version 4.70. Index de base zéro d’une image dans la liste d’images. L’image spécifiée s’affiche dans la colonne.

iOrder

Type : int

Version 4.70. Décalage de colonne de base zéro. Le décalage de colonne est dans l’ordre de gauche à droite. Par exemple, zéro indique la colonne la plus à gauche.

cxMin

Type : int

Windows Vista. Largeur minimale de la colonne en pixels.

cxDefault

Type : int

Windows Vista. Valeur définie par l’application généralement utilisée pour stocker la largeur par défaut de la colonne. Ce membre est ignoré par le contrôle list-view.

cxIdeal

Type : int

Windows Vista. Lecture seule. Largeur idéale de la colonne en pixels, car la colonne peut actuellement être automatiquement adaptée à une largeur inférieure.

Remarques

Si une colonne est ajoutée à un contrôle list-view avec l’index 0 (colonne la plus à gauche), elle est toujours LVCFMT_LEFT. La définition d’autres indicateurs sur la colonne 0 ne remplace pas cet alignement. Par conséquent, si vous continuez à insérer des colonnes avec l’index 0, le texte de toutes les colonnes est aligné à gauche. Si vous souhaitez que la première colonne soit alignée à droite ou centrée, vous pouvez créer une colonne factice, puis insérer une ou plusieurs colonnes avec l’index 1 ou supérieur et spécifier l’alignement dont vous avez besoin. Enfin, supprimez la colonne factice.

Notes

L’en-tête commctrl.h définit LVCOLUMN comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

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

Voir aussi

LVM_DELETECOLUMN

LVM_GETCOLUMN

LVM_INSERTCOLUMN

LVM_SETCOLUMN

Référence