|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| No
| Import Library
| user32.lib
| Header File
| winuser.h
| Unicode
| No
| Platform Notes
| None
|
|
|
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
BITMAPINFOHEADER, CreateIconFromResource, CreateIconIndirect, GetIconInfo, LoadResource, LookupIconIdFromDirectoryEx
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
