MenuInsertOption (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

MenuInsertOption (Function)

In french: MenuInsè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 MenuAddOption.

Versions 16 and later

This function is now available for WINDEV applications in Linux.

New in version 16

This function is now available for WINDEV applications in Linux.

Example

// Insert an option into the new menu
MenuInsertOption("MNU_Schedule", "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> = MenuInsertOption(<Source menu> , <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 (with or without quotes)

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 (with quotes)

Name of the menu option to create and to insert. This name will be used to handle the menu option by programming. A fatal error occurs if this name corresponds to an existing option.

<Caption>: Character string (with quotes)

Caption 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> = MenuInsertOption(<Source menu> , <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.