Função SHGetImageList (shellapi.h)

Recupera uma lista de imagens.

Sintaxe

SHSTDAPI SHGetImageList(
  [in]  int    iImageList,
  [in]  REFIID riid,
  [out] void   **ppvObj
);

Parâmetros

[in] iImageList

Tipo: int

O tipo de imagem contido na lista. Um dos seguintes valores:

SHIL_LARGE (0x0)

0x0. O tamanho da imagem normalmente é de 32 x 32 pixels. No entanto, se a opção Usar ícones grandes estiver selecionada na seção Efeitos da guia Aparência em Propriedades de Exibição, a imagem será de 48 x 48 pixels.

SHIL_SMALL (0x1)

0x1. Essas imagens são o tamanho de ícone pequeno padrão do Shell de 16x16, mas o tamanho pode ser personalizado pelo usuário.

SHIL_EXTRALARGE (0x2)

0x2. Essas imagens são o tamanho do ícone extra grande padrão do Shell. Normalmente, isso é 48x48, mas o tamanho pode ser personalizado pelo usuário.

SHIL_SYSSMALL (0x3)

0x3. Essas imagens são o tamanho especificado por GetSystemMetrics chamado com SM_CXSMICON e GetSystemMetrics chamados com SM_CYSMICON.

SHIL_JUMBO (0x4)

0x4. Windows Vista e posteriores. A imagem normalmente tem 256 x 256 pixels.

SHIL_LAST

O maior valor de sinalizador válido, para fins de validação.

[in] riid

Tipo: REFIID

Referência ao identificador da interface de lista de imagens, normalmente IID_IImageList.

[out] ppvObj

Tipo: void**

Quando esse método retorna, contém o ponteiro de interface solicitado em riid. Normalmente, isso é IImageList.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O tipo de ponteiro IImageList , como o retornado no parâmetro ppv , pode ser convertido como HIMAGELIST conforme necessário; por exemplo, para uso em uma exibição de lista. Por outro lado, um HIMAGELIST pode ser convertido como um ponteiro para um IImageList.

A partir do Windows Vista, SHIL_SMALL, SHIL_LARGE e dimensionar SHIL_EXTRALARGE com pontos por polegada (dpi) se o processo for marcado como com reconhecimento de dpi. Para definir esses tipos como com reconhecimento de dpi, chame SetProcessDPIAware. SHIL_JUMBO é corrigido em 256 pixels, independentemente da configuração com reconhecimento de dpi.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shellapi.h
DLL	Shell32.dll
Conjunto de APIs	ext-ms-win-shell32-l1-2-2 (introduzido no Windows 10, versão 10.0.14393)

Confira também

FileIconInit