Home Library Learn Samples Downloads Support Community Forums
This topic has not yet been rated - Rate this topic

CFrameWnd::SetTaskbarOverlayIcon

Visual Studio 2012

Overloaded. Applies an overlay to a taskbar button to indicate application status or to notify the user.

Copy 
BOOL SetTaskbarOverlayIcon(
   UINT nIDResource,
   LPCTSTR lpcszDescr
);
BOOL SetTaskbarOverlayIcon(
   HICON hIcon,
   LPCTSTR lpcszDescr
);
nIDResource

Specifies the Resource ID of an icon to use as the overlay. See description for hIcon for details.

lpcszDescr

A pointer to a string that provides an alt text version of the information conveyed by the overlay, for accessibility purposes.

hIcon

The handle of an icon to use as the overlay. This should be a small icon, measuring 16x16 pixels at 96 dots per inch (dpi). If an overlay icon is already applied to the taskbar button, that existing overlay is replaced. This value can be NULL. How a NULL value is handled depends on whether the taskbar button represents a single window or a group of windows. It is the responsibility of the calling application to free hIcon when it is no longer needed.

TRUE if successful; FALSE if OS version is less than Windows 7 or if an error occurs setting the icon.

Header: afxwin.h

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.