REVMEDIA FKB Articles - AREV, OI, REV G, jREV, JCDC, LIVEWATER,ADVANCED REVELATION, OPENINSIGHT, REVELATION G

RevMedia FKB

Document	V3I3A7
Title	Menus and Menu Drivers
Keywords	MENU DRIVER %MENUSTYLE% AREV_WINUS PULLDOWN_WINUS /LCMENUS/ MENU.BUFFER LCMENU MENU.ENV
Text	When developing end user applications it is frequently the case that the menu drivers provided by the system (AREV and PULLDOWN) do not provide all of the functionality required Extra security might be wished for or to aid learning curves the user might specify a Novell style menu structure Alternatively access may be required to some of the more esoteric aspects of the provided menu driver's functionality This article explores the system LABELLED common and subroutines ASSOCIATED WITH menus to assist in the DEVELOPMENT of more generic driver routines /%MENUSTYLE%/ Winus_name The LABELLED common area %MENUSTYLE% contains the name of the routine currently being used as the default menu driver This will normally be AREV_WINUS or PULLDOWN_WINUS /LCMENUS/ Menu_List Menu_Pos The LABELLED common area LCMENUS is used to store generic information about the position of the CURRENT option within menus (for the "Stickum" feature) The way in which it is treated differs FROM menu driver to menu driver so use %MENUSTYLE% to get the CURRENT menu style before playing WITH these variables Menu_List As menus are accessed their NAMES are loaded into an @FM delimited array of menu NAMES Each new menu name is inserted at the beginning of the array When USING the PULLDOWN menu style it can be seen that when choosing a menu selection WITH a single option a "pseudo" menu appears showing the single option and an Escape to Exit message As this is not a proper menu option a dummy variable called %%CUAWINUS_TEMP%% is inserted into Menu_List and is used for all such accesses Menu_Pos An @FM delimited list of values ASSOCIATED WITH Menu_List Each field has three values being used slightly differently in DIFFERENT menu drivers AREV < 0 1 > Amount of columns across menu (origin = 0 i e if the value is 4 this is the 5th column) < 0 2 > Row down menu (origin = 0 i e if the value is 3 this is the 3rd row) < 0 3 > Number of last option accessed PULLDOWN < 0 1 > Not Used < 0 2 > Not Used < 0 3 > Number of last option accessed MENU BUFFER(Menu_Name Flag) The system uses the function MENU BUFFER to read menus FROM disk and to update the LCMENU area by including the menu name in Menu_List and the initial coordinates in Menu_Pos It may be used in customised menu drivers To use declare as a function and pass the name of the menu to load and a flag variable which will return the position of the menu within Menu_List If the menu is being loaded for the first time the position flag will be set to 1 otherwise it will return a pointer into the ARRAYS This could be used by the developer to position the CURSOR at the appropriate "Stickum" point EG common /LCMENUS/ MENU_LIST MENU_POS declare function MENU BUFFER MENU_REC = menu buffer("TOOLS" FLAG) OPTION_TO_START_AT = MENU_POS< FLAG 3> gosub DISPLAY_MENU Customised Menu Drivers A point that no longer seems to be documented is that it is possible to replace the default system menu driver WITH one written by the developer This is because the menu driver WINUS simply acts as a despatching program to call the appropriate menu driver nominated in the environment Any replacement menu drivers written need to be suffixed WITH "_WINUS" E G NOVELL_WINUS This routine must accept 5 parameters as DEFINED in UTILITY DOC WINUS in the old (1 x) UTILITY Subdirectory Note though that if the customised menu driver is made the default the five parameters do not need to be used as described However if you ever intend to allow your menu driver to exit once it has been entered (rather than just refusing to allow escape FROM a top LEVEL menu) ensure that when exiting at the top level the CODE and COMMAND portions are nulled down or WINUS will treat them as CATALYST code and COMMANDS and try to EXECUTE them To MAKE the customised menu driver the system menu driver it is necessary to make the system "Menu Style" (as it is referred to in the environment window) equal to the name of the menu driver minus the _WINUS Thus if your driver were called NOVELL_WINUS you would set the menu style equal to NOVELL Unfortunately you cannot do this USING the environment WINDOW as it edit checks for AREV or PULLDOWN Consequently you can either PAINT COMMANDS MENU ENV and amend the TEMPLATE to permit the use of your driver or put the name of your driver (minus the _WINUS) into the environment record for the user in FIELD 82 N B If the menu is DEFINED as "unanchored" the customised menu driver must return the code and command to the CALLING routine and not attempt to process it Failure to comply WITH this directive will mean that routines like PAINT will fail to work correctly (Volume 3 Issue 3 Pages 13 14)

[revmedia/copyrigh.htm]

Page last modified: 30/01/03