Options

The Frame widget supports the following options:

Table 26-1. Frame Options

Option

Type

Description

height, width

distance

Frame size.

background (bg)

color

The background color to use in this frame. This defaults to the application background color. To prevent updates, set the color to an empty string.

colormap

window

Some displays support only 256 colors (some use even less). Such displays usually provide a color map to specify which 256 colors to use. This option allows you to specify which color map to use for this frame, and its child widgets.

By default, a new frame uses the same color map as its parent. Using this option, you can reuse the color map of another window instead (this window must be on the same screen and have the same visual characteristics). You can also use the value "new" to allocate a new color map for this frame.

You cannot change this option once you've created the frame.

cursor

cursor

The cursor to show when the mouse pointer is placed over the button widget. Default is a system specific arrow cursor.

relief

constant

Border decoration. The default is FLAT. Other possible values are SUNKEN, RAISED, GROOVE, and RIDGE.

Note that to show the border, you need to change the borderwidth from it's default value of 0.

borderwidth (bd)

distance

Border width. Defaults to 0 (no border).

takefocus

flag

Indicates that the user can use the Tab key to move to this widget. Default is an empty string, which means that the frame accepts focus only if it has any keyboard bindings (default is off, in other words).

highlightbackground, highlightcolor

color

Controls how to draw the focus highlight border. When any child to the frame has focus, the border is drawn in the highlightcolor color. Otherwise, it is drawn in the highlightbackground color. The defaults are system specific.

highlightthickness

distance

Controls the width of the focus highlight border. Default is 0 (no border).