Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function displays or hides the cursor.

Syntax

int ShowCursor( 
  BOOL 
bShow
); 

Parameters

bShow

[in] Boolean that specifies whether the internal display counter is to be incremented or decremented. If bShowis TRUE, the display count is incremented by one. If bShowis FALSE, the display count is decremented by one.

Return Value

The return value specifies the new display counter.

Remarks

This function sets an internal display counter that determines whether the cursor should be displayed. The cursor is displayed only if the display count is greater than or equal to 0. If a mouse is installed, the initial display count is 0. If no mouse is installed, the display count is –1.

Requirements

Header winuser.h
Library Cursor.lib, Mcursor.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also