User Tools

Site Tools


LOGICBOX

Guide Section: An EASAP GUI
EASAP Tree: USER INTERFACE > FORM LIST or TABBED PANE LIST > FORM or TABBED PANE


LOGICBOX creates a check box that a User may click on to toggle a value.

The default behavior follows Excel's 'Check Box' control which assigns special significance to the strings 'TRUE' and 'FALSE',

  • Checked - 'TRUE'
  • Unchecked - 'FALSE'

An example of a LOGICBOX is shown in below.

LOGICBOX
Optional Parameters:
Checked Value:Set a literal value, SCALAR or LIST reference to be the checked or 'ticked' value
Default: TRUE (the literal string)
Unchecked Value:Set a literal value, SCALAR or LIST reference to be the unchecked or 'unticked' value
Default: FALSE (the literal string)
Label:Enter literal text, SCALAR and/or LIST references to display next to the tick box
Range Reference:Select a NAMED RANGE or RANGE REFERENCE to link LOGICBOX value to one or more cells in a spreadsheet
Show if:Enter a logical expression to apply to this object
This object is shown if this object's and every parent's Show if: is true (ie. parent of parent, and so on up the Tree)
Default: true (also the default for other object's Show if: parameter)
Enable if:Enter a logical expression or leave blank to inherit expression from the first non-blank parent Enable if:
If expression is true object value may be modified, otherwise object is greyed-out and disabled
Default: <blank> (ie. inherit expression from parent, or if parent is <blank>, parent of parent…, up the Tree)
Top level Enable if: is true by default, thus a chain of objects with the default Enable if: <blank> are enabled
Order:Set to TICK FIRST to display a tickbox and then Label: otherwise show the LABEL FIRST
Default: LABEL FIRST
Tool Tip: Enter literal text, and/or SCALAR and/or LIST references to display as a tool tip on mouse-over
Tab Index:Set a literal number to establish an order of preference for <TAB> key navigation,
<TAB> delivers focus to Tab Index: 1 then 2 and continues in ascending numerical order.
After the highest set Tab Index: value, focus is delivered to Tab Index: 0
Tab Index: –1 will completely exclude this object from <TAB> focus selection.
Default: 0
Default:Set to TRUE so the tickbox is checked initially
Default: FALSE
Label Width: Set a literal width in pixels of the Label:
Style:Enter a literal string, or select a USER INTERFACE STYLE or SCALAR for CSS-style to apply to the whole object
Input Style:Enter a literal string, or select a USER INTERFACE STYLE or SCALAR for CSS-style to apply to the input area
Delimiter:Set a literal character to delimit LIST or SCALAR references
Default: %
Rowspan:Set a literal number of cells to vertically span across in the parent LAYOUT PANEL or SUB PANE with Layout: GRID
Colspan:Set a literal number of cells to horizontally span across in the parent LAYOUT PANEL or SUB PANE with Layout: GRID