Compartir a través de


Función ClipCursor (winuser.h)

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

Consulte también

Conceptual

Cursores

GetClipCursor

GetCursorPos

Otros recursos

RECT

Referencia

SetCursorPos