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



______________________________________________________________________________

NAME
       toplevel - Create and manipulate toplevel widgets

SYNOPSIS
       toplevel 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  toplevel command creates a new toplevel widget (given by the path-
       Name argument).	Additional options, described above, may be  specified
       on  the	command line or in the option database to configure aspects of
       the toplevel such as its background color  and  relief.	 The  toplevel
       command returns the path name of the new window.

       A  toplevel  is	similar to a frame except that it is created as a top-
       level window: its parent with respect to screen real estate is the ter-
       minal's	screen rather than the logical parent from its path name.  The
       primary purpose of a toplevel is to serve as  a	container  for	dialog
       boxes and other collections of widgets.	The only visible features of a
       toplevel are its background color, attributes and border.


WIDGET COMMAND
       The toplevel command creates a new Tcl command whose name is  the  same
       as the path name of the toplevel'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 toplevel widget's path name.  Option and
       the  args  determine  the exact behavior of the command.	 The following
       commands are possible for toplevel 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
	      toplevel 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 op-
	      tion-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 toplevel command.


PLACEMENT
       The  only  means	 to place a toplevel widget on the screen is the place
       geometry manager.


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


KEYWORDS
       toplevel, widget, place



Ck				      8.0			   toplevel(n)
