Função CreateIconFromResourceEx (winuser.h)

Artigo
11/20/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). Esses bits normalmente 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 formato de recurso de cursor e ícone.

[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 VERDADEIRO, um ícone deverá ser criado. Se for FALSE, um cursor será criado.

A estrutura LOCALHEADER define o hotspot do cursor e é o primeiro dado lido 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 o 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 têm tamanhos não padrão, que podem ser alterados após o carregamento ou carregados de um arquivo.

Valor de retorno

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.

Observações

As funções CreateIconFromResource, CreateIconFromResourceEx, CreateIconIndirect, GetIconInfoe LookupIconIdFromDirectoryEx permitem que aplicativos 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
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winuser.h (inclua Windows.h)
biblioteca	User32.lib
de DLL	User32.dll

Consulte também

BITMAPINFOHEADER

Conceitual

CreateIconFromResource

CreateIconIndirect

DestroyIcon

GetIconInfo

Ícones

LoadResource

LookupIconIdFromDirectoryEx

outros recursos

de referência de

Compartilhar via