Función CreateCursor (winuser.h)

Artículo
02/01/2024

Crea un cursor monocromático que tiene el tamaño, los patrones de bits y la zona activa especificados.

Para crear un cursor coloreado en tiempo de ejecución, puede usar la función CreateIconIndirect , que crea un cursor basado en el contenido de una estructura ICONINFO .

Sintaxis

HCURSOR CreateCursor(
  [in, optional] HINSTANCE  hInst,
  [in]           int        xHotSpot,
  [in]           int        yHotSpot,
  [in]           int        nWidth,
  [in]           int        nHeight,
  [in]           const VOID *pvANDPlane,
  [in]           const VOID *pvXORPlane
);

Parámetros

[in, optional] hInst

Tipo: HINSTANCE

Identificador de la instancia actual de la aplicación que crea el cursor.

[in] xHotSpot

Tipo: int

Posición horizontal del punto activo del cursor.

[in] yHotSpot

Tipo: int

Posición vertical de la zona activa del cursor.

[in] nWidth

Tipo: int

Ancho del cursor, en píxeles.

[in] nHeight

Tipo: int

Alto del cursor, en píxeles.

[in] pvANDPlane

Tipo: const VOID*

Matriz de bytes que contiene los valores de bits para la máscara AND del cursor, como en un mapa de bits monocromático. Vea Notas.

[in] pvXORPlane

Tipo: const VOID*

Matriz de bytes que contiene los valores de bits de la máscara XOR del cursor, como en un mapa de bits monocromático. Vea Notas.

Valor devuelto

Tipo: HCURSOR

Si la función se ejecuta correctamente, el valor devuelto es un identificador para el cursor.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Para determinar el tamaño nominal de un cursor, use la función GetSystemMetrics , especificando el valor SM_CXCURSOR o SM_CYCURSOR . Además, puede usar la versión compatible con PPP de esta API, consulte (GetSystemMetricsForDpi)(/windows/win32/api/winuser/nf-winuser-getsystemmetricsfordpi). Para obtener más información, vea Desarrollo de aplicaciones de escritorio con valores altos de PPP en Windows.

Para obtener más información sobre los parámetros pvANDPlane y pvXORPlane , vea descripción del parámetro lpBits de la función CreateBitmap .

CreateCursor aplica la siguiente tabla de verdad a las máscaras de bits AND y XOR:

Máscara de bits AND	Máscara de bits XOR	Pantalla
0	0	Negro
0	1	Blanco
1	0	Screen
1	1	Pantalla inversa

Antes de cerrar, una aplicación debe llamar a la función DestroyCursor para liberar los recursos del sistema asociados al cursor.

Virtualización de PPP

Esta API no participa en la virtualización de PPP. La salida devuelta es en términos de coordenadas físicas y no se ve afectada por el PPP del subproceso que realiza la llamada. Tenga en cuenta que el cursor creado todavía se puede escalar para que coincida con el PPP de cualquier ventana determinada en la que se dibuja.

Ejemplos

Para obtener un ejemplo, consulte Creación de un cursor.

Requisitos


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