gtk:window-icon (object)

object -- a gtk:window widget
icon -- a gdk-pixbuf:pixbuf object for the icon image, or nil

The accessor for the icon slot gets or sets the icon for the window. If you have called the gtk:window-icon-list function, gets the first icon in the icon list. This icon is used when the window is minimized, also known as iconified. Some window managers or desktop environments may also place it in the window frame, or display it in other contexts.

The icon should be provided in whatever size it was naturally drawn. That is, do not scale the image before passing it to GTK. Scaling is postponed until the last minute, when the desired final size is known, to allow best quality.

If you have your icon hand drawn in multiple sizes, use the gtk:window-icon-list function. Then the best size will be used. This function is equivalent to calling the gtk:window-icon-list function with a 1-element list.

See also the gtk:window-default-icon-list function to set the icon for all windows in your application in one go.