Compartir a través de


Función SetCursor (winuser.h)

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

Consulte también

Conceptual

Cursores

Creación de un cursor

CreateCursor

CreateIconIndirect

GetCursor

GetSystemMetrics

LoadCursor

LoadImage

Referencia

SetCursorPos

ShowCursor