Navigating the Programs Module

Navigation:  Looking at the MCL-Designer V4 Work Area > The Project Modules Area >

Navigating the Programs Module

Previous pageReturn to chapter overviewNext page

 

The "Programs" module displays a tree view of all the elements contained in the project. It is possible to edit all the displayed elements in the tree view as well as add more within the module.

 

 

Detail of a Tree View

 

A – Program  See Programs.

B – Expanded Screen

C – Control  See Adding Controls to a Screen.

D – Action  See Associating Actions to a Screen.

E – Collapsed Screen

F – Screens from a program (in this case, the “P: Capture” application program)  See How to Work with Screens.

G – Local Procedure  See Local Procedures.

H – Routine  See Working with Routines.

I - Locked Element (Identified with a . Its content is NOT visible/editable or expandable.)

J - Routine In See Working with "Routine In".

K - Routine Out See Working with "Routine Out".

 

To edit an element displayed in the tree view, right-click it. This opens a menu with the related available options.

 

To add a program, right-click a blank space in the "Programs" module or the module's title to access a menu with the "Add Program" option.

As an alternative, you can right-click an existing program and select the "Duplicate Program" option - it will duplicate the selected program with all its elements.

See Creating a New Program.

 

To add a screen to a program, right-click a program, represented in the tree view, and, in the resulting menu, select the corresponding option.

As an alternative, you can right-click an existing screen and select the "Duplicate Screen" option - it will duplicate the selected screen with all its elements.

See To Create a New Screen.

 

To expand/collapse parts of the tree view - click the plus or minus signs preceding an item to expand or collapse the list of underlying items.

 

 

Available Right-click Menus

 

If you right-click the module's name when the module is expanded, it will open the following context menu:

 

Add Program

Click this option to add a program. See Creating a New Program.

Library Import

Select this option to import a program from Library. See To Import a Program from Library.

 

Right-click a program displayed in the tree view to access a menu with the following options:

 

 

Edit

Is used to open the selected program's properties window where you can edit its name and/or add notes.

If you open the properties window of the "Main" program, the "Name" option will be inactive - it is NOT possible to change the default program's name.

 

If the selected element is a locked imported program (from Library), it is NOT editable. The corresponding properties window will be inactive (displayed in gray).

Copy

Copies the selected program.

Use "Paste" to complete the operation. The "Paste" option is only available after the "Copy" option is used, when you right-click an empty space in the "Programs" module.

Paste

Pastes a copied element. Only available if there is a previous "copy" operation (of a local procedure, routine, screen, etc.)

Duplicate Program

Duplicates the selected program with all its features, screens, controls and processes.

If the selected program is a previously imported program that is "locked" (not editable), this option is NOT applicable.

Delete

Deletes the selected program.

This option is not available, if you right-click the Main Program ("P:Main") because this program cannot be deleted.

Add Local Procedure

Adds a local procedure to the selected program. See Local Procedures.

If the selected program is a previously imported program that is "locked" (not editable), this option is NOT applicable.

Add Screen

Adds a new screen to the selected program. See Setting Screen Properties.

If the selected program is a previously imported program that is "locked" (not editable), this option is NOT applicable.

Add Routine

Adds a routine to the selected program. See Working with Routines.

If the selected program is a previously imported program that is "locked" (not editable), this option is NOT applicable.

Convert to Global Procedure

Converts the selected program into a global procedure - it will be displayed in the "Procedures" module.

This option is NOT available for the "Main Program" and/or previously imported programs that are "locked".

Open All Screens

Opens all the screens included in the selected program.

If the selected program is a previously imported program that is "locked" (not editable), this option is NOT applicable.

Library Export

Exports the selected program to "Library". See To Export a Program to Library.

If the selected program is a "locked" program (not editable), this option is NOT applicable. "Locked" elements are not exportable.

Library Import

Provides import options for elements that relate to programs ("Screens" or "Routines") and programs.

See To Import a Program from Library.

See To Import a Screen from Library.

See To Import a Routine from Library.

 

These options do NOT apply to "locked" programs.

Search in ...

Opens the "Search" window. See Detail of Search.

 

The "Search in..." option in this right-click menu enables an automatic to search in the selected program.

 

Search 'xxx'

Opens the "Search" window. See Detail of Search.

 

The "Search 'xxx'" option in this right-click menu enables an automatic search of the selected text string in the current project and returns all the occurrences.

 

 

Some of the right-click menu options are not applicable if the program in question is a previously imported program that is "locked" (an Export option - see Exporting/Importing Programs). A "locked" program is not editable so, certain operations (related to a program's duplication, the adding of screens/local procedures/routines, opening all the included screens or import/export operations) are NOT executable.

If you right-click a "locked" program (identified with a ) and select options that relate to its edition, you get one of the following messages:

 

 

If you right-click a screen or an element contained within a screen, you will open a context menu related to that screen/element.

See Screens - Available Right-Click Menus.

 

Right-clicking a Routine represented in the tree view provides access to this context menu:

 

Edit

Is used to open the properties window of the selected routine. Working with Routines.

Copy

Copies the selected routine. Use the "Paste" option in the right-click menu of the destination program to complete the operation.

Delete

Deletes the selected routine.

Routine

Opens the selected routine's "Routine" tab directly.

Library Export

Provides access to the "Library Manager":

 

a. Click the "Library Export" option. This opens the "Library Manager" window.

 

b. Proceed with the export of the selected routine into Library. See To Export a Routine to Library.

Search in ...

Opens the "Search" window. See Detail of Search.

 

The "Search in..." option in this right-click menu enables an automatic to search in the selected routine.

 

Search 'xxx'

Opens the "Search" window. See Detail of Search.

 

The "Search 'xxx'" option in this right-click menu enables an automatic search of the selected text string in the current project and returns all the occurrences.

 

Right-clicking a Local Procedure, represented in the tree view, provides access to the following menu:

 

Edit

Is used to open the selected local procedure's properties window so you can edit it. See Local Procedures.

Copy

Copies the selected local procedure. Use the "Paste" option in the right-click menu of the destination element (a program or the "Local Procedure's" section) to complete the operation.

Duplicate Local Procedure

Duplicates the selected local procedure with all its processes. See Local Procedures.

Delete

Deletes the selected local procedure.

Param In

Opens the selected local procedure's "Param In" tab directly.

Param Out

Opens the selected local procedure's "Param Out" tab directly.

Procedure

Opens the selected local procedure's "Procedure" tab directly.

Search in ...

Opens the "Search" window. See Detail of Search.

 

The "Search in..." option in this right-click menu enables an automatic to search in the selected Local Procedure.

 

Search 'xxx'

Opens the "Search" window. See Detail of Search.

 

The "Search 'xxx'" option in this right-click menu enables an automatic search of the selected text string in the current project and returns all the occurrences.

 

If you right-click the general "Local Procedures" entry represented in the tree view, you open this context menu:

 

Paste

Pastes the previously copied local procedure. This option is only available after a "copy a local procedure" operation takes place.

Add Local Procedure

Adds a local procedure to the program that contains the general "Local Procedures" tree view entry. See Local Procedures.

 

Right-click outside the tree view to open the following options:

 

Paste

Pastes the previously copied program. This option is only available after a "copy a program" operation takes place.

Add Program

Adds another program to the project:

 

a. Select "Add Program" to open a new program's properties window.

b. Maintain the suggested name or enter a new one.

c. If required, add notes.

d. Click to conclude.

 

The new program is displayed in the module's tree view.

Library Import

Provides access to the "Library Manager":

 

a. Click the "Library Import" option. This opens the "Library Manager" window.

 

b. Proceed with the import of a program from Library. See To Import a Program from Library.

 

The newly imported program is displayed in the module's tree view.