[incr Widgets] - labeledwidget manpage





NAME

       labeledwidget - Create and manipulate a labeled widget


SYNOPSIS

       labeledwidget pathName ?options?


INHERITANCE

       itk::Widget <- labeledwidget


STANDARD OPTIONS

       background      cursor         foreground

       See the "options" manual entry for details on the standard
       options.


WIDGET-SPECIFIC OPTIONS

       Name:           disabledForeground
       Class:          DisabledForeground
       Command-Line Switch:           -disabledforeground

              Specifies the foreground to be used when the  state
              is disabled.

       Name:           labelBitmap
       Class:          Bitmap
       Command-Line Switch:           -labelbitmap

              Specifies a bitmap to display in the widget, in any
              of the  forms  acceptable  to  Tk_GetBitmap.   This
              option overrides the labeltext option.

       Name:           labelFont
       Class:          Font
       Command-Line Switch:           -labelfont

              Specifies the font to be used for the label.

       Name:           labelImage
       Class:          Image
       Command-Line Switch:           -labelimage

              Specifies  a  image  to  be  used as the label. The
              image may be any of the values created by the image
              create  command.   This  option  overrides both the
              labelbitmap and labeletext options.

       Name:           labelMargin
       Class:          Margin
       Command-Line Switch:           -labelmargin

              Specifies the distance between  the  childsite  and

       Name:           labelPos
       Class:          Position
       Command-Line Switch:           -labelpos

              Specifies the position of the label along the  side
              of  the childsite: nw, n, ne, sw, s, se, en, e, es,
              wn, w, or ws.  The default is w.

       Name:           labelText
       Class:          Text
       Command-Line Switch:           -labeltext

              Specifies the text of the label around  the  child­
              site.

       Name:           labelVariable
       Class:          Variable
       Command-Line Switch:           -labelvariable

              Specifies the text variable of the label around the
              childsite.

       Name:           state
       Class:          State
       Command-Line Switch:           -state

              Specifies one of two states for the  label:  normal
              or  disabled.   If the label is disabled then it is
              displayed in  a  disabled  foreground  color.   The
              default is normal.

_________________________________________________________________



DESCRIPTION

       The  labeledwidget  command creates a labeled widget which
       contains a label and child site.   The  child  site  is  a
       frame which can filled with any widget via a derived class
       or though the use of the childsite method.  This class was
       designed to be a general purpose base class for supporting
       the combination of label  widget  and  a  childsite.   The
       options  include  the ability to position the label around
       the childsite widget, modify the font and margin, and con­
       trol the display of the labels.



METHODS

       The  labeledwidget command creates a new Tcl command whose
       name is pathName.  This command may be used to invoke var­
       ious  operations on the widget.  It has the following gen­
       eral form:

       Option and the args determine the exact  behavior  of  the
       command.  The following commands are possible for labeled­
       widget widgets:


WIDGET-SPECIFIC METHODS

       pathName childsite
              Return the path name of the child site.

       pathName cget option
              Returns the  current  value  of  the  configuration
              option given by option.  Option may have any of the
              values accepted by the labeledwidget 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 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 labeledwidget command.



STATIC METHODS

       Labeledwidget::alignlabels widget ?widget ...?
              The  alignlabels  procedure takes a list of widgets
              derived from the Labeledwidget class and  uses  the
              label  margin  to  make  each  widget have the same
              total space for the combination of label  and  mar­
              gin.   The  net effect is to left align the labels.
              Generally, this method is only useful with a  label
              position of w, which is the default.



COMPONENTS

       Name:           label
       Class:          label

              The  label  component  provides  the  label for the
              labeled widget.   See  the  "label"  widget  manual
              entry for details on the label component item.

       Name:           lwchildsite
       Class:          frame
              for the labeled widget.   See  the  "frame"  widget
              manual  entry for details on the lwchildsite compo­
              nent item.



EXAMPLE

              The labeledwidget was primarily meant to be a  base
              class.  The ScrolledListBox and EntryField are good
              examples of derived classes  of  the  labeledwidget
              class.   In order to provide equal support for com­
              posite  classes,  the  'childsite'   methods   also
              exists.  The following is an example of 'childsite'
              method usage.


               iwidgets::labeledwidget .lw -labeltext "Canvas Widget" -labelpos s
               pack .lw -fill both -expand yes -padx 10 -pady 10

               set cw [canvas [.lw childsite].c -relief raised -width 200 -height 200]
               pack $cw -padx 10 -pady 10



AUTHOR

       Mark L. Ulferts


KEYWORDS

       labeledwidget, widget


























Man(1) output converted with man2html