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 for 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 de í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 do tamanho especificado por GetSystemMetrics chamado com SM_CXSMICON e GetSystemMetrics chamados com SM_CYSMICON.

SHIL_JUMBO (0x4)

0x4. Windows Vista e posterior. 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 é retornado, contém o ponteiro de interface solicitado no riid. Normalmente, isso é IImageList.

Valor de retorno

Tipo: HRESULT

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

Observações

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 um modo de 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 estiver marcado como com reconhecimento de dpi. Para definir esses tipos com reconhecimento de dpi, chame SetProcessDPIAware. SHIL_JUMBO é corrigido em 256 pixels, independentemente da configuração com reconhecimento de dpi.

Requirements

Requirement	Value
Cliente mínimo suportado	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo compatível	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
Header	shellapi.h
Library	OneCore.Lib
de DLL	Shell32.dll
Conjunto de API	ext-ms-win-shell-shell32-l1-2-2 (introduzido no Windows 10, versão 10.0.14393)

Consulte também

FileIconInit