NAME

       tixLabelFrame  -  Create and manipulate tixLabelFrame wid­
       gets


SYNOPSIS

       tixLabelFrame pathName ?options?


SUPER-CLASS

       The TixLabelFrame class is derived from the TixLabelWidget
       class  and  inherits all the commands, options and subwid­
       gets of its super-class.


STANDARD OPTIONS

       The LabelFrame widget supports all the standard options of
       a  frame  widget.  See  the  options(n)  manual  entry for
       details on the standard options.


WIDGET-SPECIFIC OPTIONS

       Command-Line Name:-label
       Database Name:  label
       Database Class: Label

              Specifies the string to display  as  the  label  of
              this LabelFrame widget.

       Command-Line Name:-labelside
       Database Name:  labelSide
       Database Class: LabelSide

              Specifies where the label should be displayed rela­
              tive to the entry  subwidget.  Valid  options  are:
              top, left, right, bottom, none or acrosstop.

       Command-Line Name:-padx
       Database Name:  padX
       Database Class: Pad

              Specifies  the  amount  of  the  horizontal padding
              around the frame subwidget. Must be  a  valid  non-
              negative integer number.

       Command-Line Name:-pady
       Database Name:  padY
       Database Class: Pad

              Specifies the amount of the vertical padding around
              the frame subwidget.


SUBWIDGETS

       Name:           frame
       Class:          Frame


       Name:           label
       Class:          Label

              The label subwidget.
_________________________________________________________________


DESCRIPTION

       The tixLabelFrame command creates a new window  (given  by
       the pathName argument) and makes it into a LabelFrame wid­
       get. Additional options, described above, may be specified
       on the command line or in the option database to configure
       aspects of the LabelFrame such as its cursor and relief.


CREATING WIDGETS INSIDE A LABELFRAME

       The LabelFrame widget packages a frame widget and a  label
       into  one  mega  widget. To create widgets inside a Label­
       Frame widget, one must create the new widgets relative  to
       the  frame subwidget and manage them inside the frame sub­
       widget. An error will be generated if one tries to  create
       widgets as immediate children of the LabelFrame. For exam­
       ple: the following is correct code, which creates new wid­
       gets inside the frame subwidget:

              tixLabelFrame .f
              set f [.f subwidget frame]
              button $f.b -text hi
              pack $f.b

       The  following  example code is incorrect because it tries
       to create immediate children of the LabelFrame .f:

              tixLabelFrame .f
              # wrong!
              button .f.b -text hi
              pack .f.b


WIDGET COMMANDS

       The tixLabelFrame command creates a new Tcl command  whose
       name is the same as the path name of the LabelFrame's win­
       dow. 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 command, which is the same as
       the LabelFrame widget's path name.  Option  and  the  args
       determine the exact behavior of the command. The following
       commands are possible for LabelFrame 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 tixLabelFrame command.

              Query or modify the configuration  options  of  the
              widget.   If no option is specified, returns a list
              describing all of the available options  for  path­
              Name  (see  Tk_ConfigureInfo for information on the
              format of this list).  If option is specified  with
              no  value, then the command returns a list describ­
              ing the one named option (this list will be identi­
              cal  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 tixLabelFrame command.

       pathName subwidget name ?args?
              When no options are given, this command returns the
              pathname of the subwidget of the specified name.

       When options are given, the widget command of  the  speci­
       fied subwidget will be called with these options.


KEYWORDS

       label frame, widget


Man(1) output converted with man2html