pad_move() — Apollo Domain/OS SR10.3.5

PAD_$MOVE                         Domain/OS                          PAD_$MOVE


NAME
     pad_$move - move the output cursor

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

     void pad_$move(
          ios_$id_t &stream_id,
          pad_$rel_abs_t &rel_abs,
          short &x, &y,
          status_$t *status)

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

     procedure pad_$move(
          in stream_id: ios_$id_t;
          in rel_abs: pad_$rel_abs_t;
          in x, y: integer;
          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, rel_abs, x, y

           call pad_$move(stream_id, rel_abs, x, y, status)

DESCRIPTION
     Pad_$move changes the position of the output cursor, which marks the
     location in a pad where the next output will appear.

     stream_id
          The stream ID of the pad.

     rel_abs
          This indicates whether the new cursor coordinates are relative or
          absolute.  Specify one of the following predefined values:

          pad_$relative
               X and y are coordinates relative to the last cursor position.
               The coordinates are offsets to the current cursor position,
               scaled according to the current scale factors.

          pad_$absolute
               X and y are absolute coordinates.  The coordinates are offsets
               from a fixed origin and scaled according to the current scale
               factors.  The origin within a frame is the upper left corner of
               the frame.  The origin outside a frame is the left end of the
               current line.

     x    The horizontal coordinate of the cursor position.  If pad_$relative
          is specified for rel_abs, then x can be positive or negative.  If
          pad_$absolute is specified for rel_abs, then x must be positive.

     y    The vertical coordinate of the cursor position.  If pad_$relative is
          specified for rel_abs, then y can be positive or negative.  If
          pad_$absolute is specified for rel_abs, then y must be positive.
          The y-coordinate is meaningful only within frames.  If the output
          cursor is not currently in a frame, the value of y is ignored.

     status
          The completion status.

SEE ALSO
     pad_$cooked, pad_$cpr_enable, pad_$locate, pad_$raw, pad_$set_scale.
Museum
