_OPTIONDATA and _OPTIONGROUPS Variables

The list-type fields store their possible values, ie their options, in two dedicated form variables. Updating these variables will update the list. The variables are named after the field.

FIELDNAME_OPTIONDATA is an array of arrays, containing the value, display text and group of each option in the list.

FIELDNAME_OPTIONGROUPS is a comma separated list that sets which groups from the OPTIONDATA should be displayed to the user. When null all option groups are displayed.

Changing either of these variables using helper.setVariable()will dynamically update the list field.

1. Example One
  
  List box ONE has all of its values set in the forms designer. If the debug panel were enabled, you'd see the variable used to populate this field looks like this:
  
  ONE_OPTIONDATA = [ ["A", "Alpha", "Letters"], ["B", "Bravo", "Letters"], ["C", "Charlie", "Letters"], ["D", "Delta", "Letters"], ["Red", "Red", "Colours"], ["Blue", "Blue", "Colours"], ["Green", "Green", "Colours"] ]
2. One
3. Example Two
  
  The "Add some stuff" script button contains the following funtion, used to populate list box TWO. Note how the group value of each option is an empty string, which means the options won't be grouped. List-type fields all have a variable called FIELDNAME_OPTIONDATA that holds the values of the items in the list. Updating the variable updates the list.
  
  function (helper) { var newData = []; newData.push( ["1","One",""] ); newData.push( ["2","Two",""] ); newData.push( ["3","Three",""] ); newData.push( ["4","Four",""] ); helper.setVariable( "TWO_OPTIONDATA", newData ); }
5. Two

This website uses cookies

Example One

Example Two

Was this page useful?