gpr_set_cursor_mode() — Apollo Domain/OS SR10.3.5

GPR_$SET_CURSOR_MODE              GPR Calls               GPR_$SET_CURSOR_MODE


NAME
     gpr_$set_cursor_mode - sets the cursor mode to software or hardware mode.

FORMAT
     gpr_$set_cursor_mode (mode, status)

DESCRIPTION
     This routine sets the cursor mode for the current bitmap and becomes the
     default for all bitmaps subsequently created.

   Input Parameters
     mode The new cursor mode, in gpr_$cursor_mode_t format.  Possible values
          are:

          gpr_$software_cursor
               Use gpr_$software_cursor to specify software cursor mode.

          gpr_$hardware_cursor
               Use gpr_$hardware_cursor specify hardware cursor mode.

     status
          Completion status, in status_$t format.

NOTES
     Although the hardware cursor is always active, an application can make
     the cursor invisible by calling gpr_$set_cursor_pattern with the bits in
     the cursor bitmap all set to zero.

     gpr_$set_cursor_mode (gpr_$hardware_cursor) does an implicit
     gpr_$set_cursor_active(true).  Thus, if you switch from hardware to
     software cursor mode, the cursor will still be visible.
Museum
