winuser.h


ClipCursor

La función ClipCursor confina el cursor a un área rectángular de la pantalla. Si un cambio de posición del cursor (hecha por la función SetCursorPos o por el ratón) queda fuera del rectángulo, Windows ajusta automáticamente la posición para que el cursor permanezca dentro del área rectángular.

Sintaxis

BOOL ClipCursor(
    CONST RECT *lpRect  // puntero a estructura con rectángulo
   );

Parámetros

lprc: puntero a estructura RECT que contiene las coordenadas de pantalla de las esquinas superior izquierda e inferior derecha del rectángulo de confinamiento. Si este parámetro es NULL, el cursor quedará libre de moverse a cualquier parte de la pantalla.

Valor de retorno

Si la función tiene éxito, el valor de retorno es distinto de cero.

Si la función falla, el valor de retorno es cero. Para obtener más información sobre el error, llamar a GetLastError.

Observaciones

El cursor es un recurso compartido. Si una aplicación confina el cursor, debe liberarlos usando ClipCursor antes de ceder el control a otra aplicación.

El proceso que llame debe tener el acceso WINSTA_WRITEATTRIBUTES a la estación de la ventana.