CreateIconFromResourceEx
[Now
Supported on Windows NT]
The CreateIconFromResourceEx
function creates an icon or cursor from resource bits describing the icon.
HICON CreateIconFromResourceEx(
|
PBYTE pbIconBits, |
// pointer
to icon or cursor bits |
|
DWORD cbIconBits, |
// number
of bytes in bit buffer |
|
BOOL fIcon, |
// icon or
cursor flag |
|
DWORD dwVersion, |
// Windows
format version |
|
int cxDesired, |
// desired width of icon or cursor |
|
int cyDesired, |
// desired
height of icon or cursor |
|
UINT uFlags |
// load resource flags |
|
); |
|
Parameters
pbIconBits
Points to a
buffer containing the icon or cursor resource bits. These bits are typically loaded
by calls to the LookupIconIdFromDirectoryEx and LoadResource functions.
cbIconBits
Specifies the
size, in bytes, of the set of bits pointed to by the pbIconBits
parameter.
fIcon
Specifies
whether an icon or a cursor is to be created. If this parameter is TRUE, an
icon is to be created. If it is FALSE, a cursor is to be created.
dwVersion
Specifies the
version number of the icon or cursor format for the resource bits pointed to by
the pbIconBits parameter. This parameter can be one of the following
values:
|
Format |
dwVersion |
|
Windows 2.x |
0x00020000 |
|
Windows 3.x |
0x00030000 |
All
Win32-based applications use the Windows 3.x format for icons and
cursors.
cxDesired
Specifies the
desired width, in pixels, of the icon or cursor. If this parameter is zero, the
function uses the SM_CXICON or SM_CXCURSOR system metric value to set the
width.
cyDesired
Specifies the
desired height, in pixels, of the icon or cursor. If this parameter is zero,
the function uses the SM_CYICON or SM_CYCURSOR system metric value to set the
height.
uFlags
Specifies a
combination of the following values:
|
Value |
Meaning |
|
LR_DEFAULTCOLOR |
Uses the
default color format. |
|
LR_MONOCHROME |
Creates a
monochrome icon or cursor. |
Return Values
If the
function succeeds, the return value is the handle to the icon or cursor.
If the
function fails, the return value is NULL. To get extended error information,
call GetLastError.
Remarks
The CreateIconFromResourceEx,
CreateIconFromResource, CreateIconIndirect, GetIconInfo,
and LookupIconIdFromDirectoryEx functions allow shell applications and
icon browsers to examine and use resources from throughout the system.
See Also