CListCtrl::InsertColumn

int InsertColumn( int nCol, const LVCOLUMN* pColumn );

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

Return Value

The index of the new column if successful or -1 otherwise.

Parameters

nCol

The index of the new column.

pColumn

Address of an LVCOLUMN structure that contains the attributes of the new column.

lpszColumnHeading

Address of a string containing the column’s heading.

nFormat

Integer specifying the alignment of the column. It can be one of these values: LVCFMT_LEFT, LVCFMT_RIGHT, or LVCFMT_CENTER.

nWidth

Width of the column, in pixels. If this parameter is -1, the column width is not set.

nSubItem

Index of the subitem associated with the column. If this parameter is -1, no subitem is associatied with the column.

Remarks

Inserts a new column in a list view control.

The LVCOLUMN structure contains the attributes of a column in report view. It is also used to receive information about a column. This structure is described in the Platform SDK.

CListCtrl OverviewClass MembersHierarchy Chart

See Also   CListCtrl::DeleteColumn