Freigeben über


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

Hierarchiediagramm

CListCtrl::DeleteColumn