Función SetCursorPos (winuser.h)

Artículo
03/04/2024

Mueve el cursor a las coordenadas de pantalla especificadas. Si las nuevas coordenadas no están dentro del rectángulo de pantalla establecido por la llamada de función ClipCursor más reciente, el sistema ajusta automáticamente las coordenadas para que el cursor permanezca dentro del rectángulo.

Sintaxis

BOOL SetCursorPos(
  [in] int X,
  [in] int Y
);

Parámetros

[in] X

Tipo: int

Nueva coordenada x del cursor, en coordenadas de pantalla.

[in] Y

Tipo: int

Nueva coordenada y del cursor, en coordenadas de pantalla.

Valor devuelto

Tipo: BOOL

Devuelve un valor distinto de cero si es correcto o cero de lo contrario. Para obtener información de error extendida, llame a GetLastError.

Comentarios

El cursor es un recurso compartido. Una ventana debe mover el cursor solo cuando el cursor está en el área cliente de la ventana.

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

El escritorio de entrada debe ser el escritorio actual al llamar a SetCursorPos. Llame a OpenInputDesktop para determinar si el escritorio actual es el escritorio de entrada. Si no es así, llame a SetThreadDesktop con el HDESK devuelto por OpenInputDesktop para cambiar a ese escritorio.

Ejemplos

Para obtener un ejemplo, vea Usar el teclado para mover el 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 (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-window-l1-1-2 (introducido en Windows 10, versión 10.0.10240)