MenuAddOption (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Menu functions

Prefix syntax

MenuAddOption

Presentation

Example

Associating an image with a menu option

Related examples

See also

MenuAddOption (Function)

In french: MenuAjouteOption

Not available

Adds a new option after the last option of a drop-down or context menu. This menu option executes a WLanguage procedure. To insert a menu option at a specific location, use MenuInsertOption.

Reminder: The name of the main menu is defined:

in the description window of the window.
in the description window of the menu.

Example

// Ajoute un nouveau menu dans le menu MENU_MonMenu
MenuAddMenu(MENU_MonMenu, "OPT_Planning", "Planning")
// Ajoute une option dans le nouveau menu OPT_Planning
MenuAddOption("OPT_Planning", "OPT_Créer", "Créer", Créer_Planning)
// Associe une image à l'option de menu OPT_Créer
{"OPT_Créer", indControl}..Image = "planning.png"
// Ajoute un séparateur
MenuAddSeparator("OPT_Planning")
// Ajoute une nouvelle option (OPT_Voir)
MenuAddOption("OPT_Planning", "OPT_Voir", "Voir", Voir_planning)

Syntax

<Result> = MenuAddOption(<Source menu> , <Option to create> , <Caption> , <WLanguage procedure> [, <Procedure parameter>])

<Result>: Integer

Position of the option in the menu. If the option is not added, a fatal error occurs.

<Source menu>: Menu name

Name of the menu to which the menu option should be added. The option will be added after the last option in this menu.
Remark: This name can correspond to a context menu.
Context menus are not available.

<Option to create>: Character string

Name of the menu option to add. This name will be used to programmatically handle the menu option.
If there is an option with the same name, a fatal error occurs.

<Caption>: Character string

Text of the new menu option. This text will be displayed in the window and will allow users to select the option.

<WLanguage procedure>: Procedure name

Name of the WLanguage procedure called when the menu option is selected.

<Procedure parameter>: Optional variant

Parameter that can be passed to <WLanguage procedure> when the menu option is selected by the user.

Remarks

Associating an image with a menu option

To associate an image with a menu option, use the Image property.

Related Examples:

Sample components (WINDEV): WD LastDocuments

[ + ] This example explains how the list of last opened documents can be added to the application menu.
This insertion is performed via a class proposed in the "LastDocuments" component.
Four code lines are sufficient to insert the list of last opened documents into an existing application.
These processes can be found in:
- the declaration code of the global variables of the main window,
- the code of the OpenDocument procedure,
- the code of the menu options "File 1" to "File 10".
The example has been simplified regarding the number of features (text files only) in order to highlight the use of the component.

Component: wd280obj.dll