PCA$HELP.HLB  —  EXPAND
    PCA Command

    Expands or contracts the window associated with a screen display.

    Format

      EXPAND  [disp-name[,...]]

1  –  Parameters 

 disp-name

    Specifies a display to be expanded or contracted. You may specify
    any of the following:

    o  A predefined display: SRC, OUT, PROMPT, PLOT

    o  A display previously created with the SET DISPLAY command

    o  A pseudo-display name: %CURDISP, %CURSCROLL, %NEXTDISP,
       %NEXTOUTPUT, %NEXTPLOT, %NEXTSCROLL, %NEXTSOURCE

    If you do not specify a display, the current scrolling display,
    as established by the SELECT/SCROLL command, is chosen.

2  –  Description 

    The EXPAND command moves one or more display-window borders
    according to the qualifiers specified (/UP[:n], /DOWN[:n],
    RIGHT[:n], /LEFT[:n]).

    The EXPAND command does not affect the order of a display on
    the display pasteboard. Depending on the relative order of
    displays, the EXPAND command may cause the specified display to
    hide or uncover another display or be hidden by another display,
    partially or totally.

    Except for the PROMPT display, any display can be contracted to
    the point where it disappears (at which point it is marked as
    "removed"). It can then be expanded from that point. Contracting
    a display to the point where it disappears will cause it to
    lose any attributes that were selected for it. The PROMPT
    display cannot be contracted or expanded horizontally but can
    be contracted vertically to a height of two lines.

    A window border can be expanded only up to the edge of the
    screen. The left and top window borders cannot be expanded beyond
    the left and top edges of the display, respectively. The right
    border can be expanded up to 255 columns from the left display
    edge. The bottom border of a display can be expanded down only to
    the bottom edge of the plot's summary page display (to the end of
    the source module).

    You must specify at least one qualifier.

3  –  Qualifiers

3.1    /DOWN 

       /DOWN[:n]

    Moves the bottom border of the display down by n lines (if n is
    positive) or up by n lines (if n is negative). If n is omitted,
    the border is moved down by one line.

3.2    /LEFT 

       /LEFT[:n]

    Moves the left border of the display to the left by n lines (if n
    is positive) or to the right by n lines (if n is negative). If n
    is omitted, the border is moved to the left by one line.

3.3    /RIGHT 

       /RIGHT[:n]

    Moves the right border of the display to the right by n lines (if
    n is positive) or to the left by n lines (if n is negative). If n
    is omitted, the border is moved to the right by one line.

3.4    /UP 

       /UP[:n]

    Moves the top border of the display up by n lines (if n is
    positive) or down by n lines (if n is negative). If n is omitted,
    the border is moved up by one line.

4  –  Examples 

  PCAA> EXPAND/RIGHT:6

      The EXPAND command moves the right border of the current
      scrolling display to the right by 6 columns.

  PCAA> EXPAND/UP/RIGHT:-12 OUT2

      The EXPAND command moves the top border of display OUT2 up by 1
      line, and the right border to the left by 12 columns.

  PCAA> EXPAND/DOWN:99 SRC

      The EXPAND command moves the bottom border of display SRC down
      to the bottom edge of the screen.
Close Help