1  The new constructor is called on the Form.Field.Option class and the created form element is stored in a variable, in this example alignmentMenu. This variable can be used in the parent action as the parameter for the addField() method of the Form class to add the menu to a form.

 2  The menu is assigned a unique identifying key (string) that is used to extract the current displayed menu item object when the form is validated or processed.

 3  The text to use as the label for the menu.

 4  An array of Omni application objects. In this example, calling the all property of the HorizontalAlignment class returns an array of HorizontalAlignment options representing left, center, and right alignments. This array of objects will be used to populate the menu.

 5  Since a null value is used instead of an array of menu titles, the localized built-in titles for the objects will be displayed as the contents of the menu.

 6  Indicate which menu object is to be pre-selected when the form is displayed, by providing one of the objects from the source list of objects as the value of this parameter.

 X  The result of the creation of the menu element is an object reference to the form element.

 1  An array of strings, in this case the names of the days of the week, are stored in a variable: weekdays

 2  The new constructor is called on the Form.Field.Option class and the created form element is stored in a variable, in this example weekdayMenu. This variable can be used in the parent action as the parameter for the addField() method of the Form class to add the menu to a form.

 3  The menu is assigned a unique identifying key (string) that is used to extract the current displayed menu item object when the form is validated or processed.

 4  The text to use as the label for the menu.

 5  Since the content of the menu will be a list of weekday names, the required object list is used instead as an array of index values, indicating the chosen weekday’s position in the array of weekday names. Since JavaScript considers the first item in an array to have a position (index) of 0, begin the sequential array of indexes with 0.

 6  The content of the menu (menu items) is the weekday list, represented by the variable: weekdays

 7  Indicate which menu object is to be pre-selected when the form is displayed, by providing one of the indexes from the objects array as the value of this parameter. In this example, the index 0 is used to indicate that the first menu item should be pre-selected when the form is displayed.

 9  The result of the creation of the menu element is an object reference to the form element.

 20-27  A new menu form element is created using a list of strings (numeric strings representing stroke thicknesses) as the source of the menu’s content.

 29-36  A new form element is created using an array of object options from the LineJoin class. The built-in localized option titles for this class will be displayed as the menu’s contents.

 38-45  A new form element is created using an array of object options from the Stroketype class. The built-in localized option titles for this class will be displayed as the menu’s contents.

 47-54  A new form element is created using an array of object options from the StrokeDash class. The built-in localized option titles for this class will be displayed as the menu’s contents.

 56-59  The created form elements are added to the blank form object using the addField(…) method of the Form class.

 62-64  The form validation function is used to determine the state of the form’s approval button. In this example, the validation value is set to always return true, leaving the button always active.

 67  The form is displayed using the show(…) method of Form class.

 70-84  The form settings are extracted from the form values record returned from the stored promise object, and the extracted stroke settings are applied to the selected graphics. NOTE: the value returned by the strokeThickness key is the array index of the chosen menu item. The next statement (73) uses that index to retrieve the stored numeric string value, and then convert it to a number.

 105-107  Due to the complexity of dealing with multiple graphics simultaneously, the action validation function is set to only be enabled if a single graphic is selected in the document.

 13  A reference to the selected graphic is stored in the variable: selectedGraphic

 15-18  The stroke properties of the selected graphic are stored in variables prior to the form being displayed to the user.

 68-83  The form settings are extracted and applied to the selected graphic from within the form’s validate function rather than from within the form promise’s then(…) function. Every time the settings of any of the form elements are changed, the validation handler will be called and the selected graphics property values will be altered accordingly.

 94-100  Should the user cancel the form dialog, the promise’s error handler (catch) is called and the stroke settings of the selected graphic are restored to the settings stored in the variables declared at the beginning of the action.