TkFrame( WidgetName, [Options]...)

Create and manipulate frame widgets

Arguments:

WidgetName - a standard path-like name used to name the widget.

Options - one or many descriptors for the options that are available for this widget.

Options:

background - This option is the same as the standard background option except that its value may also be specified as an empty string. In this case, the widget will display no background or border, and no colors will be consumed from its colormap for its background and border.

class - Specifies a class for the widget. This class will be used when querying the option database for the widget's other options, and it will also be used later for other purposes such as bindings. The class option may not be changed with the TkConfig() function.

colormap - Specifies a colormap to use for the widget. The value may be either "new," in which case a new colormap is created for the widget and its children, or the name of another widget (which must be on the same screen and have the same visual as WidgetName), in which case the new widget will use the colormap from the specified widget. If the colormap option is not specified, the new widget uses the same colormap as its parent. This option may not be changed with the TkConfig() function.

container - The value must be a boolean. If true, it means that this widget will be used as a container in which some other application will be embedded (for example, a TK toplevel can be embedded using the "use" option). The window will support the appropriate window manager protocols for things like geometry requests. The widget should not have any children of its own in this application. This option may not be changed with the TkConfig() function.

height - Specifies the desired height for the widget in any of the forms acceptable to Tk_GetPixels (Tcl/Tk documentation). If this option is less than or equal to zero then the widget will not request any size at all.

visual - Specifies visual information for the new widget in any of the forms accepted by Tk_GetVisual (Tcl/Tk documentation). If this option is not specified, the new widget will use the same visual as its parent. The "visual" option may not be modified with the TkConfig() function.

width - Specifies the desired width for the widget in any of the forms acceptable to Tk_GetPixels (Tcl/Tk documentation). If this option is less than or equal to zero then the widget will not request any size at all.

In addition, the following Standard Options are available: borderwidth, cursor, highlightbackground, highlightcolor, highlightthickness, relief, takefocus

DESCRIPTION

The frame command creates a new window (given by the WidgetName argument) and makes it into a frame widget. Additional options, described above, may be specified to configure aspects of the frame such as its background color and relief. The frame command returns the path name of the new widget.

A frame is a simple widget. Its primary purpose is to act as a spacer or container for complex window layouts. The only features of a frame are its background color and an optional 3-D border to make the frame appear raised or sunken.