Local procedure

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Overview
Local procedure
Procedures local to a window
Procedures local to a report
Creating a local procedure
Creation from the code editor
Creation from the "Project explorer" pane
Displaying the list of local procedures
Deleting a local procedure
Public or private local procedure

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Local procedure

Overview

Two types of procedures are available:

Global procedure: can be used in all the processes/events of the project. This global procedure is stored in the project.
Local procedure: can be used in all processes/events that depend on the object (window, page or report) in which this procedure was declared. This local procedure is stored in the object.

Important: You must not declare two procedures with the same name (especially a global procedure and a local procedure).

Reminder:

In WLanguage, there is no distinction between the procedures and the functions. The syntaxes for declaring and using the procedures also apply to the functions.
Versions 16 and later
You have the ability to create overloaded procedures. See Prototype overload for more details.
New in version 16
You have the ability to create overloaded procedures. See Prototype overload for more details.
You have the ability to create overloaded procedures. See Prototype overload for more details.

Versions 16 and later

This feature is available for the Windows Phone applications.

New in version 16

This feature is available for the Windows Phone applications.

Versions 18 and later

This feature is available in Windows Store apps mode.

New in version 18

This feature is available in Windows Store apps mode.

Versions 21 and later

This feature is available in Universal Windows 10 App mode.

New in version 21

This feature is available in Universal Windows 10 App mode.

Local procedure

Procedures local to a window

The local procedures declared in a window can be called from all processes/events:

of the window,
of the window controls,
of local procedures associated with the window.

These procedures are stored in the window.

Limits:

The local procedures of a window cannot be used by its sibling windows.
The local procedures declared in a child window cannot be used in its parent window.

Procedures local to a report

The local procedures declared in a report can be called from all processes/events:

of the report,
of report controls,
of local procedures associated with the report.

These procedures are stored in the report.

Creating a local procedure

Creation from the code editor

To create a procedure local to the current element from the code editor:

Method 1:
- To create a local procedure, select "Insert .. New local procedure" (or press F4). To create a local procedure, on the "Code" pane, in the "Procedures" group, expand "New" and select "New local procedure" (of press F4).
- In the window that is displayed:
  - Specify the name of the procedure to create.
  - Versions 21 and later
    The option "Generate a header comment" is used to automatically generate the comment for the procedure prototype.
    See Automatic documentation of procedures for more details.
    New in version 21
    The option "Generate a header comment" is used to automatically generate the comment for the procedure prototype.
    See Automatic documentation of procedures for more details.
    The option "Generate a header comment" is used to automatically generate the comment for the procedure prototype.
    See Automatic documentation of procedures for more details.
  - Versions 19 and later
    Specify the procedure scope. The created procedure is public by default. See Public or private local procedure for more details.
    New in version 19
    Specify the procedure scope. The created procedure is public by default. See Public or private local procedure for more details.
    Specify the procedure scope. The created procedure is public by default. See Public or private local procedure for more details.
Method 2:
- To create a local procedure: select "Create a procedure .. Create an empty local procedure" from the popup menu. To create a local procedure: select "New .. New local procedure" from the popup menu.
- In the window that is displayed:
  - Specify the name of the procedure to create.
  - Versions 21 and later
    The option "Generate a header comment" is used to automatically generate the comment for the procedure prototype.
    See Automatic documentation of procedures for more details.
    New in version 21
    The option "Generate a header comment" is used to automatically generate the comment for the procedure prototype.
    See Automatic documentation of procedures for more details.
    The option "Generate a header comment" is used to automatically generate the comment for the procedure prototype.
    See Automatic documentation of procedures for more details.
  - Versions 19 and later
    Specify the procedure scope. The created procedure is public by default. See Public or private local procedure for more details.
    New in version 19
    Specify the procedure scope. The created procedure is public by default. See Public or private local procedure for more details.
    Specify the procedure scope. The created procedure is public by default. See Public or private local procedure for more details.
Versions 22 and later
Method 3: To create a local procedure:
- Position the cursor in the event "Global declarations" of the window or page.
- Type the prototype of procedure to create.
- Validate. The local procedure is automatically created.
New in version 22
Method 3: To create a local procedure:
- Position the cursor in the event "Global declarations" of the window or page.
- Type the prototype of procedure to create.
- Validate. The local procedure is automatically created.
Method 3: To create a local procedure:
- Position the cursor in the event "Global declarations" of the window or page.
- Type the prototype of procedure to create.
- Validate. The local procedure is automatically created.

Remark: To transform a section of code already entered in a local procedure into a local procedure:

Select the corresponding code.
Select "Create a procedure .. Create a procedure containing the selected code" from the popup menu.Select "New .. Create a local procedure containing the selected code" from the popup menu.
Specify:
- the procedure name.
- Versions 19 and later
  the procedure scope. The created procedure is public by default. See Public or private local procedure for more details.
  New in version 19
  the procedure scope. The created procedure is public by default. See Public or private local procedure for more details.
  the procedure scope. The created procedure is public by default. See Public or private local procedure for more details.
The procedure is created, the corresponding code is replaced by the call to the procedure with the necessary parameters.

Creation from the "Project explorer" pane

To create a local procedure from the "Project explorer" pane:

Select the element associated with the local procedure (window, page, report, ...).
Expand the element options and select "Local procedures".
Display the popup menu.
Select:
- "New local procedure".
In the window that is displayed:
- Specify the name of new local procedure.
- Versions 21 and later
  The option "Generate a header comment" is used to automatically generate the comment for the procedure prototype.
  See Automatic documentation of procedures for more details.
  New in version 21
  The option "Generate a header comment" is used to automatically generate the comment for the procedure prototype.
  See Automatic documentation of procedures for more details.
  The option "Generate a header comment" is used to automatically generate the comment for the procedure prototype.
  See Automatic documentation of procedures for more details.
- Versions 19 and later
  Specify the procedure scope. The created procedure is public by default. See Public or private local procedure for more details.
  New in version 19
  Specify the procedure scope. The created procedure is public by default. See Public or private local procedure for more details.
  Specify the procedure scope. The created procedure is public by default. See Public or private local procedure for more details.
Validate.

Displaying the list of local procedures

To display the list of local procedures, select "Display .. Local procedures" (or press F8) in the code editor.

To display the list of local procedures, press F8 in the code editor. The list of local procedures is displayed in the project explorer.

Deleting a local procedure

To delete a local procedure from the "Project explorer" pane:

Select the element associated with the local procedure (window, page, report, ...).
Expand the element options.
Expand the "Local procedures" option of the element.
Select the requested procedure.
Display the popup menu of the procedure and select "Delete".

Public or private local procedure

A local procedure is public by default: it is accessible from any code.

In some cases, it may be useful to restrict the access to a local procedure by making it "Private".

Versions 19 and later
When creating a local procedure, you have the ability to specify whether the procedure is public or private.

New in version 19
When creating a local procedure, you have the ability to specify whether the procedure is public or private.

When creating a local procedure, you have the ability to specify whether the procedure is public or private.

To modify the access mode to a local procedure:

Select the local procedure in the "Project explorer" pane.
In the popup menu of the procedure, select the new access mode::
- public.
- private.

Versions 16 and later
The color of the procedure bar changes according to its access mode:

red beginning of bar: private procedure.
standard beginning of bar: public procedure.

New in version 16
The color of the procedure bar changes according to its access mode:

red beginning of bar: private procedure.
standard beginning of bar: public procedure.

The color of the procedure bar changes according to its access mode:

red beginning of bar: private procedure.
standard beginning of bar: public procedure.

Remark: External component and private or public local procedures:
The use of private or public local procedures has an impact in the external components. Indeed, only the procedures explicitly declared as public (with the PUBLIC keyword used in their prototype) found in an external component cannot be accessed from the project that includes this component.