winuser.h


CreateCursor

La función CreateCursor crea un cursor que tenga el tamaño, patrones de bits y punto activo especificados.

Sintaxis

HCURSOR CreateCursor(
    HINSTANCE hInst,        // manipulador de instancia de aplicación
    int xHotSpot,           // posición horizontal del punto activo
    int yHotSpot,           // posición vertical del punto activo
    int nWidth,             // ancho del cursor
    int nHeight,            // alto del cursor
    CONST VOID *pvANDPlane, // puntero a un array de máscaara de bits AND
    CONST VOID *pvXORPlane  // puntero a un array de máscaara de bits XOR
   );

Parámetros

hInst: identifica la instancia actual de la aplicación que crea el cursor.

xHotSpot: especifica la posición horizontal del punto activo del cursor.

yHotSpot: especifica la posición vertical del punto activo del cursor.

nWidth: especifica la anchura, en pixels, del cursor.

nHeight: especifica la altura, en pixels, del cursor.

pvANDplane: puntero a un array de bytes que contiene los valores de los bits para una máscara AND del cursor, como en un mapa de bits monocromo dependiente del dispositivo.

pvXORplane: puntero a un array de bytes que contiene los valores de los bits para una máscara XOR del cursor, como en un mapa de bits monocromo dependiente del dispositivo.

Valor de retorno

Si la función tiene éxito, el valor de retorno identificará el cursor.

Si la función falla, el valor de retorno es NULL. Para obtener información adicional sobre el error, llamar a GetLastError.

Observaciones

Los parámetros nWidth y nHeight deben especificar una anchura y altura que sean soportadas por el manejador del display actual, ya que el sistema no puede crear cursores de otros tamaños. Para determinar la anchura y altura soportada por el manejador del display, se usa la función GetSystemMetrics, especificando el valor SM_CXCURSOR o SM_CYCURSOR.

Antes de cerrar, la aplicación debe llamar a la función DestroyCursor para liberar cualquier recurso del sistema asociado con el cursor.