Función SetCursor (winuser.h)

Artículo
12/22/2023

Establece la forma del cursor.

Sintaxis

HCURSOR SetCursor(
  [in, optional] HCURSOR hCursor
);

Parámetros

[in, optional] hCursor

Tipo: HCURSOR

Identificador del cursor.

El cursor debe haber sido creado por la función CreateCursor o CreateIconIndirect o cargada por loadCursor o por la función LoadImage .

Si este parámetro es NULL, el cursor se quita de la pantalla.

Valor devuelto

Tipo: HCURSOR

El valor devuelto es el identificador del cursor anterior, si había uno.

Si no había ningún cursor anterior, el valor devuelto es NULL.

Comentarios

El cursor solo se establece si el nuevo cursor es diferente del anterior; de lo contrario, la función devuelve inmediatamente.

El cursor es un recurso compartido. Una ventana debe establecer la forma del cursor solo cuando el cursor está en su área cliente o cuando la ventana captura la entrada del mouse. En sistemas sin un mouse, la ventana debe restaurar el cursor anterior antes de que el cursor salga del área de cliente o antes de renunciar al control a otra ventana.

Si la aplicación debe establecer el cursor mientras está en una ventana, asegúrese de que el cursor de clase de la clase de la ventana especificada esté establecido en NULL. Si el cursor de clase no es NULL, el sistema restaura el cursor de clase cada vez que se mueve el mouse.

El cursor no se muestra en la pantalla si el recuento interno de la pantalla del cursor es menor que cero. Esto ocurre si la aplicación usa la función ShowCursor para ocultar el cursor más veces que para mostrar el cursor.

Ejemplos

Para obtener un ejemplo, vea Mostrar un 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