DVX_GUI/widgets/listView/listview.bhs

57 lines
2.1 KiB
Text

.topic ctrl.listview
.title ListView
.toc 1 Data Display Controls
.toc 1 ListView
.index ListView
.index Multi-Column List
.index SetColumns
.index SetSort
.h1 ListView
VB Equivalent: ListView -- DVX Widget: listview
A multi-column list with column headers. Supports sorting, multi-select, and drag-to-reorder.
.h2 Type-Specific Properties
.table
Property Type R/W Description
--------- ------- --- -------------------------------------------
ListIndex Integer R/W Index of the currently selected row (-1 = none).
.endtable
.h2 Type-Specific Methods
.table
Method Description
------ -----------
AddItem text$ Add a row (sets first column text).
Clear Remove all rows.
ClearSelection Deselect all rows.
GetCell$(row%, col%) Returns the text of a cell.
IsItemSelected(index%) Returns True if the row is selected.
RemoveItem index% Remove a row by index.
RowCount() Returns the number of rows.
SelectAll Select all rows.
SetCell row%, col%, text$ Set the text of a cell.
SetColumns spec$ Define columns. Pipe-delimited "Name,Width|Name,Width" (width in characters).
SetItemSelected index%, selected Select or deselect a row.
SetMultiSelect multi Enable or disable multi-select.
SetReorderable reorderable Enable or disable row reordering.
SetSort col%, dir% Sort by column. dir: 0=none, 1=ascending, 2=descending.
.endtable
Default Event: Click
.h2 Example
.code
ListView1.SetColumns "Name,20|Size,10|Type,15"
ListView1.AddItem "readme.txt"
ListView1.SetCell 0, 1, "1024"
ListView1.SetCell 0, 2, "Text"
ListView1.SetSort 0, 1
.endcode
.link ctrl.common.props Common Properties, Events, and Methods