SCREEN LABEL_BORDER

SCREEN LABEL_BORDER specifies text to label a window.  If the window does not already have a border, a border will be drawn.  If the label character string is supplied, it replaces the current label.  If an empty character string is supplied, the border becomes unlabeled.

SYNTAX

SCREEN LABEL_BORDER /USING/ window_id string border_side position rendition

window_id

is an integer system field, Global Storage (GS) field, or user-defined field that contains the window ID assigned to the window.

string

is a string expression that specifies the text for the window's border.  If empty, the window becomes unlabeled.

border_side

specifies which of the window's borders contains the label.  The valid positions are:

  • @TOP or @BOR_TOP specifies the top border.
  • @BOTTOM or @BOR_BOTTOM specifies the bottom border.
  • @RIGHT or @BOR_RIGHT specifies the right border.
  • @LEFT or @BOR_LEFT specifies the left border.

position

is an integer expression that specifies the character position within the border at which the label begins.  If zero, the label is centered in the specified border.

rendition

specifies the video attributes of the border's label.  More than one attribute may be defined by separating the attributes with plus signs.

   

The valid video attributes are:

  • NORMAL specifies normal video attribute.  [default setting]
  • BLINK specifies blinking video attribute.
  • BOLD specifies bold face video attribute.
  • REVERSE specifies reverse video attribute.
  • UNDERLINE specifies underlining video attribute.

EXAMPLE

SCREEN LABEL_BORDER USING MAIN_ID, &
      "ELECTRONIC SALES '87" @TOP 0 BOLD

This example creates a centered label on the top border.

Back to Statements and Commands    Next page SCREEN LEAVE_SCREEN