next up previous contents
Next: Modify Menu Button Up: Retained Menu Definition Previous: Fetch Menu Prompt

Fetch Menu Title

This Subroutine allows the Title Text on the currently setup Menu to be fetched (retrieved).

Short Name Calling Sequence

STATUS = UIFHTI(TITLE[,TILENG])

Long Name Calling Sequence

STATUS = UI_FETCH_TITLE(...)

Input Arguments

None

Output Arguments

TITLE (Character) Title Text TILENG (Integer) Length of Title Text (Optional)

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_MENU ) Illegal Menu ID UIILME )

UI__TRUNCATED ) Response Text Truncated UITRUN ) Note:

  1. This subroutine operates on the currently setup Menu as defined by a prior call to UI_DEFINE_MENU or UI_USE_MENU.
  2. The TILENG Argument is optional and, if present, will be set to the length of the Menu Title Text after any truncation.
  3. The UI__TRUNCATED Function value is informational only, no error message will be signalled.


Liz Buckle
Fri Jan 13 17:39:04 CST 1995