Compartilhar via


Função CreateIconIndirect (winuser.h)

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)

Confira também

Conceitual

Destroyicon

ICONINFO

Ícones