User Tools

Site Tools


INPUTBOX LIST

Guide Section: An EASAP GUI
EASAP Tree: USER INTERFACEFORM LIST or TABBED PANE LISTFORM or TABBED PANE


An INPUTBOX LIST represents a column that will appear in a DATA TABLE. The parameters and behavior is similar to the INPUTBOX in most respects, but exclude the parameters and Child objects that are invalid for INPUTBOX LIST.

INPUTBOX LIST
Optional Parameters:
Input Type:data type of the INPUTBOX. Currency, Custom, DateTime, General, Number, Percentage, Text
Default:default value to be displayed
Input Style:reference to a USER INTERFACE STYLE that controls the visual appearance of INPUTBOX's input area
Alternate Style:USER INTERFACE STYLE to apply to the second row and every even numbered row in the DATA TABLE
Enable if:logical expression, if TRUE then cells may be modified, if FALSE display values with a grey background
Tool Tip:text to be displayed as a tool tip
Decimal Places:the number of decimal places shown
Thousand Separator:show a thousands separator, see INPUTBOX. default→FALSE, TRUE
Currency Symbol:select the type of currency symbol. default→$, £, , ¥
Pattern:format for storage and display of date and time
Characters:width of INPUTBOX in characters
Number Format Code:select the custom number format to show
Delimiter:character to delimit object references in Label: and Default: when Input Type: is non-numeric. default→%.
Row Style from DOR:a LIST reference that evaluates to a sequence of semi-colon delimited, comma-separated CSS attributes
that correspond to the sequence of INPUTBOX's in the DATA TABLE's INPUTBOX LIST
allows for style changes according to the value of the INPUTBOX
Separator:separate elements in a list of input values with this character (default→<COMMA>)
by default two or more comma-separated values may be entered in a cell, the values will be inserted sequentially
choose a different character to separate a list of values entered into a single cell (perhaps if comma's are present in the entered text choose a new separator)

Row Style from DOR:

Row Style from DOR: provides a powerful alternative to Input Style: and Alternate Input Style: which both accept a pre-specified USER INTERFACE STYLE.

Instead of specifying a fixed USER INTERFACE STYLE, the Author may provide, for example, a REPEATED MAP or a simply any LIST that contains semi-colon delimited, custom CSS attributes for each INPUTBOX.

Below is an example using a REPEATED MAP to adjust the 'background-color:' CSS attribute:

  • REPEATED EXPAND red_green
    • Value: Red, Green
  • REPEATED EXPAND red_green_styles
    • Value: background-color:red;border:none, background-color:green;border:none
  • REPEATED MAP repeated_map1
    • List: inputbox_list1
    • Inputs: red_green
    • Outputs: red_green_styles
  • INPUTBOX LIST inputbox_list1
    • Default: Green, Red, Red
    • Row Style from DOR: repeated_map1

The above will create three INPUTBOX's with the default values of 'Green', 'Red' and 'Red', with the corresponding background colors. The colors will change according to the value of the INPUTBOX's.


Using blank entries in Row Style from DOR:

A <SPACE> is required to denote blank CSS-style for an element in a comma-separated list of CSS-style attributes.

Two adjacent commas without any space is a shorthand to adopt, for the current element, the prior element's CSS-style attributes.


Separator:

  • to insert three values into a DATA TABLE using a slash as a separator
  • create a DATA TABLE
  • create a Child INPUTBOX LIST
    • set Separator: /
  • when the EASAP is running enter 1/2/3 in a DATA TABLE cell
    • → the three numbers will be inserted, 1 in that cell and 2 and 3 in two new cells below it