ImageList_WriteEx function

Writes an image list to a stream.

Syntax


HRESULT ImageList_WriteEx(
  _In_  HIMAGELIST himl,
  _In_  DWORD dwFlags,
  _In_  LPSTREAM pstm
);

Parameters

himl [in]

Type: HIMAGELIST

A handle to the image list.

dwFlags [in]

Type: DWORD

A flag that specifies how the stream is written.

ValueMeaning
ILP_NORMAL

Writes to the stream using the file format for Common Controls 6.0, which includes information about image list attributes new to this version.

ILP_DOWNLEVEL

Writes to the stream using a file format previous to version 6.0. Specify this flag if you need to save image lists loaded under Common Controls versions earlier than version 6.0.

 

pstm [in]

Type: LPSTREAM

The address of the stream.

Return value

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

You should not create an image list that is written with the ILP_DOWNLEVEL flag with ILC_COLOR32.

To use ImageList_WriteEx, the application must specify Comctl32.dll version 6 in the manifest. For more information on manifests, see Enabling Visual Styles.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Commctrl.h

Library

Comctl32.lib

DLL

Comctl32.dll (version 6.0 or later)

See also

Reference
ImageList_ReadEx
ImageList_Read
ImageList_Write

 

 

Community Additions

ADD
Show:
© 2014 Microsoft