18 listview
The listview (class name dmw_listview) is an advanced list object that supports various display types. The object is known in principle by the Windows Explorer
, where it is used to display the directories of the file system.
The following figures show the different display types of the listview object:
-
The icon view displays large icons along with a caption. The first content column is used as the caption.
-
The small icon view is very similar to the icon view, the only difference is that small icons are used.
-
The list view also uses the small icons and the caption, but the items are arranged in a list from top to bottom. If necessary, additional columns are added.
-
The detail view displays all available information in a table. Now the listview object resembles a table.
-
The tile view is like the list view, but shows large icons. The caption appears next to them.
Availability
- Microsoft Windows only.
- Can only be used with the USW option of the ISA Dialog Manager.
- The idmwidgets.dll must be in the USW class path (default: <IDM installation directory>\uswclasses).
18.1 Definition
{ export | reexport } { model } dmw_listview { <Identifier> } { <standard attributes> <geometry attributes> <hierarchy attributes> <layout attributes> <text attributes> <object-specific attributes> }
Events |
|||
Children |
None |
||
Parent |
groupbox |
layoutbox |
notepage |
splitbox |
toolbar |
window |
|
Menu |
Pop-up Menu |
18.2 Description of Events
18.2.1 activate
The activate event is triggered when a list item is selected (.selected[I] := true).
The .index attribute of thisevent contains the index of the item that was selected. The data type of thisevent.index is index and thus consistent with the select event. The column value of thisevent.index is always 1, since only this column has a selection status.
18.2.2 dbselect
The dbselect event occurs when a double-click is carried out in the listview.
The .index attribute of thisevent contains the index of the item that was clicked. The data type of thisevent.index is index and thus consistent with the select event. If no item was hit, thisevent.index is not set.
The header in the detail view (column headings) does not have a double-click event.
18.2.3 deactivate
The deactivate event is triggered when a list item loses its selection (.selected[I] := false).
The .index attribute of thisevent contains the index of the item that has lost its selection. The data type of thisevent.index is index and thus consistent with the select event. The column value of thisevent.index is always 1, since only this column has a selection status.
18.2.4 resize
The resize event occurs when a column width has been changed in the detail view.
The event does not arise for columns whose width has been set to 0 and is calculated by the listview.
18.2.5 select
The select event occurs when a click is carried out in the listview.
The .index attribute of thisevent contains the index of the item that was clicked. The data type of thisevent.index is index and thus consistent with the activate event. The column value can be different from 1 only in the detail view.
If no item was hit, thisevent.index is not set. When the header (column headings) of the detail view is clicked, the row value of thisevent.index is 0.
18.3 Inherited Attributes
Attribut |
Data Type |
Notes |
---|---|---|
.accelerator |
object |
|
.bgc |
object |
|
.borderraster |
boolean |
|
.control |
object |
|
.count[attribute] |
anyvalue |
|
.cursor |
object |
|
.cut_pending |
boolean |
|
.cut_pending_changed |
boolean |
|
.dialog |
object |
|
.document[integer] |
object |
|
.export |
boolean |
|
.fgc |
object |
|
.firstrecord |
object |
|
.focus |
boolean |
|
.focus_on_click |
boolean |
|
.font |
object |
|
.function |
object |
|
.function[integer] |
object |
|
.groupbox |
object |
|
.height |
integer |
has to be > 0 |
.help |
string |
|
.index |
index |
|
.label |
string |
|
.lastrecord |
object |
|
.mapped |
boolean |
|
.menu[integer] |
object |
|
.model |
object |
|
.module |
object |
|
.navigable |
boolean |
|
.notepage |
object |
|
.parent |
object |
|
.posraster |
boolean |
|
.real_height |
integer |
|
.real_path[string] |
string |
|
.real_sensitive |
boolean |
|
.real_visible |
boolean |
|
.real_width |
integer |
|
.record[integer] |
object |
|
.recordcount |
object |
|
.reexport |
object |
|
.scope |
object |
|
.sensitive |
boolean |
|
.sizeraster |
boolean |
|
.source |
object |
|
.statushelp |
string |
|
.target |
object |
|
.toolbar |
object |
|
.toolhelp |
object |
|
.transformer[integer] |
object |
|
.type[anyvalue] |
datatype |
|
.userdata |
anyvalue |
|
.visible |
boolean |
|
.width |
integer |
has to be > 0 |
.window |
object |
|
.xauto |
integer |
|
.xleft |
integer |
|
.xright |
integer |
|
.yauto |
integer |
|
.ybottom |
integer |
|
.ytop |
integer |
|
18.4 Specific Attributes
Attribute |
Short Description |
Data Type |
Default |
Access |
C |
I |
|
---|---|---|---|---|---|---|---|
get |
set |
||||||
number of columns |
integer |
1 |
x |
x |
x |
x |
|
column headings |
string |
"" |
x |
x |
x |
x |
|
column widths in the detail view |
integer |
0 |
x |
x |
x |
x |
|
list entries, caption in column 1 |
string |
"" |
x |
x |
x |
x |
|
minimum column width in the detail view |
integer |
0 |
x |
x |
x |
x |
|
height of the large icons |
integer |
0 |
x |
x |
x |
x |
|
large icons |
object
|
"" |
x |
x |
x |
x |
|
width of the large icons |
integer |
0 |
x |
x |
x |
x |
|
number of rows |
integer |
0 |
x |
x |
x |
x |
|
selection of the list entries |
boolean |
false |
x |
x |
x |
x |
|
height of the small icons |
integer |
0 |
x |
x |
x |
x |
|
small icons |
object
|
"" |
x |
x |
x |
x |
|
width of the small icons |
integer |
0 |
x |
x |
x |
x |
|
presentation mode |
integer
string |
0 |
x |
x |
x |
x |
|
C |
changed event on modification |
I |
Attribute is inherited |