CustomMenu

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Overview
How to proceed?
Adding an option to the CustomMenu
Deleting an option from the CustomMenu
Note
Examples
Creating an option to run an executable
Creating a menu option with macros

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

CustomMenu

Overview

The CustomMenu allows you to create a custom menu in the menu bar of WINDEV, WEBDEV and WINDEV Mobile. This feature allows you to add shortcuts to your favorite applications (calculator, ...), to open different files (charter, ...).

Note: To handle the CustomMenu, this feature must be enabled in the editor:

Select "Tools .. Options .. Options of the environment".
In the "Environment" tab, check "CustomMenu".
Validate.

Versions 19 and later
The CustomMenu is also available from the Project dashboard, via the "CustomMenu" Widget.

New in version 19
The CustomMenu is also available from the Project dashboard, via the "CustomMenu" Widget.

The CustomMenu is also available from the Project dashboard, via the "CustomMenu" Widget.

How to proceed?

Adding an option to the CustomMenu

To add an option to the CustomMenu:

Select "CustomMenu .. Customize the <CustomMenu>".Click the logo corresponding to the product version. Select "CustomMenu .. Customize the <CustomMenu>" from the menu that is displayed.
The window for configuring the CustomMenu is displayed.
Click "Add an option".
Enter a menu caption.
Enter the command lines that will be run when this option is selected. You can type:
- the executable path: type the path in the control or use the "Browse..." button.
- macros: click the "Macro" button and double-click the macro that will be added to your command line. For example, "Name of Current Project" {$ProjectName} will be replaced by the name of your project currently edited.
  The main macros are as follows:
  - {$ProjectName}: Name of current project.
  - {$ProjectDir}: Directory of current project.
  - {$FullProjectPath}: Full path of current project.
  - {$ExeName}: Name of executable generated from the current project.
  - {$ConfigName}: Name of current configuration for the current project.
  To find out the entire list of available macros, all you have to do is click the "Macro" button.
Select the runtime options of command line:
- Display the console: a console (command prompt) will be displayed.
- Leave the console opened: if a console is displayed, it will remain opened until the end of execution of program run.
- Non-locking execution: the execution of the command line will not lock the access to WINDEV, WEBDEV or WINDEV Mobile.
Select the runtime directory of program.
Enter:
- the message displayed in the status bar when the option is hovered by the mouse cursor.
- the icon displayed in front of the option in the CustomMenu.

Note: A folder or a separator can be added to a CustomMenu. A folder is used to create a sub-menu.

Deleting an option from the CustomMenu

To delete an option from the CustomMenu:

Select "CustomMenu .. Customize the <CustomMenu>".Click the logo corresponding to the product version. Select "CustomMenu .. Customize the <CustomMenu>" from the menu that is displayed.
The window for configuring the CustomMenu is displayed.
Select the menu option to delete.
Click the "Delete" button.

Note

An option of a CustomMenu can be run before or after the generation of a project configuration.

Examples

Creating an option to run an executable

This paragraph describes the operations that must be performed to create a menu option used to run an executable (the Windows calculator in this case):

Select "CustomMenu .. Customize the <CustomMenu>".Click the logo corresponding to the product version. Select "CustomMenu .. Customize the <CustomMenu>" from the menu that is displayed.
In the window for configuring the CustomMenu, click the "Add an option" button.
Type the caption: "Calculator".
Click the "Browse..." button and select the "CALC.exe" file (found in the System32 directory of Windows for example).
Type "Start the calculator" in the "Message" control and select the "CALC.exe" file again in the "Icon" control.
Validate.

You now have the ability to open as many calculators as you want from the different editors.

Creating a menu option with macros

This paragraph explains how to create a menu option by using macros. In this example, the macros will be used to open the <ProjectName>.rtf file. This file is automatically created for any new project and it contains general information about the project.

Select "CustomMenu .. Customize the <CustomMenu>".Click the logo corresponding to the product version. Select "CustomMenu .. Customize the <CustomMenu>" from the menu that is displayed.
In the window for configuring the CustomMenu, click the "Add an option" button.
Type the caption: "Project information".
Click the "Macro" button and select the "{$ProjectDir}" macro.
In the command line, type the "\" character after "{$ProjectDir}".
Click the "Macro" button again and select the "{$ProjectDir}" macro.
In the command line, type the ".rtf" characters after "{$ProjectDir}" .
Type "Information about the project" in the "Message" control.
Validate.

You can now open the ".rtf" file specific to each project.