Função LookupIconIdFromDirectoryEx (winuser.h)

Artigo
05/25/2023

Pesquisa os dados de recurso de ícone (RT_GROUP_ICON) ou cursor (RT_GROUP_CURSOR) para o ícone ou cursor que melhor se ajusta ao dispositivo de exibição atual.

Se houver mais de uma imagem no grupo de recursos, esse método usará os seguintes critérios para escolher uma imagem:

A imagem mais próxima, mas não exceder o tamanho solicitado, está selecionada.
Se duas ou mais imagens desse tamanho estiverem presentes, a que corresponde à profundidade de cor da exibição será escolhida.
Se nenhuma imagem corresponder exatamente à profundidade da cor da exibição, a imagem com a maior profundidade de cor que não exceder a profundidade de cor da exibição será escolhida. Se todos excederem a profundidade da cor, aquele com a menor profundidade de cor será escolhido.

Sintaxe

int LookupIconIdFromDirectoryEx(
  [in] PBYTE presbits,
  [in] BOOL  fIcon,
  [in] int   cxDesired,
  [in] int   cyDesired,
  [in] UINT  Flags
);

Parâmetros

[in] presbits

Tipo: PBYTE

O ícone ou os dados do diretório do cursor. Como essa função não valida os dados do recurso, ela causa uma falha de GP (proteção geral) ou retorna um valor indefinido se presbits não estiver apontando para dados de recurso válidos.

[in] fIcon

Tipo: BOOL

Indica se um ícone ou cursor é procurado. Se esse parâmetro for TRUE, a função está procurando um ícone; se o parâmetro for FALSE, a função está procurando um cursor.

[in] cxDesired

Tipo: int

A largura desejada, em pixels, do ícone. Se esse parâmetro for zero, a função usará o SM_CXICON ou SM_CXCURSOR valor de métrica do sistema.

[in] cyDesired

Tipo: int

A altura desejada, em pixels, do ícone. Se esse parâmetro for zero, a função usará o valor de métrica do sistema SM_CYICON ou SM_CYCURSOR .

[in] Flags

Tipo: UINT

Uma combinação dos valores a seguir.

Valor	Significado
LR_DEFAULTCOLOR 0x00000000	Usa o formato de cor padrão.
LR_MONOCHROME 0x00000001	Cria um ícone ou cursor monocromático.

Retornar valor

Tipo: int

Se a função for bem-sucedida, o valor retornado será um identificador de recurso inteiro para o ícone (RT_ICON) ou cursor (RT_CURSOR) que melhor se ajusta ao dispositivo de exibição atual.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Um arquivo de recurso do tipo RT_GROUP_ICON (RT_GROUP_CURSOR indica cursores) contém dados de ícone (ou cursor) em vários formatos dependentes do dispositivo e independentes do dispositivo. LookupIconIdFromDirectoryEx pesquisa o arquivo de recurso para o ícone (ou cursor) que melhor se ajusta ao dispositivo de exibição atual e retorna seu identificador inteiro. As funções FindResource e FindResourceEx usam a macro MAKEINTRESOURCE com esse identificador para localizar o recurso no módulo.

O diretório de ícone é carregado de um arquivo de recurso com o tipo de recurso RT_GROUP_ICON (ou RT_GROUP_CURSOR para cursores) e um nome de recurso inteiro para o ícone específico (RT_ICON) ou cursor (RT_CURSOR) a ser carregado. As funções LoadResource e CreateIconFromResourceEx podem ser usadas para criar um ícone ou cursor correspondente.

As funções LoadIcon, LoadImage e LoadCursor usam essa função para pesquisar os dados de recurso especificados para o ícone ou cursor que melhor se ajusta ao dispositivo de exibição atual. LoadIconWithScaleDown usa critérios de pesquisa alternativos para uma melhor opção.

Exemplos

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

Requisitos


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