Função CreateIconIndirect (winuser.h)

Artigo
03/13/2024

Cria um ícone ou cursor de uma estrutura ICONINFO .

Sintaxe

HICON CreateIconIndirect(
  [in] PICONINFO piconinfo
);

Parâmetros

[in] piconinfo

Tipo: PICONINFO

Um ponteiro para uma estrutura ICONINFO que a função usa para criar o ícone ou cursor.

Retornar valor

Tipo: HICON

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

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

Comentários

O sistema copia os bitmaps na estrutura ICONINFO antes de criar o ícone ou cursor. Como o sistema pode selecionar temporariamente os bitmaps em um contexto de dispositivo, os membros hbmMask e hbmColor da estrutura ICONINFO ainda não devem ser selecionados em um contexto de dispositivo. O aplicativo deve continuar a gerenciar os bitmaps originais e excluí-los quando eles não forem mais necessários.

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

Exemplos

Para obter um exemplo, consulte Criando um cursor.

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
Conjunto de APIs	ext-ms-win-ntuser-gui-l1-3-0 (introduzido no Windows 10, versão 10.0.10240)