ui.Interface.loadTopMenu()

The LoadTopMenu() method is used to load a top menu. 

 

The syntax of its invocation is as follows:

 

CALL ui.Interface.LoadTopMenu (file_name)

 

where:

ยท         file_name = a STRING variable standing for the file name containing the top menu to be loaded definition and the path which is optional (the file should be located on an application server)

 

Usage

Here is an example of the loadTopMenu() method calling:

 

#loads the top menu defined in my_topmenu_file

CALL ui.Interface.LoadTopMenu("my_topmenu_file")

 

If there is a top menu already specified for the target form, it will be replaced by the one loaded.

 

It is advisable not to specify the file extension. It is automatically added by the runtime system when the file is determined: initially the system searches for the file with the name specified with the .tm2 extension, if it does not exist the .fm2 file is being searched for. In case the file with the name specified does not exist, the corresponding runtime error occurs.

 

However, it is still possible to specify the file containing the top menu definition as "my_topmenu_file.fm2". If there is no such a file, an error will occur at runtime.

 

Third-party files containing the top menu definition are converted into the .tm2 format.