win12.hlp (Table of Contents; Topic list)
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.
WinShowPointer (1.2)
Function Group  Overview                          Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINPOINTERS
 
BOOL WinShowPointer(hwndDesktop, fShow)
HWND hwndDesktop;    /* handle of the desktop */
BOOL fShow;          /* show/hide flag        */
 
The WinShowPointer function shows or hides the mouse pointer. A pointer show
level count is kept internally. (You can retrieve this value using the
WinQuerySysValue function with SV_POINTERLEVEL as the system value.) It is
incremented by a hide operation and decremented by a show operation. The
pointer is visible only if the count is zero. If a mouse exists, the initial
setting of the pointer display level is 0. Otherwise, it is 1.
 
Parameter    Description
────────────────────────────────────────────────────────────────────────────
 
hwndDesktop  Identifies the desktop window. This parameter can be
             HWND_DESKTOP or the desktop window handle.
 
fShow        Specifies whether the pointer is shown or hidden. If TRUE, the
             pointer is made visible. If FALSE, the pointer is made
             invisible.
 
Return Value
 
The return value is TRUE if the function is successful or FALSE if an error
occurs.
 
See Also
 
WinQuerySysValue