Modify Button Field Parameters

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

Short Name Calling Sequence

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

Long Name Calling Sequence

STATUS = UI_FIELD_BUTTON(...)

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 Button Field X Position for the current Menu (when displayed in Text Mode). A negative or zero position will restore the UIPACK default.
3. The WIDTH Argument overrides the default Button Field Width for the current Menu (when displayed in Text Mode). A negative or zero Width will will restore the UIPACK default, thus utilising the complete width of the screen or Viewport.
4. The TRFLAG Argument overrides the default field truncation indicator. The default is for a descriptive string that is longer than the button 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.