Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 10.5   11.0   11.1   11.2   11.3   11.4   11.5   12.0   12.1   12.2    Statistic    FMM    Blog  


Sets the icon of a window in Windows.

Component Version macOS Windows Linux Server iOS SDK License
Window 3.2 ❌ No ✅ Yes ❌ No ❌ No ❌ No Paid
MBS( "Window.SetTitleIcon"; WindowRef; ImageRef { ; bigIcon } )   More


Parameter Description Example Flags
WindowRef Window Reference is the unique OS level window ID. You can obtain this by using the Window.FindByTitle or Window.FindByIndex functions. Pass zero to access the frontmost window. 0
ImageRef The image reference for the picture image, a number returned from the GMImage.New functions 1
bigIcon Pass 1 to set big icon (for app switcher) or 0 for small icon (icon in title bar). Default is 0. 1 Optional


Returns OK or error status.


Sets the icon of a window in Windows.
Version 6.2 no longer takes a mask image like previous versions, so you now pass a picture with transparency like a PNG file for example.
You may need to use GMImage.NewImagesFromContainer to read image from container first.

See also

Example Databases

Blog Entries

Created 18th August 2014, last changed 7th May 2020

Window.SetTitle - Window.SetTitleVisible

Feedback: Report problem or ask question.

Start Chat