Modify Response Field Parameters

This Subroutine allows the Response Field Position, Width and Truncation Indicator for Text Action Menus to be modified.

Short Name Calling Sequence

STATUS = UIFIBR([XCOR,WIDTH,TRFLAG])

Long Name Calling Sequence

STATUS = UI_FIELD_BUTTON_RESPONSE(...)

Input Arguments

XCOR (Integer) X-Cor (Optional) WIDTH (Integer) Width (Optional) TRFLAG (Logical) Truncation FLag (Optional)

Output Arguments

None

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_MENU ) Illegal Menu ID UIILME ) 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 XCOR Argument overrides the default Response Field X Position for the current Menu (when used as an Action Menu and displayed in Text Mode). A negative or zero position will restore the UIPACK default.
3. The WIDTH Argument overrides the default Response Field Width for the current Menu (when used as an Action Menu and displayed in Text Mode). A negative Width will disable the display of the Response Text associated with each Button altogether, whilst a Width of Zero will restore the UIPACK default. This default is for not more than 1/3 of the Screen Width (in Prompted or Scroll Modes) or Viewport Width (in ViewText or ViewCursor Modes) to be allocated to the Response Text Display. This default can be overridden by specifying a positive Width.
4. The TRFLAG Argument overrides the default field truncation indicator. The default is for a response string that is longer than the response field width to be terminated by ellipsis (...). This default may be overridden by setting TRFLAG as .FALSE.
5. All Arguments are optional and, if omitted, will result in the UIPACK default being restored.