window_set_icon
This is a "cheat sheet" for the "window_set_icon" extension by YellowAfterlife.
The extension can be found on itch.io.
The source code can be found on GitHub.
Window icon functions
Changes the window icon.
Path should point to a valid ICO file.
Returns whether successful. Sets status variables.
Changes the window icon.
The buffer should contain a valid ICO file.
Returns whether successful. Sets status variables.
Changes the window icon to match the pixels in a surface.
set_big_icon
indicates whether to change the big (32x32) instead of small (16x16) icon.
The "big" icon may used for display in taskbar.
Returns whether successful. Sets status variables.
Resets the window icon to whatever it was before you first called this extension's functions.
Cannot fail, but returns true
and sets status variables just in case.
Re-applies whatever last icon that we had stored.
You should only call this yourself if you encounter a situation where the window icon
changes back.
Cannot fail, but returns true
and sets status variables just in case.
Taskbar icon overlay functions
Changes the little overlay/notification badge icon shown in the corner of the window.
Path should point to a valid ICO file.
description
(optional) is a string that provides the alt text version
of the information conveyed by the overlay, for accessibility purposes.
(MSDN)
Returns whether successful. Sets status variables.
Changes the little overlay/notification badge icon shown in the corner of the taskbar button.
The buffer should contain a valid ICO file.
description
(optional) is a string that provides the alt text version
of the information conveyed by the overlay, for accessibility purposes.
(MSDN)
Returns whether successful. Sets status variables.
Changes the little overlay/notification badge icon shown in the corner of the taskbar button to match pixels in a surface.
description
(optional) is a string that provides the alt text version
of the information conveyed by the overlay, for accessibility purposes.
(MSDN)
Returns whether successful. Sets status variables.
Resets/removes the little overlay/notification badge icon.
Cannot fail, but returns true
and sets status variables just in case.
Error handling
This is an HRESULT
code for the last call.
This is the context for the last call - either what failed, or which function threw up an error.