Función CreateIcon (winuser.h)

  • Artículo

Crea un icono que tiene el tamaño, los colores y los patrones de bits especificados.

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

Sintaxis

HICON CreateIcon(
  [in, optional] HINSTANCE  hInstance,
  [in]           int        nWidth,
  [in]           int        nHeight,
  [in]           BYTE       cPlanes,
  [in]           BYTE       cBitsPixel,
  [in]           const BYTE *lpbANDbits,
  [in]           const BYTE *lpbXORbits
);

Parámetros

[in, optional] hInstance

Tipo: HINSTANCE

Identificador de la instancia del módulo que crea el icono.

[in] nWidth

Tipo: int

Ancho, expresado en píxeles, del icono. Vea Notas.

[in] nHeight

Tipo: int

Alto, expresado en píxeles, del icono. Vea Notas.

[in] cPlanes

Tipo: BYTE

Número de planos de la máscara de bits XOR del icono. Vea Notas.

[in] cBitsPixel

Tipo: BYTE

Número de bits por píxel en la máscara de bits XOR del icono.

[in] lpbANDbits

Tipo: const BYTE*

Matriz de bytes que contiene los valores de bits para la máscara de bits AND del icono. Esta máscara de bits describe un mapa de bits monocromo. Vea Notas.

[in] lpbXORbits

Tipo: const BYTE*

Matriz de bytes que contiene los valores de bits de la máscara de bits XOR del icono. Esta máscara de bits describe un mapa de bits monocromo o de color. Vea Notas.

Valor devuelto

Tipo: HICON

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

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 del icono, use la función GetSystemMetrics , especificando el valor SM_CXICON o SM_CYICON . 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 Tamaños de icono y Desarrollo de aplicaciones de escritorio con valores altos de PPP en Windows.

Para obtener más información sobre los parámetros lpbANDbits y lpbXORbits , consulte la descripción del parámetro lpBits de la función CreateBitmap .

En el caso del icono monocromo CreateIcon 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

Cuando haya terminado de usar el icono, destruyalo mediante la función DestroyIcon .

Ejemplos

Para obtener un ejemplo, vea Crear un icono.

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 (incluir Windows.h)
Library User32.lib
Archivo DLL User32.dll

Consulte también

CreateIconIndirect

Iconos

Tamaños de icono