SUB_MENU

SUB_MENU N

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

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

ACTION

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

The created Sub_Menu can then be used through the appropriated commands (PARENT, CAPTION, ON_CLICK, ...).

A SUB_MENU is a part of accompanying drop-down menus of the MAIN_MENU or MAIN_MENU_POP of a FORM.

A SUB_MENU can generate the event : ON_CLICK.

SYNTAX: SUB_MENU 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 SUB_MENU is used to design the accompanying drop-down menus of the MAIN_MENU or MAIN_MENU_POP of a FORM.

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 the more simple menu

rem 1 - create a main_menu

main_menu 1

rem 2 - create a sub_menu

sub_menu 2

rem 3 - son of the main_menu

parent 2,1

rem 4 - and gives it a text to display

caption 2,"File"

SEE ALSO

MAIN_MENU

MAIN_MENU_POP

PARENT

ON_CLICK