ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Menu functions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
<Menu>.InsertOption (Function)
In french: <Menu>.InsèreOption
Inserts a new option at a specific position. This menu option runs a procedure passed in parameter.
To add a menu option at the end of a menu, use <Menu>.AddOption.
Example
// Insert an option into the new menu
MNU_Schedule.InsertOption("MNU_Consult", "MNU_Create", "Create", Create_Schedule)
// Associate an image with the menu option
{"MNU_Create", indControl}..Image = "See.png"
Syntax

Inserting a menu option (position defined by a menu option) Hide the details

<Result> = <Source menu>.InsertOption(<Insertion option> , <Option to create> , <Caption> , <WLanguage procedure> [, <Procedure parameter>])
<Result>: Integer
Position of the option in the menu. A fatal error occurs if the menu option was not inserted.
<Source menu>: Menu name
Name of the menu where the menu option must be created and added. The menu option will be added at the end of this menu.
<Insertion option>: Character string
Name of the menu option used as base position for the insertion. The new menu option will be inserted before this position.
<Option to create>: Character string
Name of the menu option to create and to insert. 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 caption will be displayed in the window and it will allow the user 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.

Inserting a menu option (position defined by a subscript) Hide the details

<Result> = <Source menu>.InsertOption(<Insertion position> , <Option to create> , <Caption> , <WLanguage procedure> [, <Procedure parameter>])
<Result>: Integer
Position of the option in the menu. A fatal error occurs if the menu option was not inserted.
<Source menu>: Menu name
Name of the menu where the menu option must be created and inserted. The menu option will be added at the end of this menu.
<Insertion position>: Integer
Subscript of the menu option used as base position for the insertion. The new menu option will be inserted before this position.
<Option to create>: Character string
Name of the menu option to create and to insert. 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 caption will be displayed in the window and it will allow the user 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
To associate an image with a menu option, use the Image property.
Component: wd290obj.dll
Minimum version required
  • Version 23
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/19/2023

Send a report | Local help