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