AIM Menu Page Routines

There are several points at which custom V+ routines can be automatically called by the menu driver. These routines are summarized in AIM Menu Page Routines. The first column indicates when the routine is run and where it is specified. The second column lists the general functions the routine is intended to perform. The third column lists the reference name used by the routine. Descriptions of Menu Spawn Routines details the parameter requirements of the routine.

Table 8-3. AIM Menu Page Routines

When called/where specified	Function	Reference name
When a new page is drawn, updated, or closed. Routine specified in the page header of a menu page.	General housekeeping, set the pre-conditions for the window display	menu.pag.spawn
When a new value is entered into a database field. Routine specified in the menu item (number, string, etc.). Optionally called before a value is displayed or before a new input is parsed.	Data validation, custom formatting of output, custom parsing of input	menu.chk.spawn
When a page is first displayed or redrawn. Routine specified in the conditional item.	Execute a more complicated conditional evaluation than possible with an AIM conditional menu item	menu.cnd.spawn
When a routine spawn button is clicked. Routine specified in the button item.	Run a general purpose V+ program	menu.but.spawn
When a scrolling window is displayed, or activity takes place within the window. Routine specified in the scrolling window item.	Provide the text for a scrolling window and monitor user input to the scroll window	menu.scr.spawn
When a page is first drawn and whenever events take place within a static panel. Routine specified in the static panel item.	Execute a V+ routine that takes control of a section of a menu page	menu.pnl.spawn