Função CreateIconFromResource (winuser.h)
Cria um ícone ou cursor de bits de recurso que descrevem o ícone.
Para especificar uma altura ou largura desejada, use a função CreateIconFromResourceEx .
Sintaxe
HICON CreateIconFromResource(
[in] PBYTE presbits,
[in] DWORD dwResSize,
[in] BOOL fIcon,
[in] DWORD dwVer
);
Parâmetros
[in] presbits
Tipo: PBYTE
O ponteiro de buffer alinhado ao DWORD que contém o ícone ou os bits de recurso do cursor. Normalmente, esses bits são carregados por chamadas para as funções LookupIconIdFromDirectory, LookupIconIdFromDirectoryEx e LoadResource .
Consulte Cursor e Recursos de Ícone para obter mais informações sobre o ícone e o formato de recurso do cursor.
[in] dwResSize
Tipo: DWORD
O tamanho, em bytes, do conjunto de bits apontado pelo parâmetro presbits .
[in] fIcon
Tipo: BOOL
Indica se um ícone ou cursor deve ser criado. Se esse parâmetro for TRUE, um ícone será criado. Se for FALSE, um cursor deverá ser criado.
A estrutura LOCALHEADER define o hotspot do cursor e é os primeiros dados lidos dos bits de recurso do cursor.
[in] dwVer
Tipo: DWORD
O número de versão do ícone ou formato de cursor para os bits de recurso apontados pelo parâmetro presbits . O valor deve ser maior ou igual a 0x00020000 e menor ou igual a 0x00030000. Esse parâmetro geralmente é definido como 0x00030000.
Retornar valor
Tipo: HICON
Se a função for bem-sucedida, o valor retornado será um identificador para o ícone ou cursor.
Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.
Comentários
As funções CreateIconFromResource, CreateIconFromResourceEx, CreateIconIndirect, GetIconInfo, LookupIconIdFromDirectory e LookupIconIdFromDirectoryEx permitem que aplicativos de shell e navegadores de ícone examinem e usem recursos em todo o sistema.
A função CreateIconFromResource chama CreateIconFromResourceEx passando LR_DEFAULTSIZE|LR_SHARED como sinalizadores.
Você deve chamar DestroyIcon para ícones ou DestroyCursor para cursores criados com CreateIconFromResource.
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
Conceitual
Referência