Função LookupIconIdFromDirectoryEx (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.
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 |
|---|---|
|
Usa o formato de cor padrão. |
|
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 |
Confira também
Conceitual
Referência