Função LookupIconIdFromDirectory (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.

Para especificar uma altura ou largura desejada, use a função LookupIconIdFromDirectoryEx . Essa função a chama passando zero nos parâmetros cyDesired/cxDesired .

Sintaxe

int LookupIconIdFromDirectory(
  [in] PBYTE presbits,
  [in] BOOL  fIcon
);

Parâmetros

[in] presbits

Tipo: PBYTE

Os dados do diretório do cursor ou do ícone. 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 apontar 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.

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. LookupIconIdFromDirectory 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 a ser carregado. LookupIconIdFromDirectory retorna um identificador inteiro que é o nome do recurso do ícone que melhor se ajusta ao dispositivo de exibição atual.

As funções LoadIcon, LoadCursor e LoadImage 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.

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