Función ClipCursor (winuser.h)

Artículo
03/04/2024

Limita el cursor a un área rectangular en la pantalla. Si una posición posterior del cursor (establecida por la función SetCursorPos o el mouse) se encuentra fuera del rectángulo, el sistema ajusta automáticamente la posición para mantener el cursor dentro del área rectangular.

Sintaxis

BOOL ClipCursor(
  [in, optional] const RECT *lpRect
);

Parámetros

[in, optional] lpRect

Tipo: const RECT*

Puntero a la estructura que contiene las coordenadas de pantalla de las esquinas superior izquierda e inferior derecha del rectángulo de confinación. Si este parámetro es NULL, el cursor es libre de moverse en cualquier parte de la pantalla.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

El cursor es un recurso compartido. Si una aplicación limita el cursor, debe liberar el cursor mediante ClipCursor antes de renunciar al control a otra aplicación.

El proceso de llamada debe tener WINSTA_WRITEATTRIBUTES acceso a la estación de ventanas.

Ejemplos

Para obtener un ejemplo, vea Confining a Cursor( Confining a Cursor).

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll