Modify Value Field Parameters

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

Short Name Calling Sequence

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

Long Name Calling Sequence

STATUS = UI_FIELD_BUTTON_VALUE(...)

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 VAlue 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 Value Field Width for the current Menu (when displayed in Text Mode). A negative Width will disable the display of the Value Text associated with each Button altogether, whilst a Width of Zero will restore the UIPACK default.
4. The TRFLAG Argument overrides the default field truncation indicator. The default is for a value string that is longer than the value 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.