Promotic
WikipediaLinkedInYoutubeTwitterFacebook

Object PmMenu (Menu)

Description:
The local menu of the Pmg object or the system menu of application.
Properties and methods:
AddMenu Add one item to the menu
Note:
This object is functional also for Web panels.
 
If the user opens the local menu of the Pmg object, then the PmgObject.onMenuFill event is called. In this event the PmMenu object can be filled (available in the pEvent.Menu parameter).

Then the local menu is opened with filled content.

Once the user selects the item then the menu is closed and the PmgObject.onMenuSelect event is triggered. In this event it is possible to detect which menu item was selected and execute the corresponding action.

 
Calling the Pmg object local menu:
- If the user clicks by the right mouse button over the Pmg object.
- If the "Open the local menu also by left mouse button" configurator is set then also by clicking by the left mouse button or pressing the space key.
- In script by the ShowMenu method (in special cases).
 
Application system menu work the same way. However it is called by the Alt-space keys or by clicking the mouse on the application icon. The PmaRoot.onSystemMenuFill and PmaRoot.onSystemMenuSelect events are called.
 
The fact that the script creates the local menu of the Pmg object at the moment of calling the menu, means that the local menu can hold different content at each calling.
 
Caution: The PmMenu object is valid only in the processing of the onMenuFill event. It is not allowed to save the reference to this object for the later use.
 
See: Example in the description of the AddMenu object

History:
Pm8.03.24: Multi level menus can now be created - by method AddMenu("id", "text", "type:menu;") it is now possible to add a submenu.
Pm7.03.09: Created
PROMOTIC 9.0.5 SCADA system documentation - MICROSYS, spol. s r.o.

Send page remarkContact responsible person
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice