MenuAddMenu (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

MenuAddMenu (Function)

In french: MenuAjouteMenu

Not available

Adds a new menu into a window or into a page. This menu can contain other menus, menu options, separators, ...

To insert a menu at a specific location, use MenuInsertMenu.

Versions 16 and later

This function is now available for PHP sites.

This function is now available for WINDEV applications in Linux.

New in version 16

This function is now available for PHP sites.

This function is now available for WINDEV applications in Linux.

This function is now available for PHP sites.

This function is now available for WINDEV applications in Linux.

Example

// Adds a new menu
MenuAddMenu(MENU_MyMenu, "OPT_Schedule", "Schedule")
// Adds an option into the new menu
MenuAddOption("OPT_Schedule", "OPT_Create", "Create", Create_Schedule)
// Associates an image with the menu option
{"OPT_Create", indControl}..Image = "schedule.png"
// Adds a separator
MenuAddSeparator("OPT_Schedule")
// Adds a new option
MenuAddOption("OPT_Schedule", "OPT_View", "View", View_schedule)

Syntax

Adding a menu Hide the details

<Result> = MenuAddMenu(<Source menu> , <Menu to create> , <Caption>)

<Result>: Integer

Position of the menu. A fatal error occurs if the menu was not added.

<Source menu>: Menu name

Name of the menu into which the new menu must be added. The new menu will be added at the end of this menu.
This menu name must not correspond to a main menu.

<Menu to create>: Character string (with quotes)

Name of the menu that must be added. This name will be used to handle the menu by programming. A fatal error occurs if this name corresponds to an existing menu.

<Caption>: Character string (with quotes)

Caption of the new menu. The caption will be displayed in the window or in the page.

Versions 18 and later

Adding a menu while associating it with WLanguage code Hide the details

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

<Result>: Integer

Position of the menu. A fatal error occurs if the menu was not added.

<Source menu>: Control name

Name of the menu into which the new menu must be added. The new menu will be added at the end of this menu. This menu name must not correspond to a main menu.

<Menu to create>: Character string (with quotes)

Name of the menu that must be added. This name will be used to handle the menu by programming. A fatal error occurs if this name corresponds to an existing menu.

<Caption>: Character string (with quotes)

Caption of the new menu. This caption will be displayed in the page.

<WLanguage procedure>: Procedure name

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

<Procedure parameter>: Any optional type

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

New in version 18

Adding a menu while associating it with WLanguage code Hide the details

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

<Result>: Integer

Position of the menu. A fatal error occurs if the menu was not added.

<Source menu>: Control name

Name of the menu into which the new menu must be added. The new menu will be added at the end of this menu. This menu name must not correspond to a main menu.

<Menu to create>: Character string (with quotes)

Name of the menu that must be added. This name will be used to handle the menu by programming. A fatal error occurs if this name corresponds to an existing menu.

<Caption>: Character string (with quotes)

Caption of the new menu. This caption will be displayed in the page.

<WLanguage procedure>: Procedure name

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

<Procedure parameter>: Any optional type

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

Adding a menu while associating it with WLanguage code Hide the details

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

<Result>: Integer

Position of the menu. A fatal error occurs if the menu was not added.

<Source menu>: Control name

Name of the menu into which the new menu must be added. The new menu will be added at the end of this menu. This menu name must not correspond to a main menu.

<Menu to create>: Character string (with quotes)

Name of the menu that must be added. This name will be used to handle the menu by programming. A fatal error occurs if this name corresponds to an existing menu.

<Caption>: Character string (with quotes)

Caption of the new menu. This caption will be displayed in the page.

<WLanguage procedure>: Procedure name

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

<Procedure parameter>: Any optional type

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

Component : wd250obj.dll