Ed+ Program Editor

The Ed+ Program Editor is a Web-based program editor that is easily accessible from the PxPlus Web IDE and the Windows-based IDE Main Launcher. It is also used in the Webster+ Inspector for creating or editing a PxPlus program file.

Like the *IT - Integrated Toolkit, Ed+ provides some of the more common functions for creating and modifying your application programs. These functions are available as Menu Options and Tool Bar Options.

When opening PxPlus programs, NOMADS launches the *IT - Integrated Toolkit by default. To make Ed+ the default program editor, change the setting for the %NOMADS'Program_Editor property to Ed+.

(The Ed+ Program Editor was added in PxPlus 2016.)
(The ability to set Ed+ as the default program editor was added in PxPlus 2023.)

For quick access to a specific part of the file, a Book Marks list of the file's Methods and Labels is provided to the left of the main editor panel. Use the vertical scroll bar to locate the method or label you want to modify and then click on that book mark to jump directly to that location in the file.

To invoke the Ed+ program editor, use one of the following methods:

Location

Method

From the PxPlus IDE Main Launcher

Under the PxPlus IDE category, select Ed+.

From the PxPlus Web IDE

Select Ed+ from the menu bar.

From the PxPlus Command line

Enter: ED+

For this example, the Ed+ program editor was invoked from the PxPlus IDE Main Launcher (Windows), and then two existing program files were loaded:

Menu Options

The options below are described in the order in which they appear on the menu bar: File, Edit, Options, Tools, Run, Version Control, Project and Help.

Note:
If using the PxPlus Web IDE, the menu bar for the Ed+ program editor is accessed by clicking the Hamburger Menu button beside the Ed+ - Advanced Program Editor title.

 

File

Description

Keyboard Shortcuts

New

Sets up an empty "No Name" program file.

New: Ctrl+N

(Shortcut was added in PxPlus 2019.)

Open

Loads an existing program file.

If the editor is asked to open a non-program file, it will try to open the appropriate PxPlus program if the file is one of the following types:

File Type

Program

A PxPlus data file

Opens the File Update Utility

A PxPlus report file (.pvr)

Opens the Report Designer

An HTML file (.htm,.html)

Opens the HTML Editor

If the non-program file is not one of these types, a message will indicate that the file type is invalid and ask if you want the operating system to try opening the file.

(The opening of non-program files based on file type was added in PxPlus 2023.)

Open: Ctrl+O

(Shortcut was added in PxPlus 2019.)

Find Program

Locates a program file using current search rules.

If the search is unable to locate the exact file name requested but does locate an object file with the same file name ending with .pvc, you will be asked if you want to load the .pvc file.

If the search is unable to locate the file name requested either with or without the .pvc extension, a message will inform you that the file could not be located.

(The search functionality to include files ending with .pvc was added to PxPlus 2017 Update 0002.)

 

Close Program

Closes the current program file.

If you have made changes to the program without saving them, you will be asked if you want to save the changes.

Close Program: F4

Save

Saves the current program file.

If the file has no name, a message will ask if you want to save the current program as a PROGRAM or TEXT file. Respond by clicking the Program or Text button. A separate window launches for entering and saving the file name.

Save: Ctrl+S

Save As Version

Allows you to assign a version number to the current program file, along with a comment.

(The Save As Version option was added in PxPlus 2023.)

 

Save As Program

Allows you to name and save the current program file.

 

Save As Text

Saves the program file in text format.

A separate window launches for entering the file name. Clicking the Save button displays a message that asks if you also want to save this file as program code.

 

Save All

Saves all the open programs. Any unnamed programs will invoke the "Save as" logic.

(The Save All option was added in PxPlus 2023.)

 

Properties

Displays the pathname and historical information about the current program file.

(The Properties option was added in PxPlus 2023.)

 

Print

Prints the current program.

Print: Ctrl+P

(Shortcut was added in PxPlus 2019.)

Recent Files

Displays a list of recently opened program and text files.

 

Favorite Files

Displays options for adding the current file to or removing it from a list of favorites.

A current list of the files marked as favorites is also shown, which can be used when selecting a file to open.

 

Exit

Closes the editor and returns to the PxPlus IDE.

If you have made changes to a program without saving them, you will be asked if you want to save the changes.

 

 

Edit

Description

Keyboard Shortcuts

Undo

Reverses a change.

(The Undo option was added in PxPlus 2023.)

Undo: Ctrl+Z

Redo

Reverses the previous Undo operation.

(The Redo option was added in PxPlus 2023.)

Redo: Ctrl+Y

Cut

Selects and removes a segment of code to the Clipboard. You can cut a segment of code from a single line of code or a block of entire lines.

When the selection includes more than one line of code, the lines are selected in their entirety. To select a single line in its entirety, begin selection at the leftmost column of that line.

(The Cut option was added in PxPlus 2023.)

Cut: Ctrl+X

Copy

Selects and copies a segment of code to the Clipboard. You can copy a segment of code from a single line of code or a block of entire lines.

When the selection includes more than one line of code, the lines are selected in their entirety. To select a single line in its entirety, begin selection at the leftmost column of that line.

(The Copy option was added in PxPlus 2023.)

Copy: Ctrl+C

Paste

Pastes code from the Clipboard into the current program. Partial lines are inserted at the cursor location.

To insert a block of lines, place the cursor at the beginning of the line in front of which you wish to paste.

(The Paste option was added in PxPlus 2023.)

Paste: Ctrl+V

Delete

Selects and removes a segment of code.

(The Delete option was added in PxPlus 2023.)

Delete: Del

Select All

Selects the entire program.

(The Select All option was added in PxPlus 2023.)

Select All: Ctrl+A

Find and Replace

Find

Invokes the logic to search for a specified text value. The following buttons are provided:

Left/Right Arrows

Click these buttons to search for the previous/next occurrence of the specified text value.

All

Click the All button (beside the Right Arrow button) to highlight all matches in the program.

.*

The RegExp Search toggle button is available if the search text is a regular expression.

Aa

The CaseSensitive Search toggle button is available if the search is case sensitive.

\b

The Whole Word Search toggle button is used to search for the specified text value as a whole word only, rather than as part of another word.

S

The Search in Selection toggle button is used to search only in the selected text.

Find Next

Finds the next occurrence of the currently selected text.

Find Previous

Finds the previous occurrence of the currently selected text.

Replace

Invokes the logic to search for and replace the specified text value.

Enter the text value to be replaced, and then below that, enter the replacement text value. The following buttons are provided:

Left/Right Arrows

Click these buttons to search for the previous/next occurrence of the specified text value to be replaced.

All

Click the All button (beside the Right Arrow button) to highlight all matches in the program.

Replace

Click this button to replace the currently found text with the replacement text.

All

Click the All button (beside the Replace button) to replace all matches in the program.

.*

The RegExp Search toggle button is available if the search text is a regular expression.

Aa

The CaseSensitive Search toggle button is available if the search is case sensitive.

\b

The Whole Word Search toggle button is used to search for the specified text value as a whole word only, rather than as part of another word.

S

The Search in Selection toggle button is used to search only in the selected text.

(The Find and Replace sub-menu was added in PxPlus 2023.)

Find:               Ctrl+F

Find Next:       Ctrl+K

Find Previous: Ctrl+Shift+K

Replace:          Ctrl+H

Goto

Launches a separate Jump to line window for specifying a line number to go to in the program. This window consists of the following:

Line no.

Enter the line number to go to.

Go

Positions the insertion cursor at the beginning of the specified line number.

Cancel

Cancels the operation, closes the Jump to line window and returns to the main editor panel.

Goto: Ctrl+G

(Shortcut was added in PxPlus 2019.)

Autocomplete

Displays a drop-down list with suggestions for completing the current word you are typing.

Example:

    

The Autocomplete suggestions are based on PxPlus directives, system functions and system variables. It also makes suggestions based on the text already in the program; i.e. it can suggest variable names and statement labels if they already exist in the program.

If the Live Autocomplete check box (in Web Editor Preferences) is selected, the Autocomplete drop-down list will pop up automatically as you are typing without the need to manually invoke it.

(The Autocomplete option was added in PxPlus 2023.)

Autocomplete: Ctrl+Space

Advanced

Duplicate Lines

Creates a duplicate of the selected lines.

Move Lines Up

Shifts all the selected lines up one line.

Move Lines Down

Shifts all the selected lines down one line.

Sort Lines

Alphanumeric ascending sort of all selected lines.

UPPERCASE

Converts the current selection entirely into uppercase.

lowercase

Converts the current selection entirely into lowercase.

Toggle Comment

Comment/Uncomment the currently selected lines of code.

(The Advanced sub-menu was added in PxPlus 2023.)

Duplicate Lines:    Alt+Shift+Down

Move Lines Up:     Alt+Up

Move Lines Down: Alt+Down

Sort Lines:             Ctrl+Alt+S

UPPERCASE:       Ctrl+U

lowercase:             Ctrl+Shift+U

Toggle Comment:  Ctrl+/

 

Options

Description

Preferences

Launches the Web Editor Preferences window.

 

Tools

Description

Keyboard Shortcuts

Check Errors

Checks for errors in the current program.

 

Next Error

Goes to the next line that has a coding error.

(The Next Error option was added in PxPlus 2023.)

Next Error: Alt+E

Previous Error

Goes to the previous line that has a coding error.

(The Previous Error option was added in PxPlus 2023.)

Previous Error: Alt+Shift+E

Strip Line numbers

Strips line numbers from a program that currently has line numbers.

All line number references will be replaced with statement labels or *same or *next logical statement labels where applicable. You are prompted for a label prefix that will be used for the base label name for any labels that must be generated.

 

Reformat

Reorganizes the lines of code for the current program by applying proper formatting for indentation, if applicable.

 

Compare Programs

Invokes the Program Compare Utility that is used to compare different versions of a program to detect any differences.

(The Compare Programs option was added in PxPlus 2023.)

 

Macro

Macros are a sequence of keystrokes that can be recorded and then played back on demand to save time.

For example, you may have a long list that you want to reformat. Instead of doing it manually, you can record a macro of the keystrokes while making the change to one item and then play back the macro for all other items in the list.

Start Recording

Start macro keystroke recording.

Stop Recording

Stop macro keystroke recording.

Play

Play a previously recorded keystroke macro.

(The Macro sub-menu was added in PxPlus 2023.)

Start Recording: Ctrl+Alt+E

Stop Recording: Ctrl+Alt+E

Play:                   Ctrl+Shift+E

 

Run

Description

PxPlus

Opens the PxPlus command window.

PxPlus Program

Runs the current program.

Program Setup

Displays the Program Launch Setup window for entering the Lead Program, Argument List and System Parameters.

Panel

Invokes the panel specified using the Panel Setup option. If no panel was specified, the Panel Launch Setup window is invoked for specifying a Library and Panel.

Panel Setup

Displays the Panel Launch Setup window for specifying a Library and Panel.

Nomads

Launches the NOMADS Session Manager.

Utilities

Invokes the System Utilities window.

HTML Editor

Invokes the HTML Editor window.

Report Designer

Invokes the Report Designer window.

Run

Allows you to select a program to run.

(The Run menu was added in PxPlus 2023.)

Version Control

Description

TortoiseSVN Setup

Sets up TortoiseSVN.

See PxPlus Version Control System Using TortoiseSVN.

TortoiseSVN Commit

Invokes the TortoiseSVN Commit procedure to commit the modified files in the current directory to the repository. Selections are Current Program, All Open Programs, Program or File, and Directory.

See Committing Changes.

TortoiseSVN Update

Invokes the TortoiseSVN Update procedure to update files in the current directory. Selections are Program or File and Directory.

See Updating Your Files.

(The Version Control menu was added in PxPlus 2023.)

Project

Description

Create New Project

Launches the Create Project dialogue for entering a new project for the current working directory. Click the Query button to select a different working directory.

Add to Project

Launches the Add to Project dialogue for adding the current task to an existing project selected from the Project drop box.

To manage all the tasks within a project, see Project Maintenance.

For information on adding tasks to a project from other locations, see Adding Tasks to Projects from Other Locations.

(The Project menu was added in PxPlus 2023.)

Help

Description

ED+ Program Editor

Launches the Ed+ Program Editor Help.

Keyboard Shortcuts

Displays a list of all supported keyboard shortcuts.

(The Keyboard Shortcuts option was added in PxPlus 2023.)

Tool Bar Options

The tool bar options are listed below.

Tool Bar Button

Description

Load program

Loads a program from a file.

Find program

Finds a program using search rules.

If the search is unable to locate the exact file name requested but does locate an object file with the same file name ending with .pvc, you will be asked if you want to load the .pvc file.

If the search is unable to locate the file name requested either with or without the .pvc extension, a message will inform you that the file could not be located.

(The search functionality to include files ending with .pvc was added to PxPlus 2017 Update 0002.)

New program

Starts a new program and clears the edit buffer.

Save program

Saves the program.

Save As Program

Saves the program to a different file. A separate window launches for entering the file name.

Save As Text

Saves the program file in text format. A separate window launches for entering the file name. Clicking the Save button displays a message that asks if you also want to save this file as program code.

Undo

Reverses a change.

Note:
If you make a change to a file and then switch to a different file, the Undo/Redo for the modified file will be cleared.

Redo

Reverses the previous Undo operation.

Cut text

Cuts text to the Clipboard.

Copy text

Copies text to the Clipboard.

Paste text

Pastes text from the Clipboard.

Force update

Forces update of the program to the server.

Reformat current program

Reorganizes the lines of code for the current program by applying proper formatting for indentation, if applicable.

User preferences

Launches the Web Editor Preferences window for specifying additional options.

Theme

Click the drop-down arrow to select from a list of available themes for the editor display. (Default: Github)

Search

Invokes the logic to search for a specified text value. The following buttons are provided:

Left/Right Arrows

Click these buttons to search for the previous/next occurrence of the specified text value.

All

Click the All button (beside the Right Arrow button) to highlight all matches in the program.

.*

The RegExp Search toggle button is available if the search text is a regular expression.

Aa

The CaseSensitive Search toggle button is available if the search is case sensitive.

\b

The Whole Word Search toggle button is used to search for the specified text value as a whole word only, rather than as part of another word.

S

The Search in Selection toggle button is used to search only in the selected text.

Replace

Invokes the logic to search for and replace the specified text value.

Enter the text value to be replaced, and then below that, enter the replacement text value. The following buttons are provided:

Left/Right Arrows

Click these buttons to search for the previous/next occurrence of the specified text value to be replaced.

All

Click the All button (beside the Right Arrow button) to highlight all matches in the program.

Replace

Click this button to replace the currently found text with the replacement text.

All

Click the All button (beside the Replace button) to replace all matches in the program.

.*

The RegExp Search toggle button is available if the search text is a regular expression.

Aa

The CaseSensitive Search toggle button is available if the search is case sensitive.

\b

The Whole Word Search toggle button is used to search for the specified text value as a whole word only, rather than as part of another word.

S

The Search in Selection toggle button is used to search only in the selected text.

Display Shortcut List

Displays a list of all supported keyboard shortcuts.

(The Display Shortcut List option was added in PxPlus 2023.)

Help

Launches the Ed+ Program Editor Help.

Web Editor Preferences

The Web Editor Preferences window is used to specify additional options to be applied when working with the Ed+ program editor.

To invoke this window, select Preferences from the Options menu or click the User Preferences tool bar button beside the Theme drop box.

This window consists of the following:

User Identification

A locked field that displays the current User ID.

Font Size (px)

Click the drop-down arrow to select the font size in pixels. (Default: 12)

(The Font Size option was added in PxPlus 2023.)

Default Theme

Click the drop-down arrow to select the default theme from a list of available themes.

Select the Use Current text to change the default theme to match the Theme selected on the main editor panel.

Show hidden text

Select to display hidden text. (Default: Off)

Use Edit mode

Allows you to change existing statements in the program.(Default: On)

No statement numbers

If selected, statement numbers will not be shown for a file being created or opened. (Default: Off)

Suppress LET

Displays the code without LET directives. (Default: Off)

Live Autocomplete

If selected, the Autocomplete drop-down list will pop up automatically as you are typing with suggestions for completing the current word. (Default: Off)

The Autocomplete suggestions are based on PxPlus directives, system functions and system variables. It also makes suggestions based on the text already in the program; i.e. it can suggest variable names and statement labels if they already exist in the program.

(The Live Autocomplete option was added in PxPlus 2023.)

Auto Bracket

If selected, when you type an "open" square bracket, parenthesis, or double quote, the matching "close" symbol for the pair is inserted automatically. (Default: Off)

(The Auto Bracket option was added in PxPlus 2023.)

Tab Stops

Number of spaces that the insertion point will move each time the Tab key is pressed. (Default: 6)

To change, click the adjacent up/down arrows or enter the value.

(The default tab stop change from 5 to 6 was added in PxPlus 2023.)

Insert Tabs as Spaces

Tabs will be inserted as spaces instead of tabs.

Example:

If the Tab Stops option is set to 6, then six spaces will be inserted instead of a literal tab character.

(The Insert Tabs as Spaces option was added in PxPlus 2023.)

Mixed case Variables

Displays the code with mixed case variables. (Default: On)

Lower case Variables

Displays the code with lowercase variables. (Default: Off)

Lower case Directives

Displays the code with lowercase directives. (Default: Off)

List from top after Goto

Select this option when you want the Goto function (on the Edit menu) to display the specified "go to" statement number or line label as the starting line at the top of the program display. (Default: Off)

(The List from top after Goto option was added in PxPlus 2023.)

Server update

Indicates the frequency that the program is updated to the server. Click the drop-down arrow for a list of selections:

     Immediate
     5 Seconds
     10 Seconds (Default)
     20 Seconds
     30 Seconds
     1 Minute

When loading program file check for text version in <same path>.pxprg

Controls how you want to handle the possible existence of a text version (.pxprg) of the program file being loaded. Click the drop-down arrow for a list of selections:

     Yes, check and use .pxprg if found (Default)
     No, don't check for presence of .pxprg
     Ask which to use if .pxprg is present

When loading program file check if SVN source version exists

Controls how you want to handle the possible existence of a SVN source version of the program file being loaded. Click the drop-down arrow for a list of selections:

     Yes, check and use the SVN text source (Default)
     No, edit program object code and let OS update SVN
     Ask which to use if SVN text source exists

When saving a program to text file, and program file exists

Controls how you want to handle the saving of a program to a text file if a corresponding program file already exists. Click the drop-down arrow for a list of selections:

     Automatically update the program file as well (Default)
     Don't update the program file
     Ask if you also want the program file updated

Save

Saves the current settings and closes this window, returning to the main editor panel. These settings are saved to the appropriate project-related files.

(The ability to save settings by project was added in PxPlus 2023.)

Cancel

Cancels any changes to the settings and closes this window, returning to the main editor panel.