frame(n)		     Ck Built-In Commands		      frame(n)



______________________________________________________________________________

NAME
       frame - Create and manipulate frame widgets

SYNOPSIS
       frame pathName ?options?

STANDARD OPTIONS
       attributes      border	      foreground      takefocus
       background

       See the ``options'' manual entry for details on the standard options.

WIDGET-SPECIFIC OPTIONS
       Name:	       class
       Class:	       Class
       Command-Line Switch:-class

	      Specifies	 a class for the window.  This class will be used when
	      querying the option database for the window'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  configure	widget
	      command.

       Name:	       height
       Class:	       Height
       Command-Line Switch:-height

	      Specifies the desired height for the window in screen lines.  If
	      this option is equal to zero then the window  will  not  request
	      any size at all.

       Name:	       width
       Class:	       Width
       Command-Line Switch:-width

	      Specifies	 the  desired  width for the window in screen columns.
	      If this option is equal to zero then the window will not request
	      any size at all.
_________________________________________________________________


DESCRIPTION
       The frame command creates a new window (given by the pathName argument)
       and makes it into a frame widget.  Additional options, described above,
       may  be specified on the command line or in the option database to con-
       figure  aspects	of  the	 frame	such  as  its  background  color   and
       attributes.  The frame command returns the path name of the new window.

       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, attributes and border.


WIDGET COMMAND
       The  frame  command creates a new Tcl command whose name is the same as
       the path name of the frame's window.   This  command  may  be  used  to
       invoke  various operations on the widget.  It has the following general
       form: pathName option ?arg arg ...?  PathName is the name of  the  com-
       mand,  which  is	 the same as the frame widget's path name.  Option and
       the args determine the exact behavior of the  command.	The  following
       commands are possible for frame widgets:

       pathName cget option
	      Returns  the  current value of the configuration option given by
	      option.  Option may have any of the values accepted by the frame
	      command.

       pathName configure ?option? ?value option value ...?
	      Query  or modify the configuration options of the widget.	 If no
	      option is specified, returns a list describing all of the avail-
	      able options for pathName. If option is specified with no value,
	      then the command returns a list describing the one named	option
	      (this list will be identical to the corresponding sublist of the
	      value returned if no option  is  specified).   If	 one  or  more
	      option-value  pairs are specified, then the command modifies the
	      given widget option(s) to have the given value(s);  in this case
	      the command returns an empty string.  Option may have any of the
	      values accepted by the frame command.


BINDINGS
       When a new frame is created, it has no default event  bindings:	frames
       are not intended to be interactive.


KEYWORDS
       frame, widget



Ck				      8.0			      frame(n)
