Share via


ClipCursor

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function confines the cursor to a rectangular area on the screen. If a subsequent cursor position (set by the SetCursorPos function or the mouse) lies outside the rectangle, Windows Mobile automatically adjusts the cursor position to keep it inside the rectangular area.

Syntax

            BOOL ClipCursor( 
            CONST RECT* 
            lpRect
            ); 
        

Parameters

  • lpRect
    [in] Long pointer to the RECT structure that contains the screen coordinates of the upper-left and lower-right corners of the confining rectangle. If this parameter is NULL, the cursor is free to move anywhere on the screen.

Return Value

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

The cursor is a shared resource. If an application confines the cursor, it must release the cursor by using this function before relinquishing control to another application.

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

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

Reference

GetClipCursor
GetCursorPos
SetCursorPos
RECT