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