função ImageList_WriteEx (commctrl.h)

  • Artigo

Grava uma lista de imagens em um fluxo.

Sintaxe

HRESULT ImageList_WriteEx(
  [in] HIMAGELIST himl,
  [in] DWORD      dwFlags,
  [in] IStream    *pstm
);

Parâmetros

[in] himl

Tipo: HIMAGELIST

Um identificador para a lista de imagens.

[in] dwFlags

Tipo: DWORD

Um sinalizador que especifica como o fluxo é gravado.

Valor Significado
ILP_NORMAL
 Grava no fluxo usando o formato de arquivo para Controles Comuns 6.0, que inclui informações sobre atributos de lista de imagens novos nesta versão.
ILP_DOWNLEVEL
 Grava no fluxo usando um formato de arquivo anterior à versão 6.0. Especifique esse sinalizador se você precisar salvar listas de imagens carregadas em Controles Comuns versões anteriores à versão 6.0.

[in] pstm

Tipo: LPSTREAM

O endereço do fluxo.

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

Você não deve criar uma lista de imagens escrita com o sinalizador ILP_DOWNLEVEL com ILC_COLOR32.

Para usar ImageList_WriteEx, o aplicativo deve especificar Comctl32.dll versão 6 no manifesto. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [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 commctrl.h
Biblioteca Comctl32.lib
DLL Comctl32.dll (versão 6.0 ou posterior)

Confira também

ImageList_Read

ImageList_ReadEx

ImageList_Write

Referência