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.
Value Meaning - 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 Vista [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
- Reference
- ImageList_ReadEx
- ImageList_Read
- ImageList_Write