Função LookupIconIdFromDirectory (winuser.h)
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 |
Confira também
Conceitual
Referência