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 |