Please enable JavaScript to view this site.

CWT User Interface Design Handbook

Navigation: STN controls

ListView (STN)

Scroll Prev Top Next More

<Stn:ListView Name='LanguageSelectionListView'/>

Description

The ListView control is used to display a list with selectable items. The ListView can be used to select a language in the user interface, to select Paymentservice, Article and TariffPackage (PAT, see CWT configuration handbook). It will also display a list of registered Codes (e.g. License plates) when used with Personal Accounts. The number of items in the ListView is dynamic and the content is populated from the CWT configuration file or retrieved from WebOffice.

 

Properties

Description:

Height

Type:Unsigned integer. Value range 0 – 128.
Description:Defines the height of the list view on the display.

ItemHeight

Type:Unsigned integer. Value range 12 – 128.
Description:Defines the height of each item in list. The y coordinated of each item is caculated by y= row number × ItemHeight + VerticalSpace;

Location

Type:String in format “X,Y” where X and Y are both unsigned integers.
Value:Value range for X is 0 – 260
Value range for Y is 0 – 128.
Description:The Location property specifies where the list view shall be placed in relation to the parent control. The Location property specifies where inside a panel the list view will be located. The physical location on the display will then depend on where the panel is placed (Panels also have a Location property) and where the list view is positioned.

Name

Type:A string of any length
Description:The name of the list view control. Remember that Name must be unique within a panel.

ListView Names:
The ListView control must be named according to the type of selection to be made:

ArticleSelectionListView
Populated with available articles in the terminal.

CodeSelectionView
Populated with available codes assigned to an online personal account.

LanguageSelectionListView
Populated with all available languages in the terminal.

PaymentServiceSelectionListView
Populated with available paymentservices in the terminal.

TariffPackageSelectionListView
Populated with available tariff packages in the terminal.

TextModeName

Value:WhiteText (Default), BlackText
Description:The TextModeName property controls the background mode of a PopupPanel.

When WhiteText is used will the PopupPanel background be black to allow white text to be visible inside the popup, while the BlackText value causes the PopupPanel to be rendered with white background to make texts in black visible inside the popup. WhiteText is the default mode if TextModeName is not defined on the PopupPanel.

VerticalSpace

Type:Unsigned integer. Value range 0 – 128.
Description:Defines the vertical offset space for the first row in the list. The y coordinated of each item is calculated by y= row number × ItemHeight + VerticalSpace;

Width

Type:Unsigned integer. Value range 0 – 260.
Description:Defines the width of the list view on the display.

 

SUB-elements

The table below lists the sub-elements that can be defined in a ListView control. The sub-elements add other controls to the form which creates a keyboard mapping for physical buttons in the terminal. One of the sub-elements also adds a software DLL reference that is used when connecting actions to buttons, etc.

Sub-element

Description

Controls

The Controls sub-element contains Images in the ListView. see Images in ListView.

Example:

<Stn:ListView Name='LanguageSelectionListView'/>.

 

Continue reading:

Button Click actions

Images in ListView