You are here: Development Standards > Routines > General Routines > GENGUFNC.PUB

# GENGUFNC.PUB

GENGUFNC.PUB is a public program that performs several functions that set up GUI screens for OSAS. This program returns various menu strings for use on menu bars, builds the standard tool bar, and sets up the status bar. The program contains six entry points, which all exit from the same exit point.

BUILD_MENU_STRINGS

This entry point returns strings that contain the Help menu and the standard menu containing the Commands, Edit, Modes, and Other menus. The Help menu is commonly the last menu on the menu bar, and is returned in a separate string so that you can insert other menus before the Help menu.

`1020 BUILD_MENU_STRINGS:`
`1030 ENTER MENUHLP$,MENU1$,GENINPUT$`

Variable | Description
MENUHLP$ | String containing the Help menu structure
MENU1$ | String containing the Commands, Edit, Modes, and Other menu structure
GENINPUT$ | String template used by GENINPUT.PUB. See GENINPUT.PUB routine for variable details.

Exit Points | Explanation
EXIT | GENGUFNC.PUB does not normally return an error.
EXIT ERR | GENGUFNC.PUB returns an error if one occurs.

BUILD_HLE_MENU

This entry point returns a string that contains the scroll region menu. It is used by functions that permit movement, Insert, Jump, and Delete within a scroll region.

`1505 BUILD_HLE_MENU:`
`1510 ENTER MENU$`

Variable | Description
MENU | String containing the Scroll Commands menu

DISPLAY_TOOLBAR

This entry point builds the standard tool bar on the current GUI screen. This entry point is always used by GENGURES.PUB. You may call it separately if necessary.

`2010 DISPLAY_TOOLBAR:
2020 ENTER OSGUI$`

Variable | Description
OSGUI$ | GUI template (see GENGURES.PUB for more detail)

BUILD_GRAPHICAL_TOOLBAR

This entry point builds the standard menu tool bar for the Graphical-style menu only. This entry point is used by RMMENU2 only.

`2705 DISPLAY_TOOLBAR:`
`2707 ENTER OSGUI$`

Variable | Description
OSGUI$ | GUI template (see GENGURES.PUB for more detail)

BUILD_STATUS_BAR

This entry point builds the standard status bar on the current GUI screen. This entry point is always used by GENGURES.PUB. You may call it separately if necessary.

`3005 DISPLAY_STATUS_BAR:`
`3010 ENTER OSGUI$`

Variable | Description
OSGUI$ | GUI template (see GENGURES.PUB for more detail)

BUILD_ITEM_LOOKUP_MENU_STRINGS

This entry point returns a string that contains the Item Lookup menu. This menu is used by functions that permit the use of the Inventory lookup functions (Alias Lookup, Customer/Vendor lookup, etc.).

`3510 BUILD_ITEM_LOOKUP_MENU_STRINGS:`
`3520 ENTER MENU1$`

Variable | Description
MENU1$ | String containing the Inventory Lookup menu.