GPR_$INQ_CURSOR GPR Calls GPR_$INQ_CURSOR
NAME
gpr_$inq_cursor - returns information about the cursor.
FORMAT
gpr_$inq_cursor (curs_pat, curs_raster_op, active,
position, origin, status)
DESCRIPTION
This routine returns information about the cursor.
Output Parameters
cursor_pat
Identifier of the cursor pattern bitmap, in gpr_$bitmap_desc_t for-
mat. This is a 4-byte integer.
cursor_raster_op
Cursor raster operation code, in gpr_$raster_op_array_t format.
This is an eight-element array of 2-byte integers. The default
value is three. (The operation assigns all source values to the new
destination.)
active
A Boolean (logical) value which indicates whether the cursor is
displayed. The parameter is set to true if the cursor is displayed;
it is set to false if the cursor is not displayed.
position
The cursor's current position on the screen, in gpr_$position_t for-
mat. This data type is 4 bytes long.
origin
The pixel currently set as the cursor origin, in gpr_$position_t
format. This data type is 4 bytes long.
status
Completion status, in status_$t format.
NOTES
If a program calls this routine when in borrow mode, the x- and y-
coordinates of the cursor position represent an absolute position on the
screen. If a program calls this routine when the cursor is inside a
frame of a display manager pad or in direct mode, the x- and y-
coordinates of the cursor position are relative to the top left corner of
the frame or window.
Use one or more of the following routines to alter the cursor:
⊕ gpr_$set_cursor_pattern
⊕ gpr_$set_cursor_active
⊕ gpr_$set_cursor_position
⊕ gpr_$set_cursor_origin
Currently, a program cannot alter the cursor raster operation.