CreateIconFromResourceEx

A função CreateIconFromResourceEx cria um ícone ou cursor de bits de recurso que descreve o ícone.

(HICON CreateIconFromResourceEx PBYTEpbIconBits, / / ponteiro para bits de ícone ou cursorDWORDcbIconBits, / / número de bytes no buffer de bitBOOLfIcon, / / ícone ou cursor bandeiraDWORDdwVersion, / / formato versão intcxDesired, / / desejado largura do ícone ou cursor intcyDesired, / / desejado altura do ícone ou cursorUINTuFlags / / load sinalizadores de recurso);
 

Parâmetros

pbIconBits
Ponteiro para um buffer que contém os bits de recurso de ícone ou cursor. Esses bits são normalmente carregados por chamadas para as funções LookupIconIdFromDirectoryEx e LoadResource.
cbIconBits
Especifica o tamanho, em bytes, do conjunto de bits apontada pelo parâmetro pbIconBits.
fIcon
Especifica se um ícone ou um cursor deve ser criado. Se este parâmetro é TRUE, um ícone é criado. Se for FALSE, um cursor é a ser criado.
dwVersion
Especifica o número de versão do formato de ícone ou cursor para os bits de recurso apontado pelo pbIconBits parâmetro. Este parâmetro pode ser uma dos seguinte valores:
Formato dwVersion
Windows 2.x 0x00020000
Windows 3.x 0x00030000

Todos os aplicativos baseados em Win32 usam o Windows 3.formato de x para ícones e cursores.

cxDesired
Especifica a largura desejada, em pixels, do ícone ou cursor. Se este parâmetro for zero, a função usa o valor métrico sistema SM_CXICON ou SM_CXCURSOR para definir a largura.
cyDesired
Especifica a altura desejada, em pixels, do ícone ou cursor. Se este parâmetro for zero, a função usa o valor métrico sistema SM_CYICON ou SM_CYCURSOR para definir a altura.
uFlags
Especifica uma combinação do seguinte valores:
Valor Significado
LR_DEFAULTCOLOR Usa o formato de cor padrão.
LR_MONOCHROME Cria um monocromático ícone ou cursor.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é um identificador para o ícone ou cursor.

Se a função falhar, o valor de retorno é NULL. Para informações de erro estendidas get, chamar GetLastError.

Observações

O CreateIconFromResourceEx, CreateIconFromResource, CreateIconIndirect, GetIconInfoe LookupIconIdFromDirectoryEx funções permitem que aplicativos de shell e navegadores de ícone para examinar e usar recursos de todo o sistema.

QuickInfo

nbsp; Windows &NT: requer a versão 4.0 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral de ícones, ícone funções, BITMAPINFOHEADER, CreateIconFromResource, CreateIconIndirect, GetIconInfo, LoadResource, LookupIconIdFromDirectoryEx

Index