Navigation: thinBasic Modules > UI (User Interface) > CONTROLs > Dedicated Control Functions > LISTVIEW Control > ListView: Items functions > ListView_InsertItem |
|
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
© 2004-2008 thinBasic. All rights reserved. | Version 1.7.0.0 | Web Site: http://www.thinbasic.com |