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

ListView_InsertData

Previous pageReturn to chapter overviewNext page

 

Description

 

Add new items and set items properties taking data from a string array or string matrix.

 

Syntax

 

n = ListView_InsertData(hWnd, ctrlID, StringArrayOrMatrix [, RowStart [, HowManyRows]])

 

Returns

 

Number.

Number of rows added

 

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 ...

StringArrayOrMatrix

Variable

No

A string array (one dimension) or a string matrix (two dimensions)

RowStart

Number

Yes

If present, it can be used to specify from which row of the array/matrix to start to keep data. If not present or less than 1, 1 will be assumed.

HowManyRows

Number

Yes

If present, it can be used to limit the number of rows to consider starting from RowStart position.

 

Remarks

 

Programmer does not need to worry about RowStart/HowManyRows usage exceed array/matrix boundaries. thinBasic will automatically detect it.

 

Restrictions

 

See also

 

Examples

 

'...

'---Assign data to 2 dimension matrix

Dim s(5, 3) As String

 s(1,1) = "Folder 1""1""Whatever data here regarding Folder 1"

 s(2,1) = "Folder 2""2""Whatever data here regarding Folder 2"

 s(3,1) = "Folder 3""3""Whatever data here regarding Folder 3"

 s(4,1) = "Folder 4""4""Whatever data here regarding Folder 4"

 s(5,1) = "Folder 5""5""Whatever data here regarding Folder 5"

 

'---ListView columns must be already in place

'---Add full matrix data to listview

LISTVIEW_InsertData hDlg, %ID_LV_LEFT, s()

'...