Retrieves information about the specified icon or cursor. GetIconInfoEx extends GetIconInfo by using the newer ICONINFOEX structure.
Syntax
BOOL GetIconInfoEx(
HICON hIcon,
PICONINFOEX piconinfoex
);
Parameters
- hIcon
-
[in] Handle to the icon or cursor. To retrieve information about a standard icon or cursor, specify one of the following values.
IDC_APPSTARTING- Standard arrow and small hourglass cursor.
IDC_ARROW- Standard arrow cursor.
IDC_CROSS- Crosshair cursor.
IDC_HAND- Windows 98/Me, Windows 2000/XP: Hand cursor.
IDC_HELP- Arrow and question mark cursor.
IDC_IBEAM- I-beam cursor.
IDC_NO- Slashed circle cursor.
IDC_SIZEALL- Four-pointed arrow cursor pointing north, south, east, and west.
IDC_SIZENESW- Double-pointed arrow cursor pointing northeast and southwest.
IDC_SIZENS- Double-pointed arrow cursor pointing north and south.
IDC_SIZENWSE- Double-pointed arrow cursor pointing northwest and southeast.
IDC_SIZEWE- Double-pointed arrow cursor pointing west and east.
IDC_UPARROW- Vertical arrow cursor.
IDC_WAIT- Hourglass cursor.
IDI_APPLICATION- Application icon.
IDI_ASTERISK- Asterisk icon.
IDI_EXCLAMATION- Exclamation point icon.
IDI_HAND- Stop sign icon.
IDI_QUESTION- Question-mark icon.
IDI_WINLOGO- Windows logo icon. Windows XP: Application icon.
- piconinfoex
-
[out] When this method returns, contains a pointer to an ICONINFOEX structure. The function fills in the structure's members.
Return Value
TRUE indicates success, FALSE indicates failure.
Remarks
GetIconInfoEx creates bitmaps for the hbmMask and hbmCol or members of ICONINFOEX. The calling application must manage these bitmaps and delete them when they are no longer necessary.
Function Information
| Minimum DLL Version | user32.dll |
|---|
| Header | Declared in Winuser.h, include Windows.h |
|---|
| Import library | User32.lib |
|---|
| Minimum operating systems |
Windows Vista |
|---|
| Unicode | Implemented as
ANSI and Unicode versions. |
|---|
See Also