Use Mixed Arithmetic Menu Temporary

This Subprogram will display a Menu containing the specified Buttons and prompt the User to modify any of the Mixed Arithmetic values displayed.

Short Name Calling Sequence

STATUS = UITEMX(TITLE,PROMPT,BUTEXT,NBUTTS, & TYPES,ITEMS[,LOLIM,HILIM])

Long Name Calling Sequence

STATUS = UI_TEMP_MIXED_MENU(...)

Input Arguments

TITLE (Character) Menu Title PROMPT (Character) Menu Prompt BUTEXT (Character Array) Button Descriptive Text NBUTTS (Integer) No. of Buttons TYPES (Integer Array) Type Flags ITEMS (Array) Defaults LOLIM (Array) Lower Limits (Optional) HILIM (Array) Upper Limits (Optional)

Output Arguments

ITEMS (Array) Values

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_BUTTON ) Illegal No. of Buttons UIILBU )

UI__NO_INPUT ) No Input present UINOIN )

UI__INPUT_ABORTED ) Input Aborted (Ctrl-Z) UIABRT )

UI__END_OF_FILE ) End-of-File detected UIEOF ) in Batch Mode Note:

1. In ViewText Mode of Operation, if the Menu Viewport is hidden (invisible) it will be displayed and then hidden once the User has responded to the Menu Prompt. If the Viewport should be kept visible it must be made explicitly visible (via a call to UI_DISPLAY_VIEWPORT) prior to this call.
2. It is possible that the Menu Viewport is still hidden by other visible Viewports if its priority is lower than them. It is the Application Programmers responsibility to ensure that the relative priorities are adjusted so as to avoid this.
3. NBUTTS may lie in the range 1-256.
4. The TYPES Array identifies which ITEMS Array elements are Integer and which are Real etc. Each Element within TYPES may be set to one of the following values:-

   UIHEXADECIMAL   ) Hexadecimal Value
   UIHEXA          )
   
   UIINTEGER       ) Integer Value
   UIINTG          )
   
   UILOGICAL       ) Logical (True/False) Value
   UILOGI          )
   
   UIONOFF         ) Logical (On/Off) Value
   UIONOF          )
   
   UIOCTAL         ) Octal Value
   UIOCTA          )
   
   UIREAL          ) Real (Floating) Value
   UIREAL          )
   
   UITEXT          ) Text (4 characters) Value
   UITEXT          )
   
   UIYESNO         ) Logical (Yes/No) Value
   UIYESN          )
   

   The corresponding element in ITEMS is assumed to conform to the specified format. These Parameters are defined in an Include File described in Appendix B.

5. The range of allowed values for each array element may be limited by specifying the optional LOLIM and HILIM arrays. These should contain a mix of Real, Integer etc. values as specified by the TYPES Array. They are ignored for Logical or Text Value Types.
6. FORTRAN-77 considerations mean that Text Value Types may only be specified to have up to 4 characters and are represented by Hollerith strings. If more than 4 characters are desired, use a Text Menu (see UI_TEMP_TEXT_MENU),
7. UI__NO_INPUT will only be returned in Asynchronous Mode and indicates that the User has not yet specified any Input. The Application Program should poll using UI_TEST_INPUT until this indicates that some Input has been received, and recall this Subprogram.
8. The UI__INPUT_ABORTED Function Value indicates that the User typed Ctrl-Z to abort input. This is only implemented on a VAX/VMS system. It is an informational function value only, no error message will be reported.
9. The UI__END_OF_FILE Function Value indicates that an End-of-File was detected on the main Input Stream in Batch or non-interactive mode where Input is not taken from a terminal but rather from a file. It is a severe error and therefore causes an error to be reported (unless this has been inhibited by a prior call to UI_ERROR_LEVEL).