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



** See Also **

   [How do I give my application a color icon]:   



** Description **

If ''pathName'' is specified, it is the path name for a window to use as icon
for ''window'': when ''window'' is iconified then ''pathName'' will be mapped
to serve as icon, and when ''window'' is de-iconified then ''pathName'' will be
unmapped again. <<br>>
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'', or
an empty string if there is no icon window currently specified for ''window''. <<br>>
Button press events are disabled for ''window'' as long as it is an icon window; 
this is needed in order to allow [window manager]s to "own" those events. <<br>>
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]: 
''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''':
  * [wm iconbitmap]


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