Função CreateIcon (winuser.h)

Cria um ícone que tem o tamanho, as cores e os padrões de bit especificados.

Para criar um ícone colorido em tempo de execução, você pode usar a função CreateIconIndirect , que cria um ícone com base no conteúdo de uma estrutura ICONINFO .

Sintaxe

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

Um identificador para a instância do módulo que cria o ícone.

[in] nWidth

Tipo: int

A largura, em pixels, do ícone. Consulte Observações.

[in] nHeight

Tipo: int

A altura, em pixels, do ícone. Consulte Observações.

[in] cPlanes

Tipo: BYTE

O número de planos na máscara de bits XOR do ícone. Consulte Observações.

[in] cBitsPixel

Tipo: BYTE

O número de bits por pixel na máscara de bits XOR do ícone.

[in] lpbANDbits

Tipo: const BYTE*

Uma matriz de bytes que contém os valores de bit para a máscara de bits AND do ícone. Essa máscara de bits descreve um bitmap monocromático. Consulte Observações.

[in] lpbXORbits

Tipo: const BYTE*

Uma matriz de bytes que contém os valores de bit para a máscara de bits XOR do ícone. Essa máscara de bits descreve um bitmap monocromático ou de cor. Consulte Observações.

Retornar valor

Tipo: HICON

Se a função for bem-sucedida, o valor retornado será um identificador para um ícone.

Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Para determinar o tamanho nominal do ícone, use a função GetSystemMetrics , especificando o valor SM_CXICON ou SM_CYICON . Além disso, você pode usar a versão com reconhecimento de DPI dessa API, consulte (GetSystemMetricsForDpi)(/windows/win32/api/winuser/nf-winuser-getsystemmetricsfordpi). Para obter mais informações, consulte Tamanhos de ícone e Desenvolvimento de aplicativos de área de trabalho de DPI alto no Windows.

Para obter mais informações sobre os parâmetros lpbANDbits e lpbXORbits , confira a descrição do parâmetro lpBits da função CreateBitmap .

No caso do ícone monocromático , CreateIcon aplica a seguinte tabela de verdade às máscaras de bits AND e XOR:

Máscara de bits AND	Máscara de bits XOR	Monitor
0	0	Preto
0	1	Branca
1	0	Tela
1	1	Tela inversa

Quando terminar de usar o ícone, destrua-o usando a função DestroyIcon .

Exemplos

Para obter um exemplo, consulte Criando um ícone.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll

Confira também

CreateIconIndirect

Ícones

Tamanhos de ícone