Freigeben über


CFrameWnd::SetTaskbarOverlayIcon

Überladen. Gilt ein Overlay auf eine Schaltfläche der Taskleiste, um Anwendungsstatus anzugeben oder zu den Benutzer zu benachrichtigen.

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

Parameter

  • nIDResource
    Gibt das Ressourcen-ID eines Symbols an, das als Overlay zu verwenden. Siehe Beschreibung für hIcon für Details.

  • lpcszDescr
    Ein Zeiger auf eine Zeichenfolge, die eine Alternativtextversion der Informationen bereitstellt, übermittelte durch das Overlay, zu den Barrierefreiheitszwecken.

  • hIcon
    Das Handle eines als das Overlay für verwenden, Symbols. Dies sollte ein kleines Symbol sein und Pixel 16x16 bei 96 Punkte pro Zoll (Dots Per Inch) messen. Wenn ein Overlaysymbol bereits an die Schaltflächen der Taskleiste angewendet wird, wird dieses vorhandene Overlay ersetzt. Dieser Wert kann NULL sein. Wie ein NULL-Wert behandelt wird, hängt davon ab, ob die Schaltflächen der Taskleiste ein einzelnes Fenster oder eine Gruppe Fenster darstellt. Es liegt in der Verantwortung des aufrufenden Anwendung, hIcon freizugeben, wenn es nicht mehr benötigt wird.

Rückgabewert

TRUE, wenn erfolgreich; FALSE, wenn Betriebssystemversion kleiner als ist, Windows 7 oder, wenn ein Fehler auftritt, das Symbol festzulegen.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CFrameWnd-Klasse