GetIconInfo
The GetIconInfo
function retrieves information about the specified icon or cursor.
BOOL GetIconInfo(
|
HICON hIcon, |
// icon handle |
|
PICONINFO piconinfo |
// address of icon
structure |
|
); |
|
Parameters
hIcon
Identifies
the icon or cursor. To retrieve information about a standard icon or cursor,
specify one of the following values:
|
Value |
Meaning |
|
IDC_ARROW |
Arrow
cursor |
|
IDC_IBEAM |
I-beam
cursor |
|
IDC_WAIT |
Hourglass
cursor |
|
IDC_CROSS |
Crosshair
cursor |
|
IDC_UPARROW |
Up arrow
cursor |
|
IDC_SIZENWSE |
Sizing
cursor, points northwest and southeast |
|
IDC_SIZENESW |
Sizeing
cursor, points northeast and southwest |
|
IDC_SIZEWE |
Sizing
cursor, points west and east |
|
IDC_SIZENS |
Sizing
cursor, points north and south |
|
IDC_SIZEALL |
Sizing
cursor, points north, south, east, and west |
|
IDC_NO |
No cursor |
|
IDC_APPSTARTING |
Application-starting
cursor (arrow and hourglass) |
|
IDC_HELP |
Help cursor
(arrow and question mark) |
|
IDI_APPLICATION |
Application
icon |
|
IDI_HAND |
Stop sign
icon |
|
IDI_QUESTION |
Question-mark
icon |
|
IDI_EXCLAMATION |
Exclamation
point icon |
|
IDI_ASTERISK |
Asterisk
icon (letter i in a circle) |
|
IDI_WINLOGO |
Windows
logo icon |
piconinfo
Points to an ICONINFO structure. The function
fills in the structure s members.
Return Values
If the
function succeeds, the return value is nonzero and the function fills in the
members of the specified ICONINFO structure.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
Remarks
GetIconInfo creates bitmaps for the hbmMask and hbmColor
members of ICONINFO. The calling application must manage these bitmaps
and delete them when they are no longer necessary.
See Also