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:

  1. The icon view displays large icons along with a caption. The first content column is used as the caption.

    Figure 13-23: Icon view with large icons of the listview

  2. The small icon view is very similar to the icon view, the only difference is that small icons are used.

    Figure 13-24: Icon view with small icons of the listview

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

    Figure 13-25: List view of the listview

  4. The detail view displays all available information in a table. Now the listview object resembles a table.

    Figure 13-26: Detail view of the listview

  5. The tile view is like the list view, but shows large icons. The caption appears next to them.

    Figure 13-27: Tile view of the listview

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

activate

changed

dbselect

deactivate

extevent

focus

help

resize

select

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

Attribute

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

.colcount

number of columns

integer

1

x

x

x

x

.coltitle[integer]

column headings

string

""

x

x

x

x

.colwidth[integer]

column widths in the detail view

integer

0

x

x

x

x

.content[index]

list entries, caption in column 1

string

""

x

x

x

x

.mincolwidth[integer]

minimum column width in the detail view

integer

0

x

x

x

x

.picheight

height of the large icons

integer

0

x

x

x

x

.picture[integer]

large icons

object
(tile)

""

x

x

x

x

.picwidth

width of the large icons

integer

0

x

x

x

x

.rowcount

number of rows

integer

0

x

x

x

x

.selected[integer]

selection of the list entries

boolean

false

x

x

x

x

.smallpicheight

height of the small icons

integer

0

x

x

x

x

.smallpicture[integer]

small icons

object
(tile)

""

x

x

x

x

.smallpicwidth

width of the small icons

integer

0

x

x

x

x

.style

presentation mode

integer
(0…4),

string

0

x

x

x

x

C

changed event on modification

I

Attribute is inherited