ExtractIconEx

A função ExtractIconEx cria uma matriz de identificadores para ícones grandes ou pequenos, extraídos do arquivo executável especificado, biblioteca de vínculo dinâmico (DLL) ou arquivo de ícone.

(UINT ExtractIconEx LPCTSTR  lpszFile, int  nIconIndex, HICON até agora  * phiconLarge, HICON até agora  * phiconSmall, UINT  nIcons);
 

Parâmetros

lpszFile
Ponteiro para uma seqüência de caracteres null-terminated especificando o nome de um arquivo executável, DLL ou arquivo de ícone do qual serão extraídos ícones.
nIconIndex
Especifica o índice baseado em zero do primeiro ícone para extrair. Por exemplo, se esse valor for zero, a função extrai o primeiro ícone no arquivo especificado.

Se esse valor é – 1 e phIconLarge e phiconSmall são ambos NULL, a função retorna o número total de ícones no arquivo especificado. Se o arquivo for um arquivo executável ou DLL, o valor de retorno é o número de recursos RT_GROUP_ICON. Se o arquivo é um.Arquivo ICO, o valor de retorno é 1.

Windows 95, Windows NT 4.0 e posterior: Se esse valor é um número negativo e phIconLarge ou phiconSmall não é NULL, a função começa extraindo o ícone cujo identificador de recurso é igual ao valor absoluto da nIconIndex. Por exemplo, usar -3 para extrair o ícone cujo identificador de recurso é de 3.

phiconLarge
Ponteiro para uma matriz de identificadores de ícone que recebe as alças para ícones grandes extraídos do arquivo. Se este parâmetro é NULL, não ícones grandes são extraídos do arquivo.
phiconSmall
Ponteiro para uma matriz de identificadores de ícone que recebe identificadores para os pequenos ícones extraídos do arquivo. Se este parâmetro é NULL, não ícones pequenos são extraídos do arquivo.
nIcons
Especifica o número de ícones para extrair do arquivo.

Retornar valores

Se o parâmetro nIconIndex é -1, o phiconLarge parâmetro é NULL e o phiconSmall parâmetro é NULL, o valor de retorno é o número de ícones contido no arquivo especificado. Caso contrário, o valor de retorno é o número de ícones extraídos com êxito do arquivo.

Observações

Você deve destruir todos os ícones extraídos por ExtractIconEx chamando o DestroyIcon função.

Para recuperar as dimensões dos ícones grandes e pequenos, use o GetSystemMetrics função com os sinalizadores SM_CXICON, SM_CYICON, SM_CXSMICON e SM_CYSMICON.

Windows CE: O nIconIndex parâmetro deve ser zero ou – n onde n é um identificador de recurso especificado. O nIcons parâmetro deve ser 1.

QuickInfo

nbsp; Windows &NT: requer a versão 3.5 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em shellapi.
Biblioteca de importação:Use shell32.lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.

Ver também

Visão geral de ícones, ícone funções, DestroyIcon, ExtractIcon

Index