W_LOAD_MENU

Syntax

handle_val = W_LOAD_MENU ( file, dir );

Input arguments

string	file	Name of the root menu.
string	dir	Name of the directory where the menu files reside.

Return Values

Success:

handle

menu_h

Handle of the menu.

Failure:

int	0	Menu does not exists or cannot be loaded.
int	-1	Script interface error.

Description

This function loads a menu hierarchy from a set of files. Processing starts from the so called "root" menu and continues until all submenus of the root have been processed. Each menu is stored in a text file of its own.

These files consist of records and comments. Each record consists of variable number of data fields. Each data field consists of a short name and value. A field is terminated by a semicolon. End of a record is an empty field. C-style comments are supported.