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.

◄Overview►                                            ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_MOU
 
USHORT MouDrawPtr(hmou)
HMOU hmou;    /* mouse handle */
 
The MouDrawPtr function enables the mouse pointer to be drawn on the screen,
using the pointer shape defined by the most recent call to the
MouSetPtrShape function. The MouDrawPtr function releases any exclusion
rectangle that may have been previously set by using the MouRemovePtr
function. An exclusion rectangle defines a rectangular region of the screen
in which MS OS/2 will not display the pointer.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hmou       Identifies the mouse. The handle must have been created
           previously by using the MouOpen function.
 
Return Value
 
The return value is zero if the function is successful. Otherwise, it is an
error value, which may be the following:
 
     ERROR_MOUSE_NO_DEVICE
 
Comments
 
The MouDrawPtr function does not itself draw the mouse pointer. Instead, it
directs MS OS/2 to call the mouse device driver at each mouse interrupt. If
the mouse device driver has been disabled (by the MouSetDevStatus function),
MouDrawPtr releases the current exclusion rectangle but does not draw the
pointer.
 
Example
 
This example creates a mouse handle then calls the MouDrawPtr function to
enable the mouse pointer to be drawn on the screen:
 
HMOU hmou;
MouOpen(0L, &hmou);
MouDrawPtr(hmou);
 
See Also
 
MouOpen, MouRemovePtr, MouSetDevStatus, MouSetPtrShape
 
                                      ♦