NAME

       disjointlistbox  - Create and manipulate a disjointlistbox
       widget


SYNOPSIS

       disjointlistbox pathName ?options?


INHERITANCE

       itk::Widget <- Disjointlistbox


STANDARD OPTIONS

       activeBackground   selectBorderWidth  selectForeground
       activeForeground   activeRelief       background
       borderWidth        buttonPlacement    clientData
       cursor             foreground         highlightColor
       highlightThickness disabledForeground elementBorderWidth

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


ASSOCIATED OPTIONS

       lhsButtonLabel rhsButtonLabel

       See  the  "button"  widget manual entry for details on the
       above associated options.

       labelFont lhsLabelText rhsLabelText

       See the "label" widget manual entry  for  details  on  the
       above associated options.

       jump troughColor

       See  the "scrollbar" widget class manual entry for details
       on the above associated options.

       textBackground textFont
       lhsItems rhsItems

       See the "scrolledlistbox" widget manual entry for  details
       on the above associated options.


WIDGET-SPECIFIC OPTIONS

       Name:           buttonPlacement
       Class:          ButtonPlacement
       Command-Line Switch:           -buttonplacement

              Specifies   the  placement  of  the  insertion  and
              removal buttons  relative  to  the  scrolledlistbox
              widgetsn,  bottom,  or center.  The default is bot­
              tom.

       Class:          LabelText
       Command-Line Switch:           -lhslabeltext

              Specifies  the  text  for  the  label  of  the  lhs
              scrolledlistbox.  The default is "Available".

       Name:           rhsLabelText
       Class:          LabelText
       Command-Line Switch:           -rhslabeltext

              Specifies  the  text  for  the  label  of  the  rhs
              scrolledlistbox.  The default is "Available".

       Name:           lhsButtonLabel
       Class:          LabelText
       Command-Line Switch:           -lhsbuttonlabel

              Specifies the  text  for  the  button  of  the  lhs
              scrolledlistbox.  The default is "Insert >>".

       Name:           rhsButtonLabel
       Class:          LabelText
       Command-Line Switch:           -rhsbuttonlabel

              Specifies  the  text  for  the  button  of  the rhs
              scrolledlistbox.  The default is "<< Remove".

_________________________________________________________________


DESCRIPTION

       The disjointlistbox command creates  a  disjoint  pair  of
       listboxs  similar  to the OSF/Motif "Book" printing dialog
       of the "FrameMaker" program.  It  is  implementation  con­
       stists of a two Scrolledlistboxs, 2 buttons, and 2 labels.

       The disjoint behavior of this widget  exists  between  the
       interaction of the two Scrolledlistboxes with one another.
       That is, a given instance of a Disjointlistbox will  never
       exist,  without  the  aid  of  a  hack magician, which has
       Scrolledlistbox widgets with items in common.  That  means
       the  relationship between the two is maintained similar to
       that of disjoint sets.

       Users may transfer items between the two  Listbox  widgets
       using the the two buttons.

       Options  exists which include the ability to configure the
       "items" displayed by the 2 Scrolledlistboxes and  to  con­
       trol the placement of the insertion and removal buttons.


METHODS

       The  disjointlistbox  command  creates  a  new Tcl command
       whose name is pathName.   This  command  may  be  used  to

       lowing general form:

              pathName option ?arg arg ...?

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


WIDGET-SPECIFIC METHODS

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

       pathName setlhs
              Set  the  current   contents   of   the   left-most
              Scrolledlistbox  with  the  input  list  of  items.
              Removes all (if  any)  items  from  the  right-most
              Scrolledlistbox  which  exist  in  the  input  list
              option to maintain the  disjoint  property  between
              the two

       pathName setrhs
              Set   the   current   contents  of  the  right-most
              Scrolledlistbox  with  the  input  list  of  items.
              Removes  all  (if  any)  items  from  the left-most
              Scrolledlistbox  which  exist  in  the  input  list
              option  to  maintain  the disjoint property between
              the two

       pathName getlhs
              Returns  the  current  contents  of  the  left-most
              Scrolledlistbox

       pathName getrhs
              Returns  the  current  contents  of  the right-most


       pathName insertlhs
              Add the input list of items to the current contents
              of  the left-most Scrolledlistbox.  Removes all (if
              any)  items  from  the  right-most  Scrolledlistbox
              which  exist  in  the input list option to maintain
              the disjoint property between the two

       pathName insertrhs
              Add the input list of items to the current contents
              of the right-most Scrolledlistbox.  Removes all (if
              any) items from the left-most Scrolledlistbox which
              exist in the input list option to maintain the dis­
              joint property between the two.

       COMPONENTS

       Name:           lhs
       Class:          Scrolledlistbox

              The lhs component is the  scrolledlistbox  for  the
              rhs  button.  See the "scrolledlistbox" widget man­
              ual entry for details on the lhs component item.

       Name:           rhs
       Class:          Scrolledlistbox

              The rhs component is the  scrolledlistbox  for  the
              rhs  button.  See the "scrolledlistbox" widget man­
              ual entry for details on the rhs component item.

       Name:           lhsbutton
       Class:          utton

              The lhsbutton component is the button for users  to
              remove selected items from the lhs Scrolledlistbox.
              See the "button" widget manual  entry  for  details
              on the lhs button component.

       Name:           rhsbutton
       Class:          Button

              The  rhsbutton component is the button for users to
              remove selected items from the rhs Scrolledlistbox.
              See  the  "button"  widget manual entry for details
              on the rhs button component.

       Name:           lhsCount
       Class:          Label

              The lhsCount component is the label for  displaying
              a    count    of   the   current   items   in   the

              entry for details  on the lhsCount label component.

       Name:           rhsCount
       Class:          Label

              The rhsCount component is the label for  displaying
              a  count  of the current items in the Scrolledlist­
              box.  See  the  "Label"  widget  manual  entry  for
              details  on the rhsCount label component.


EXAMPLE

              disjointlistbox .dlb
              pack .dlb -padx 10 -pady 10 -fill both -expand yes


AUTHOR(S)

       John A. Tucker

       Anthony Parent


KEYWORDS

       disjointlistbox, widget


Man(1) output converted with man2html