pad_locate() — Apollo Domain/OS SR10.4.1

PAD_$LOCATE                       Domain/OS                        PAD_$LOCATE


NAME
     pad_$locate - locate the keyboard cursor

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

     void pad_$locate(
          ios_$id_t &stream_id,
          short *x, *y,
          char *byte,
          status_$t *status)

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

     procedure pad_$locate(
          in stream_id: ios_$id_t;
          out x, y: integer;
          out byte: char;
          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, x, y
           character byte*1

           call pad_$locate(stream_id, x, y, byte, status)

DESCRIPTION
     Pad_$locate supplies a cursor position only when a raw character is
     entered.  If the pad is in raw mode, any keystroke will do, though input
     via the Display Manager's ER command will also work while a pad is in
     cooked mode.

     The keyboard cursor must be within the pad open on stream_id.

     X and y are divided by the current scale factors.

     stream_id
          The stream ID of the pad.

     x    The x-position of the input cursor.

     y    The y-position of the input cursor.

     byte Value of the key pressed.

     status
          The completion status.

SEE ALSO
     pad_$cpr_enable, pad_$def_pfk, pad_$dm_cmd, pad_$move, pad_$set_scale.
Museum
