MAIN_MENU_POP

MAIN_MENU_POP N

CREATES A SYSTEM OBJECT MAIN_MENU_POP AND ALLOCATES IT NUMBER N AS REFERENCE

  • Type: Command
  • Parameter: 1
  • Group: System Objects Creation

ACTION

The command MAIN_MENU_POP N creates a system object MAIN_MENU_POP, and allocates it a number N. The number N will be used to designate the MAIN_MENU_POP.

The created MAIN_MENU_POP can then be used through the appropriated commands.

A MAIN_MENU_POP is used to design a menu system with its accompanying drop-down menus on a FORM. There is only one MAIN_MENU per FORM.

A MAIN_MENU_POP cannot generate an event. The events are attached to the SUB_MENU.

The MAIN_MENU_POP of a FORM is activated by a right click on this FORM.

Remark: by default, the MAIN_MENU_POP is created on the FORM number 0, but another FORM can be used. For that, create a FORM by FORM N, and send it all the commands by COMMAND_TARGET_IS N before creating the MAIN_MENU_POP.

SYNTAX: MAIN_MENU_POP N

  • N = system object number (integer or real). Must be greater than 0 and less than or equal to the allowed maximum number of system objects.

USE

  • A MAIN_MENU_POP is used to design a menu system with its accompanying drop-down menus (with command SUB_MENU) on a FORM. This menu is activated by a right click.

ERROR

  • If number N is not a correct expression.
  • If number N exceeds the allowed maximum number of system objects.
  • If number N is less than or equal to 0.
  • If number N is already used for a system object number.

EXAMPLE

rem create a MAIN_MENU_POP with its SUB_MENU

main_menu_pop 1

sub_menu 2

parent 2,1

caption 2,"Sub_Menu"

caption 0,"clic droit pour visualiser le MAIN_MENU_POP"

SEE ALSO

MAIN_MENU

SUB_MENU

PARENT

ON_CLICK