LookupIconIdFromDirectoryEx

A função de LookupIconIdFromDirectoryEx procura através de dados de ícone ou o cursor para o ícone ou cursor que melhor se encaixa o atual dispositivo exibir.

 int LookupIconIdFromDirectoryEx ( PBYTE  presbits, / / endereço de dados de recursosBOOLfIcon, / / ícone ou cursor bandeiraintcxDesired, / / desejado largura do ícone ou cursorintcyDesired, / / desejado altura do ícone ou cursorUINTSinalizadores / / recurso sinalizadores);
 

Parâmetros

presbits
Ponteiro para os dados de diretório ícone ou cursor. Porque esta função não valida os dados de recursos, ele causa uma falha de proteção geral (GP) ou retorna um valor indefinido se presbits não estiver apontando para os dados de recurso válido.
fIcon
Especifica se um ícone ou um cursor é pedido. Se este parâmetro for TRUE, a função está à procura de um ícone; Se o parâmetro for FALSE, a função está à procura de um cursor.
cxDesired
Especifica a largura desejada, em pixels, do ícone. Se este parâmetro for zero, a função usa o valor métrico sistema SM_CXICON ou SM_CXCURSOR.
cyDesired
Especifica a altura desejada, em pixels, do ícone. Se este parâmetro for zero, a função usa o valor métrico sistema SM_CYICON ou SM_CYCURSOR.
Sinalizadores
Especifica uma combinação do seguinte valores:
Valor Significado
LR_DEFAULTCOLOR Usa o formato de cor padrão.
LR_MONOCHROME Cria um monocromático ícone ou cursor.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é um identificador de recurso inteiro para o ícone ou cursor que melhor se encaixa o atual dispositivo exibir.

Se a função falhar, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.

Observações

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 de dispositivo-dependente e independente de dispositivo. LookupIconIdFromDirectoryEx pesquisa o arquivo de recurso do ícone (ou cursor) que melhor se encaixa o atual dispositivo exibir e retorna o identificador inteiro. O FindResource e FindResourceEx funções use o MAKEINTRESOURCE macro com esse identificador para localizar o recurso no módulo.

Diretório do ícone é carregado de um arquivo de recurso com recurso tipo RT_GROUP_ICON (ou RT_GROUP_CURSOR para cursores) e um nome de recurso de número inteiro para o ícone específico a ser carregado. LookupIconIdFromDirectoryEx retorna um identificador inteiro que é o nome do recurso do ícone que melhor se encaixa o atual dispositivo exibir.

As LoadIcon, LoadImage LoadCursor funções usam esta função para pesquisar para o ícone ou cursor que melhor se encaixa o atual dispositivo exibir dados de recurso especificado.

QuickInfo

nbsp; Windows &NT: requer a versão 4.0 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral de ícones, ícone funções, CreateIconFromResourceEx, CreateIconIndirect, FindResource, FindResourceEx, GetIconInfo, LoadCursor, LoadIcon, LoadImage, LookupIconIdFromDirectory, MAKEINTRESOURCE

Index