4D Doc Center : CT ON MENU

4D Chart v13

CT ON MENU


CT ON MENU ( area ; method )

Parameter	Type	Description
area	Longint	4D Chart area
method	String	Name of the method to call

Description

The CT ON MENU command executes method each time a menu command is activated in either the User or Custom Menus environments. The menu command can also be called by using the CT DO COMMAND command, as long as the menu command is called in method.

The called method returns three parameters:
Parameter Description
$1 A Long integer containing the ID for the 4D Chart area.
$2 A Long integer containing the menu item number.
$3 A Long integer containing the number of the modifier key pressed.

The $3 parameter corresponds to one of the following modifier keys (or combination of modifier keys):
Value Modifier Key
0 No modifier
1 Ctrl (Windows) or Command (Macintosh) key
2 Shift key
4 Alt (Windows) or Option (Macintosh) key
8 Control key (Macintosh)

If a combination of modifier keys is pressed, the values are added together and passed as a parameter. For example, a value of 10 indicates that the user held down the Shift and Control keys while choosing a menu item

If you plan to compile your database, you should declare the types of these parameters, as follows:

C_LONGINT($1;$2;$3)

Example

This example launches the MenuProc event method.

CT ON MENU(Area;"MenuProc")

The MenuProc method controls the user’s access to menu commands. If either the Save as Template or Properties menu command is selected, the user is presented with an alert and the menu selection is ignored. All other menu items are executed without interruption.

Following is the code for the MenuProc method.

 C_LONGINT($1;$2;$3)

 Case of

    :($2=1006)&NBSP;&NBSP; `Save as Template

       ALERT("You cannot save templates.")

    :($2=2011)&NBSP;&NBSP; `Properties

       ALERT("You do not have access to Properties.")

    Else

       CT DO COMMAND(vArea;$2)

 End case