Setup new Operation Mode

This Subprogram allows a Programmer to specify a new Operation Mode for the Package. This determines whether Menus are prompted, displayed as text or graphically.

Short Name Calling Sequence

STATUS = UIOPMD(MODE[,OLDMOD])

Long Name Calling Sequence

STATUS = UI_OPERATION_MODE(...)

Input Arguments

MODE (Integer) Operation Mode

Output Arguments

OLDMOD (Integer) Old Operation Mode (Optional)

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_MODE ) Illegal Operation Mode IOILMD )

Note:

1. This Subprogram may be called at any time after UIPACK has been initialised.
2. The valid Operation Modes are:-

   UIPROMPTEDMODE ) Prompted Mode UIPRMD )

   UISCROLLMODE ) Text Scroll Mode UISCMD )

   UIVIEWTEXTMODE ) Viewport/Text Mode UIVTMD )

   UIVIEWCURSORMODE ) Viewport/Cursor Mode UIVCMD )

   UIGRAPHICSMODE ) Graphics Mode UIGRMD )

   where these Parameters are defined in an Include file described in Appendix B.

3. UI_GRAPHICS_MODE is only valid if the Graphical Version of the UIPACK Library (see Appendix B.2) has been linked to.
4. UI_INQUIRE_LIBRARY may be used to determine whether a specified Operation Mode is supported by the current UIPACK Library.
5. The present Operation Mode of the package will remain unchanged if the MODE argument does not correspond to a valid Operation Mode.
6. The OLDMOD Argument is Optional and, if present, will be set to the Old Operation Mode prior to this call.