Função CreateIconFromResource (winuser.h)

Artigo
01/27/2024

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