Compartir a través de

Función CreateCursor (winuser.h)

  • Artículo

Crea un cursor monocromático que tiene el tamaño, los patrones de bits y el punto de acceso frecuente 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 de acceso frecuente del cursor.

[in] yHotSpot

Tipo: int

Posición vertical del punto de acceso frecuente 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 monocromo. Vea los comentarios.

[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 monocromo. Vea los comentarios.

Valor devuelto

Tipo: HCURSOR

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

Si se produce un error en la función, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Observaciones

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

Para obtener más información sobre los parámetros pvANDPlane y pvXORPlane, consulte la descripción de parámetro lpBits de 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 Monitor
0 0 Negro
0 1 Blanco
1 0 Pantalla
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 de

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, vea Crear un cursor.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de winuser.h (incluya Windows.h)
biblioteca de User32.lib
DLL de User32.dll

Consulte también

createIcon

CreateIconIndirect

destroyCursor

GetSystemMetrics

SetCursor

cursores de