CreateIcon

La función CreateIcon crea un icono que tiene el tamaño, colores y patrones de bits especificados.

Sintaxis

HICON CreateIcon(
    HINSTANCE hInstance,     // manipulador a instancia de aplicación
    int nWidth,              // anchura del icono
    int nHeight,             // altura del icono
    BYTE cPlanes,            // número de planos en la máscara XOR
    BYTE cBitsPixel,         // número de bits por pixel en la máscara XOR
    CONST BYTE *lpbANDbits,  // puntero a array con máscara de bits AND
    CONST BYTE *lpbXORbits   // puntero a array con máscara de bits XOR
   );

Parámetros

hInstance: identifica la instancia del módulo que crea el icono.

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

nHeight: especifica al altura, en pixels, del icono.

cPlanes: especifica el número de planos en la máscara de bits XOR del icono.

cBitsPixel: especifica el número de bits por pixel en la máscara de bits XOR del icono.

lpbANDbits: puntero a un array de bytes que contiene los valores de bits para la máscara AND del icono. Esta náscara de bits describe un mapa de bits monocromo.

lpbXORbits: puntero a un array de bytes que contiene los valores de bits para la máscara XOR del icono. Esta máscara de bits describe un mapa de bits monocromo o uno dependiente del dispositivo.

Valor de retorno

Si la función tiene éxito, el valor de retorno será un manipulador al icono.

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 soportadas por el driver del display actual, ya que el sistema no puede crear iconos de otros tamaños. Para determinar la anchura y altura soportados por el driver, usar la función GetSystemMetrics, especificando el valor SM_CXICON o SM_CYICON.

CreateIcon aplica las siguientes tablas de verdad a las máscaras de bits AND y XOR: