Función CreateIcon (winuser.h)
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 |