wm attributes

wm attributes window

wm attributes window option

wm attributes window option value ?option value...?

This subcommand returns or sets platform specific attributes associated with a window. The first form returns a list of the platform specific flags and their values. The second form returns the value for the specific option. The third form sets one or more of the values. The values are as follows:

This command exists since Tk 8.4 and sets or retrieves window-specific attributes. The supported attributes are different for each platform. On Tk 8.5, they are:

Macintosh Attributes

-alpha double

controls opacity (from 0.0 to 1.0)

-fullscreen boolean

controls whether the window takes the whole screen

-modified boolean

controls whether the window is marked as being modified (different close button)

-notify boolean

controls whether the window's icon bounces in the dock

-titlepath filename

associates a (draggable) file icon with the window title that can be used to manage the given file with other applications

-topmost boolean

controls whether the window stays on top of normal windows

-transparent boolean

controls whether the window has a shadow (useful for transparent windows, though care must be taken to draw appropriately to take advantage)

bll 2016-4-22: As of 2016-4-22, -fullscreen on Mac OS X must be preceded by wm withdraw . and followed by wm deiconify ..

Unix/X11 Attributes

-alpha double

controls opacity (from 0.0 to 1.0). This requires a compositing window manager to have any effect. compiz is one such, and xfwm4 (for the XFCE desktop) is another.

-fullscreen boolean

controls whether this window occupies the entire screen (different to -zoomed)

-topmost boolean

controls whether this window stays on top of other (normal) windows

-type list

this is provided in Tk 8.6, 8.5.9+ and 8.4.20+ to support the extended window manager hint property that governs a toplevel window's type on X11. Setting this appropriately can permit the window manager to apply relevant styling and animation. For instance, tooltip windows may well have animations to be used when mapping and unmapping the tooltip. Combobox dropdown lists have a different style to dialogs. The value for this attribute should be set to a list of preferred window types as not all window managers may support all types. Typically this is one of dialog, tooltip, combo or splash but anything from [L1 ] should be applicable. See [L2 ] for details.

-zoomed boolean

controls whether this window is in the zoomed state

NOTE: Support for all of these attributes depends on the system window manager; most do support, but not all.

Windows Attributes

Most options take a true/false value

-alpha double

how opaque the overall window is; note that changing between 1.0 and any other value may cause the window to flash (Tk changes the class of window used to implement the toplevel).

-fullscreen boolean

controls whether the window fills the whole screen, including taskbar

-disabled boolean

makes it impossible to interact with the window and redraws the focus

-toolwindow boolean

makes a window with a single close-button (which is smaller than usual) on the right of the title bar

-topmost boolean

makes sure the window always stays on top of all other windows

 if 0 {
 % wm attributes .
 -disabled 0 -toolwindow 0 -topmost 0
 }

 package require Tk
 pack [label .l -text "Hello, world" -font {Times 36}]
 update
 while 1 {
    for {set a 1.} {$a>0.} {set a [expr $a-0.01]} {
        wm attrib . -alpha $a; update; after 100
    }
    for {set a 0.} {$a<1.} {set a [expr $a+0.01]} {
        wm attrib . -alpha $a; update; after 100
    }
 }