'''wm iconwindow''' ''window ?pathName?''


** Description **

If ''pathName'' is specified, it is the path name for a window to use as icon for ''window'': <<br>>
when ''window'' is iconified then ''pathName'' will be mapped to serve as icon, <<br>>
and when ''window'' is de-iconified then ''pathName'' will be unmapped again. 

If ''pathName'' is specified as an empty string then any existing icon window association for ''window'' will be cancelled. <<br>>
If the ''pathName'' argument is specified then an empty string is returned. <<br>>
Otherwise the command returns the path name of the current icon window for ''window'', <<br>>
or an empty string if there is no icon window currently specified for ''window''. 

Button press events are disabled for ''window'' as long as it is an icon window; <<br>>
this is needed in order to allow [window manager]s to "own" those events.

Note: not all window managers support the notion of an icon window.

----

This command is probably only useful on Unix, and even then not with all window managers.

----

'''wm iconwindow''' may not work immediately. 
[Joe English] wrote in [comp.lang.tcl]: <<br>>
''You probably just need to unmap and remap the top-level
window, so the [window manager] will notice the changes:''

======
% wm withdraw .
% wm state . normal
======

----

** See Also **

   * [How do I give my application a color icon]
   * [wm iconbitmap]
   * [wm iconphoto]


<<categories>> Command | Tk syntax help | Arts and Crafts of Tcl-Tk Programming | GUI