Navigation:  thinBasic Modules > UI (User Interface) > Dedicated Control Functions > ListView Control > ListView: Items functions >

ListView_InsertItem

Previous pageReturn to chapter overviewNext page

 

Description

 

Inserts a new item in a list-view control.

 

Syntax

 

n = ListView_InsertItem(hWnd, ctrlID, RowIndex, sText [, lMask])

 

Returns

 

Number

 

Parameters

 

Name

Type

Optional

Meaning

hWnd

Number

No

Handle of the dialog containing the list-view control

ctrlID

Number

No

Control identifier assigned to the control during CONTROL ADD ...

RowIndex

Number

No

Row index. Starts from 1

sText

String

No

A string containing the item text.

lMask

Number

Yes

Set of flags that specify which members of this structure contain data to be set or which members are being requested. This member can have one or more of the following flags set:

%LVIF_COLFMT

%LVIF_COLUMNS

%LVIF_DI_SETITEM

%LVIF_GROUPID

%LVIF_IMAGE

%LVIF_INDENT

%LVIF_NORECOMPUTE

%LVIF_PARAM

%LVIF_STATE

%LVIF_TEXT

 

If this member is zero or omitted, the following default value will be used:

%LVIF_TEXT or %LVIF_PARAM or %LVIF_STATE

 

Remarks

 

More items text can be indicated using "|" char as separator. For example:
"File|Description|Size"
This can avoid multiple subsequent calls to ListView_SetItem.
If RowIndex is <= 0, a new item will be added at the bottom

 

Restrictions

 

See also

 

Examples