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
Referencia