ShowCursor Function

The ShowCursor function displays or hides the cursor.

Syntax

int ShowCursor(      
    BOOL bShow
);

Parameters

bShow
[in] Specifies whether the internal display counter is to be incremented or decremented. If bShow is TRUE, the display count is incremented by one. If bShow is 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.

Function Information

Minimum DLL Versionuser32.dll
HeaderDeclared in Winuser.h, include Windows.h
Import libraryUser32.lib
Minimum operating systems Windows 95, Windows NT 3.1
UnicodeImplemented as Unicode version.

See Also

Tags :


Community Content

dmex
vb.net syntax
<DllImport("user32.dll", CharSet:=CharSet.Auto, ExactSpelling:=True)> _
Public Shared Function ShowCursor(ByVal show As Boolean) As Integer
End Function
Tags : vb.net syntax

dmex
c# syntax
[DllImport("user32.dll", CharSet=CharSet.Auto, ExactSpelling=true)]
public static extern int ShowCursor(bool show);
Tags : c# syntax

Thomas Lee
Alternative to unmanaged API
If you are using Windows Forms as the basis for your application, then consider using System.Windows.Forms.Cursor's show method. For more informatin about the System.Windows.Forms.Cursor class, see http://msdn.microsoft.com/en-us/library/system.windows.forms.cursor.aspx. For more information on the show method, see: http://msdn.microsoft.com/en-us/library/system.windows.forms.cursor.show.aspx.

Tags :

Page view tracker