Função CreateIconFromResourceEx (winuser.h)

Artigo
01/27/2024

Cria um ícone ou cursor de bits de recurso que descrevem o ícone.

Sintaxe

HICON CreateIconFromResourceEx(
  [in] PBYTE presbits,
  [in] DWORD dwResSize,
  [in] BOOL  fIcon,
  [in] DWORD dwVer,
  [in] int   cxDesired,
  [in] int   cyDesired,
  [in] UINT  Flags
);

Parâmetros

[in] presbits

Tipo: PBYTE

O ponteiro de buffer alinhado ao DWORD que contém os bits de recurso ícone (RT_ICON) ou cursor (RT_CURSOR). Normalmente, esses bits são carregados por chamadas para as funções 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 pbIconBits .

[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.

[in] cxDesired

Tipo: int

A largura, em pixels, do ícone ou cursor. Se esse parâmetro for zero e o parâmetro Flags for LR_DEFAULTSIZE, a função usará o valor de métrica do sistema SM_CXICON ou SM_CXCURSOR para definir a largura. Se esse parâmetro for zero e LR_DEFAULTSIZE não for usado, a função usará a largura real do recurso.

[in] cyDesired

Tipo: int

A altura, em pixels, do ícone ou cursor. Se esse parâmetro for zero e o parâmetro Flags for LR_DEFAULTSIZE, a função usará o valor de métrica do sistema SM_CYICON ou SM_CYCURSOR para definir a altura. Se esse parâmetro for zero e LR_DEFAULTSIZE não for usado, a função usará a altura real do recurso.

[in] Flags

Tipo: UINT

Uma combinação dos valores a seguir.

Valor	Significado
LR_DEFAULTCOLOR 0x00000000	Usa o formato de cor padrão.
LR_DEFAULTSIZE 0x00000040	Usa a largura ou a altura especificada pelos valores de métrica do sistema para cursores ou ícones, se os valores cxDesired ou cyDesired forem definidos como zero. Se esse sinalizador não for especificado e cxDesired e cyDesired forem definidos como zero, a função usará o tamanho real do recurso.
LR_MONOCHROME 0x00000001	Cria um ícone ou cursor monocromático.
LR_SHARED 0x00008000	Compartilha o identificador de ícone ou cursor se o ícone ou cursor for criado várias vezes. Se LR_SHARED não estiver definido, uma segunda chamada para CreateIconFromResourceEx para o mesmo recurso criará o ícone ou cursor novamente e retornará um identificador diferente. Quando você usar esse sinalizador, o sistema destruirá o recurso quando ele não for mais necessário. Não use LR_SHARED para ícones ou cursores que tenham tamanhos não padrão, que podem ser alterados após o carregamento ou carregados de um arquivo.

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 e LookupIconIdFromDirectoryEx permitem que aplicativos de shell e navegadores de ícone examinem e usem recursos em todo o sistema.

Você deve chamar DestroyIcon para ícones ou DestroyCursor para cursores criados com CreateIconFromResourceEx.

Exemplos

Para obter um exemplo, consulte Recursos de ícone de compartilhamento.

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