ListView_InsertColumn macro

Inserts a new column in a list-view control. You can use this macro or send the LVM_INSERTCOLUMN message explicitly.

Syntax


int ListView_InsertColumn(
         HWND       hwnd,
         int        iCol,
   const LPLVCOLUMN pcol
);

Parameters

hwnd

Type: HWND

A handle to the list-view control.

iCol

Type: int

The index of the new column.

pcol

Type: const LPLVCOLUMN

A pointer to an LVCOLUMN structure that contains the attributes of the new column.

Return value

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

Remarks

Columns are visible only in report (details) view.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Commctrl.h

 

 

Show: