Open topic with navigation

Softdial Scripter™ Page Editor

Selection

KeyedSelection - list KeyedSelection - multi list KeyedSelection - Radio

Fig. 1 - Selection control - List, MultiList, Radio

A control that allows selection of a single item, or zero or more items, from a list, according to the SelectionStyle.

Properties that are common to this and many other controls are described in Common Properties.

ClosedSelection properties

Property Description
Background See Common Properties
BorderBrush See Common Properties
BorderThickness See Common Properties
DisplayBlankValues Whether the control displays values from the Items list that are empty
FontFamily See Common Properties
FontSize See Common Properties. Spacing between items is scaled automatically
FontStyle See Common Properties
FontWeight See Common Properties
Foreground See Common Properties
Height See Common Properties. A vertical scrollbar is created and controlled automatically
IsEnabled See Common Properties
Items Defines a list of displayed items. To edit the list, click on the Browse (...) button. The Edit selection items dialogue opens (Fig. 2) :

Edit selection items

Fig. 2 - Edit selection items

To add a list item:

  1. Click Add. A new list item is created at the bottom of the list
  2. Overwrite the default label text (Selection item) with the desired text

To remove a list item:

  1. Select a list item
  2. Click Remove

To move an item up/ down within the list

  1. Select a list item
  2. Click Up or Down

The effect of the Selected column depends on the control's SelectionStyle, as follows:

SelectionStyleEffectUsage
DropListDefines the text visible when the page loadsTo use an item as visible text, check its box.
To have no visible text, uncheck all boxes.
It is not possible to define other text to be visible. For this, use ComboBox

List
MultiList
Radio
Checkbox

 Defines whether an item is already selected when the page loadsTo define an item, check its box

Changes are reflected immediately on the Screen grid.
Language See Common Properties
Margin See Common Properties
Name See Common Properties
SelectionStyle Select from the drop-down list. Options are:

OptionDisplay Example# items selectable
List (default)Display as ListOne
MultiList

(Identical to Checkbox)

Display as Multilist/ CheckboxZero or more
DropListDisplay as DropListOne
RadioDisplay as RadioOne
Checkbox

(Identical to Multilist)

Display as Multilist/ CheckboxZero or more
TabIndex See Common Properties
Visibility See Common Properties
Width See Common Properties

For details of usage within the script flow, see Collection Controls.

See also the ComboBox, CheckBox and KeyedSelection controls.

 

Copyright © 2004 - 2019  Sytel Limited