Partager via


CListCtrl::InsertColumn

Insère une nouvelle colonne dans un contrôle liste view.

int InsertColumn(
   int nCol,
   const LVCOLUMN* pColumn 
);
int InsertColumn(
   int nCol,
   LPCTSTR lpszColumnHeading,
   int nFormat = LVCFMT_LEFT,
   int nWidth = -1,
   int nSubItem = -1 
);

Paramètres

  • nCol
    L'index de la nouvelle colonne.

  • pColumn
    Adresse d'une structure de LVCOLUMN qui contient les attributs de la nouvelle colonne.

  • lpszColumnHeading
    Adresse d'une chaîne contenant l'en-tête de la colonne.

  • nFormat
    Entier spécifiant l'alignement de la colonne.Il peut être l'une de ces valeurs : LVCFMT_LEFT, LVCFMT_RIGHT, ou LVCFMT_CENTER.

  • nWidth
    Largeur de la colonne, en pixels.Si ce paramètre est -1, la largeur de colonne n'est pas définie.

  • nSubItem
    Index du sous-élément associé à la colonne.Si ce paramètre est -1, un sous-élément n'est associé à la colonne.

Valeur de retour

L'index de la nouvelle colonne si l'opération a réussi ou -1 sinon.

Notes

La colonne la plus à gauche dans un contrôle liste view doit être alignée à gauche.

La structure de LVCOLUMN contient les attributs d'une colonne en mode Rapport.Il est également utilisé pour recevoir des informations sur une colonne.Cette structure est décrite dans Kit de développement logiciel Windows.

Configuration requise

Header: afxcmn.h

Voir aussi

Référence

Classe de CListCtrl

Graphique de la hiérarchie

CListCtrl::DeleteColumn