CListCtrl::InsertColumn

Fügt eine neue Spalte in einem ListView-Steuerelement ein.

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

Parameter

  • nCol
    Der Index der neuen Spalte.

  • pColumn
    Adresse einer LVCOLUMN-Struktur, die die Attribute der neuen Spalte enthält.

  • LpszColumnHeading
    Adresse einer Zeichenfolge, die die Überschrift der Spalte enthält.

  • nFormat
    Ganze Zahl, die die Ausrichtung der Spalte angibt.Es kann einer dieser Werte sein: LVCFMT_LEFT, LVCFMT_RIGHT oder LVCFMT_CENTER.

  • nWidth
    Breite der Spalte, in Pixel.Wenn dieser Parameter -1 ist, wird die Spaltenbreite nicht festgelegt.

  • nSubItem
    Index des Unterelements zugeordnete der Spalte.Wenn dieser Parameter -1 ist, wird kein Unterelement mit der Spalte zugeordnet.

Rückgabewert

Der Index der neuen Spalte, wenn erfolgreich oder andernfalls -1.

Hinweise

Die Spalte ganz links in einem ListView-Steuerelement muss linksbündig ausgerichtet sein.

Die LVCOLUMN-Struktur enthält die Attribute einer Spalte in der Berichtsansicht.Sie wird auch verwendet, um Informationen über eine Spalte zu erhalten.Diese Struktur wird in Windows SDK beschrieben.

Anforderungen

Header: afxcmn.h

Siehe auch

Referenz

CListCtrl-Klasse

Hierarchien-Diagramm

CListCtrl::DeleteColumn