Compartir a través de


Función SetCursorPos (winuser.h)

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)

Consulte también

ClipCursor

Conceptual

Cursores

GetCursorPos

Referencia

SetCaretPos

SetCursor

ShowCursor