IBM Visualization Data Explorer User's Reference

[ Bottom of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]

SelectorList

Category

Interactor

Function

Generates a list of values and a strings based on user input.

Syntax

Available only through the user interface.

Inputs
Name Type Default Description
stringdata string list or group no default specifies or derives a list of potential output strings
valuelist integer or string list or value list 0-based list list of potential output values
cull flag 0 determines whether zero-length strings are removed (1) or not (0)
label string "Selector" global name applied to interactor stand-ins

Outputs
Name Type Description
value string or value value
name string string name

Functional Details

This module allows the user to interactively select zero, one, or more items from a list. Through inputs to the module (outputs from other tools or values set in its configuration dialog box) the interactor can be "data-driven."

If the interactor is not data-driven, its attributes are taken from its Set Attributes... dialog box (accessed from the Edit pull-down menu in the Control Panel).

This interactor requires a list of strings and a list of values or strings that are then paired up one-to-one and used as selectable outputs. The inputs to SelectorList are used to generate both lists. If there are no inputs, the module uses the values in its Set Attributes... dialog box.

stringdata

controls the string values that appear as output in name. It is required if the interactor is data-driven.

If the parameter value is:

  • a string list: the individual strings are used as potential outputs.
  • a group: the names of the group members (or member1, member2, ...) are used as possible output names.
  • a series group: the names are "position = n," (where n is the series position of each series member).

In every case, the items in the resulting string list are displayed in the list of selections in the corresponding SelectorList interactor.

valuelist

is a list of potential output values.

If this parameter is a value or string list, these values are mapped one-to-one onto the string list that results from stringdata input.

If the interactor is data-driven, the parameter value can also be a single integer used to generate a list of integers beginning with that one.

If the parameter is defaulted and the interactor is data-driven, the value list is a list of integers starting at 0 (zero).

cull

is specified only when the interactor is data-driven. It determines whether or not empty strings are culled from the string list that results from stringdata input. If set to 1, empty strings are removed.

label

is the global label of all instances of the corresponding interactor stand-in. An interactor instance's local label (set from the Control Panel) overrides a global label. If not specified, the global label is set by the user interface.

Example Visual Program

InterfaceControl3.net

See Also

 Integer,  IntegerList,  Scalar,  ScalarList,  Vector


[ Top of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]
[Data Explorer Documentation | QuickStart Guide | User's Guide | User's Reference | Programmer's Reference | Installation and Configuration Guide ]

[Data Explorer Home Page | Contact Data Explorer | Same document on Data Explorer Home Page ]


[IBM Home Page | Order | Search | Contact IBM | Legal ]