Eggplant Functional Script Preferences

Eggplant Functional Script Preferences contain the controls for features that can make it easier for you to read and write scripts. Script Preferences can be found by going to Eggplant > Preferences, then selecting the Script tab.

On this page:

General

The General pane of the Script Preferences tab provides basic controls for working with scripts in your Eggplant Functional suites.

The Script General preferences tab in Eggplant Functional

Script Saving

When a script is run: This preference determines how Eggplant Functional deals with unsaved script changes when you run a script. You have the following options:

  • Don't save: Select this option to run scripts without saving changes.
  • Save that script: Select this option to auto-save script changes before running scripts.
  • Save all scripts: Select this option to auto-save all open scripts before running the current script.
  • Ask to save: Select this option to be alerted to unsaved script changes when you run a script.
Note: When a running script calls another script, the called script is read from the currently saved copy. If you have unsaved changes in the called script, they are not executed.

When a script is modified: This preference determines what Eggplant Functional does if another user saves changes to a script while you are using it. You have the following options:

  • Ignore: Select this option to keep the script as it currently appears on your desktop without loading the newly saved version.
  • Reload the script: Select this option to reload your script when Eggplant Functional detects that the saved version has changed.
  • Ask to reload: Select this option to have Eggplant Functional ask you whether to keep the current version or load the saved version of your script.

Reload breakpoints from last save: Select this checkbox to automatically reset saved breakpoints when you open scripts.

Text

Default Script Font: This field displays the default font of your text in the Script Editor. (New text and plain text loaded from other scripts are both displayed in this font.) Click Set to select a font on your system. This font choice is also used in the initial setting of the folder global property at the beginning of each script run.

Script Log Font: This setting determines the font used to display script results and output in the Log Area of the Run window. Click Set to select a font on your system.

Allow Text Drag and Drop: Drag-and-drop text is disabled in the Script Editor by default. Select this checkbox if you want to be able to move text by dragging it.

Action Scripts Templates File Section

When this field is blank, Eggplant Functional uses the built-in template file for generating Action Scripts. Click Customize to save a local copy of the template file that you can edit. Click Browse to locate a custom template file on your system.

Completion

The Completion pane of the Script preferences tab provides options for how the code auto-completion feature works when you're scripting in the Eggplant Functional Script Editor.

The Script Completion preferences tab in Eggplant Functional

Punctuation Assistance: Defines the punctuation marks you want Eggplant Functional to auto-complete as you type in the Script Editor.

Auto-Complete Statements: Determine which statement types you can auto-complete. For example, with If Statements selected, when you begin typing an If statement, a pop-up window provides suggestions for completion; you can select the variant you want to use from the list, and Eggplant Functional inserts the appropriate code, ready for you to customize.

Suggested Completions: Provides options to control how script suggestions and insertions operate.

To learn more about any individual option, hover the cursor over it to see explanatory text.

Indentation

The Indentation pane of the Script preferences tab includes settings to control the automatic indentation of text in the Script Editor.

Script Indentation preferences in Eggplant Functional

Script Indentation

Indent scripts automatically: Select this checkbox to apply indentation when you insert a comment, paste text, or press Return.

Indent control structures by / Indent continuation lines by: These preferences determine the size of your automatic indentations. Select Tab(s) or Space(s), then enter the number of tabs or spaces to indent. Continuation line refers to a long statement displayed across multiple lines. To force a line break in a statement, insert a backslash (/).

The Tab Key. Choose an item in this drop-down list to determine the function of Tab in the Script Editor. The Tab key can trigger indentation, insert a tab space, or both.

Example Script

This pane shows a script with the current indentation settings. As you make changes in the Script Indentation section, the example script updates automatically to reflect the new settings.

Colorization

The settings on the Colorization pane of the Script preferences tab control the automatic color-coding of text in the Script Editor.

Script Colorization preferences tab in Eggplant Functional

Enable syntax coloring: Select this checkbox to turn on automatic script colorization.

Update colors continuously while typing: Select this checkbox to automatically update colors in the current script line as you type. If this feature is turned off, script colors are updated when you insert a comment, paste, save, or press Return.

Colorization Settings: These settings let you customize the colorization of different script elements.

  • For each script element, select the first checkbox to auto-colorize it in the Script Editor.
  • To edit a script element’s color, click its color well, then select a new color in the standard Colors panel.
  • Select the Bold checkbox to display the script element in bold text.

Restore Colors: Click this button to restore colorization to the default settings.

Example Script

This pane displays a preview of the way scripts appears in the Script Editor with your current colorization settings. As you make changes above, the example script updates automatically to reflect the new settings.

 

This topic was last updated on October 22, 2019, at 04:39:41 PM.

Eggplant icon Eggplantsoftware.com | Documentation Home | User Forums | Support | Copyright © 2019 Eggplant