Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                      ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_DOSDEVIOCTL
 
USHORT DosDevIOCtl(0L, pplPosition, 0x0059, 0x0007, hDevice)
PPTRLOC pplPosition;    /* pointer to structure with pointer position */
HFILE hDevice;          /* device handle                              */
 
The MOU_SETPTRPOS function sets a new screen position for the pointer
image.
 
Parameter    Description
────────────────────────────────────────────────────────────────────────────
 
pplPosition  Points to the PTRLOC structure that contains the new position
             for the pointer.
 
hDevice      Identifies the pointing device that receives the device-control
             function. The handle must have been created previously by using
             the DosOpen function.
 
Return Value
 
The return value is zero if the function is successful or an error value if
an error occurs.
 
Comments
 
The coordinate values depend on the display mode. If the display is in text
mode, character-position values are used. If the display is in graphics
mode, pel values are used.
 
This function has no effect on the current exclusion-rectangle definitions.
If a pointer image is already defined for the screen group, it is replaced
by the new pointer image.
 
If the pointer image is directed into an existing exclusion rectangle, it
remains hidden (invisible) until sufficient movement places the pointer
outside the exclusion rectangle or until the exclusion rectangle is
released.
 
See Also
 
DosOpen, MOU_GETPTRPOS, PTRLOC
 
                                      ♦