windows_programming_notes.nbk: Home | Index | Next Page: SetDCPenColor | Previous Page: SetCursor

 SetCursorPos

Moves the cursor to the specified screen coordinates. If the new coordinates are not within the screen rectangle set by the most recent ClipCursor function call, the system automatically adjusts the coordinates so that the cursor stays within the rectangle.

Syntax

    BOOL SetCursorPos(
         int X,
        int Y
    );

Parameters

• X
  [in] Specifies the new x-coordinate of the cursor, in screen coordinates.
• Y
  [in] Specifies the new y-coordinate of the cursor, in screen coordinates.

Return Value

Returns nonzero if successful or zero otherwise. To get extended error information, call GetLastError.

Remarks

The cursor is a shared resource. A window should move the cursor only when the cursor is in the window's client area.

The calling process must have WINSTA_WRITEATTRIBUTES access to the window station.

The input desktop must be the current desktop when you call SetCursorPos. Call [OpenInputDesktop] to determine whether the current desktop is the input desktop. If it is not, call [SetThreadDesktop] with the HDESK returned by [OpenInputDesktop] to switch to that desktop.

Function Information

• Minimum DLL Version user32.dll
• Header Declared in Winuser.h, include Windows.h
• Import library User32.lib
• Minimum operating systems Windows 95, Windows NT 3.1
• Unicode Implemented as Unicode version.

windows_programming_notes.nbk: Home | Index | Next Page: SetDCPenColor | Previous Page: SetCursor

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time