pad_set_border()

PAD_$SET_BORDER                   Domain/OS                    PAD_$SET_BORDER


NAME
     pad_$set_border - add or remove a window border

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/pad.h>

     void pad_$set_border(
          ios_$id_t &stream_id,
          short &window_no,
          boolean &border,
          status_$t *status)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/pad.ins.pas';

     procedure pad_$set_border(
          in stream_id: ios_$id_t;
          in window_no: integer;
          in border: boolean;
          out status: status_$t);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/pad.ins.ftn'

           integer*4 status
           integer*2 stream_id, window_no
           logical border

           call pad_$set_border(stream_id, window_no, border, status)

DESCRIPTION
     Pad_$set_border removes or adds a border to a full window that has no
     other panes associated with it.  If pad_$create adds a pane to a border-
     less window, the border will be redrawn.  Likewise, putting the underly-
     ing pad into cooked mode will redraw the window border.

     stream_id
          The stream ID of the pad viewed by the window.

     window_no
          The number of the window whose border will be affected.  Window_no
          is an index into the window list returned by pad_$inq_windows.  A
          window_no of 1 always refers to the first window created to view the
          pad.

     border
          A Boolean argument indicating whether to add or remove a border.  If
          border is true, the window will appear with a surrounding border and
          a legend at the top.  If border is false, the window will appear
          without a border and legend, and the window's usable area will
          include the entire region it occupies on the display.

     status
          The completion status.

NOTES
     To get a full window without any panes, either create a transcript pad
     and never make a pad_$create call to add panes, or create a transcript
     pad that covers the entire window.  Another way to get a window without
     panes.  is to make an input pane invisible by using the pad_$raw call.

SEE ALSO
     pad_$inq_full_window, pad_$set_full_window.
Museum
