SCRIPTING: ScriptSense [22873]

Authoring and editing E-Basic script is enhanced with ScriptSense™, a script-completion and editing tool. ScriptSense™ provides automatic command completion and context-sensitive information about available coding elements. ScriptSense™ also supports an extensive set of short-cut keys to access a variety of useful editing functions, including split views of the editing window, creating and navigating to bookmarks, and commenting/uncommenting one or more lines of script.

 

ScriptSense™ is available when working within E-Studio to create or edit E-Basic script on an InLine object or on the User Script window. It is also available while working within the PackageFileEditor to create or edit PackageFiles. ScriptSense™ features either appear automatically in the editing window when you are in the appropriate context, or are activated by using a variety of short cut keys. The specific ScriptSense™ features are described below. A code completion tool which provides a dropdown choice of property, method, and data types after the user types an object name followed by a period in an InLine object or in user script.

 

ScriptSense™ Features enabled automatically
These ScriptSense features are enabled automatically when creating or editing E-Basic script.

 
Automatic line numbering
 

 

Split views
To split the current editing window in half vertically, move the cursor to the lower left- or right-hand corner of the User Script, Full Script or InLine window until it changes from the outline of an arrow to the left-right splitter control (↔) and drag to the opposite side.

 

To split the current editing window in half horizontally, move the cursor to the lower top or bottom corner of the User Script, Full Script or InLine window until it changes from the outline of an arrow to the up/ down splitter control (↕) and drag up or down.
 

 

ScriptSense™ Features enabled automatically in context

ScriptSense also provides context-sensitive information, such as showing lists of the available constants and variables, displaying the user-defined member declaration statement, and automatically converting numeric data types. These context-specific editing aids are illustrated below:

 
View a list of the available members that could correctly complete a partial text entry
 

 

View Quick Info on the E-Basic Function/Command
A dropdown list of property, method and data types appears after typing an object name followed by a period:

 

 

Attribute list
A list of all attributes that have been defined appear automatically after typing.

 

c.SetAttrib "

or

c.GetAttrib(

 

 

Error highlighting
When a compile or runtime error occurs, then E-Studio highlights the line on which the error occurred. If the error occurs in an InLine object, then the InLine object that contains the error is opened and given focus, and the offending line is highlighted.

 

 
Declared variable listing
When declaring variables with a Dim x As will show a list of all available data types appear in a dropdown list. Unique icons identify E-Objects, native data types, and keywords.

 

 

Smart Color information
When setting the color value via script, a dropdown list of the color names, a solid block of the color itself, and the RGB values appears.

 

 

ScriptSense™ Short-cut keys: General script editing
A variety of standard editing functions are activated by entering a simple short-cut key sequence. These functions and their associated short-cut keys are listed below.

 

General Editing features: Select/cut/copy/paste
 

Feature	Short-cut Key
Select all text in the current view	Ctrl+A
Move caret to end of line	Ctrl+right arrow
Move caret to beginning of line	Ctrl+left arrow
Copy the selected text	Ctrl+C or Ctrl+Insert
Cut the selected text	Ctrl+X
Cut the text on the caret’s current line	Shift+Delete
Paste the selected text to the end of the current line	Ctrl+V
Paste the selected text to the caret position on the current line	Shift+Insert
Set the selected text to lower-case	Ctrl+U
Set the selected text to upper-case	Ctrl+Shift+U
Redo previous action	Ctrl+Y
Undo previous action	Ctrl+Z
Comment and uncomment	Ctrl+'

 
General Editing: Search/find/replace
The Search/Find /Replace functions support the use of wildcards and regular expressions. E-Prime 3.0 provides the ability to search and replace between all script Windows where previous editions permitted the search/replace operation in one script window at one time.
 

 

Feature	Short-cut Key
Open the Find and Replace dialog box and set the Action to “Find”	Ctrl+F
Show the Find and Replace dialog box and set the Action to “Replace”	Ctrl+H
Find the next instance of the search term	F3
Automatically search through the active script window (InLine, User Script, or Full script) for the word under the current caret, stopping on the next instance.	Ctrl+F3
Automatically search backwards through the active script window (InLine, User Script, or Full script) for the word under the current caret, stopping on the next instance.	Shift+F3
Show the GoTo Line dialog box	Ctrl+G

 

General Editing: Working with Bookmarks
The Bookmark functions support the use of wildcards and regular expressions. All appropriate workspaces (User Script, Full Script, and InLine objects) are searched.
 

Feature	Short-cut Key
Toggle Bookmark status of current line	Ctrl+F2
Open the Mark dialog box (the Find and Replace Dialog box with action set to Mark) to enable multiple bookmarks to be set at one time	Ctrl+M
Move to next bookmark	F2
Move to previous bookmark	Shift+F2
Prompt to remove all bookmarks in the current window	Ctrl+Shift+F2
Remove all bookmarks in the current window automatically	Ctrl+M

 

General Editing: Miscellaneous features

 

Feature	Short-cut Key
Comment selected lines	Ctrl + ‘ (Ctrl + single quote)
Uncomment selected lines	Ctrl+Shift + ‘ (Ctrl + Shift + single quote)

 

ScriptSense™ Short-cut keys: Accessing E-Basic-specific information

A variety of standard editing functions are activated by entering a simple short-cut key sequence. These functions and their associated short-cut keys are listed below.

 

Feature	Short-cut Key	Example
Select a member of the E-Basic Language	Ctrl+Space
Show a listing of all constants	Ctrl+Shift+Space
Show a listing of all attributes defined within the current E-Studio experiment	Ctrl+Alt+Space
Convert numeric token under the caret to a hexidecimal (maximum size is 4 bytes)	Ctrl+Alt+H
Convert hexadecimal value under the caret to an integer (maximum size is 4 bytes)	Ctrl+Alt+I

 

Next Article: SCRIPTING: Communicating with E-Prime Objects [22874]
Previous Article: SCRIPTING: Introducing E-Basic [22871]