CreateIcon

A função CreateIcon cria um ícone que tem o tamanho especificado, cores e padrões de bits.

(HICON CreateIcon HINSTANCE  hInstance, / / identificador de instância de aplicativointnWidth, / / largura do íconeintnHeight, / / altura de íconeBYTEcPlanes, / / número de aviões em máscara de bits XORBYTEcBitsPixel, / / número de bits por pixel em máscara de bits XORBYTE CONST* lpbANDbits, / / ponteiro para matriz de máscara de bits eBYTE CONST* lpbXORbits / / ponteiro para matriz de máscara de bits XOR);
 

Parâmetros

hInstance
Identificador para a instância do módulo Criando o ícone.
nWidth
Especifica a largura, em pixels, do ícone.
nHeight
Especifica a altura, em pixels, do ícone.
cPlanes
Especifica o número de aviões na máscara de bits XOR do ícone.
cBitsPixel
Especifica o número de bits por pixel na máscara de bits XOR do ícone.
lpbANDbits
Ponteiro para uma matriz de bytes que contém os valores bit para o máscara de bits e do ícone. Esta máscara de bits descreve um bitmap monocromático.
lpbXORbits
Ponteiro para uma matriz de bytes que contém os valores bit para o máscara de bits XOR do ícone. Esta máscara de bits descreve uma monocromático ou cor de dispositivo-dependente bitmap.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é um identificador para um ícone.

Se a função falhar, o valor de retorno é NULL. Para informações de erro estendidas get, chamar GetLastError.

Observações

O nWidth e nHeight parâmetros devem especificar uma largura e altura com suporte pelo driver de vídeo atual, porque o sistema não é possível criar ícones de outros tamanhos. Para determinar a largura e altura com suporte pelo driver de vídeo, use o GetSystemMetrics função, especificando o valor SM_CXICON ou SM_CYICON.

CreateIcon aplica-se a seguinte tabela de verdade para o AND e XOR bitmasks:

E máscara de bits Máscara de bits XOR Exibição
0 0 Preto
0 1 Branco
1 0 Tela
1 1 Inverter tela

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral de ícones, ícone funções, GetSystemMetrics

Index