1iwidgets::disjointlistbox − Create and manipulate a disjointlist‐
2box widget iwidgets::disjointlistbox pathName ?options?
3itk::Widget <‐ iwidgets::Disjointlistbox
9See the "options" manual entry for details on the standard op‐
10tions.
12See the "button" widget manual entry for details on the above as‐
13sociated options.
15See the "label" widget manual entry for details on the above as‐
16sociated options.
18See the "scrollbar" widget class manual entry for details on the
19above associated options.
22See the "scrolledlistbox" widget manual entry for details on the
23above associated options.
24Name: buttonPlacement
25Class: ButtonPlacement
26Command‐Line Switch: ‐buttonplacement
27Specifies the placement of the insertion and removal buttons rel‐
28ative to the scrolledlistbox widgetsn, bottom, or center. The
29default is bottom.
30Name: lhsLabelText
31Class: LabelText
32Command‐Line Switch: ‐lhslabeltext
33Specifies the text for the label of the lhs scrolledlistbox. The
34default is "Available".
35Name: rhsLabelText
36Class: LabelText
37Command‐Line Switch: ‐rhslabeltext
38Specifies the text for the label of the rhs scrolledlistbox. The
39default is "Available".
40Name: lhsButtonLabel
41Class: LabelText
42Command‐Line Switch: ‐lhsbuttonlabel
43Specifies the text for the button of the lhs scrolledlistbox.
44The default is "Insert >>".
45Name: rhsButtonLabel
46Class: LabelText
47Command‐Line Switch: ‐rhsbuttonlabel
48Specifies the text for the button of the rhs scrolledlistbox.
49The default is "<< Remove".
50Name: lhsSortOption
51Class: LhsSortOption
52Command‐Line Switch: ‐lhssortoption
53Specifies the sort function to be applied to the lhs
54scrolledlistbox after items are inserted. Accepts the same sort
55options as the scrolledlistbox sort method (Tcl’s lsort command).
56If "none" is specified, the inserted items are appended to the
57end of the list, and no sorting is performed. The default is
58"increasing".
59Name: rhsSortOption
60Class: RhsSortOption
61Command‐Line Switch: ‐rhssortoption
62Specifies the sort function to be applied to the rhs
63scrolledlistbox after items are inserted. Accepts the same sort
64options as the scrolledlistbox sort method (Tcl’s lsort command).
65If "none" is specified, the inserted items are appended to the
66end of the list, and no sorting is performed. The default is
67"increasing". The iwidgets::disjointlistbox command creates a
68disjoint pair of listboxs similar to the OSF/Motif "Book" print‐
69ing dialog of the "FrameMaker" program. It is implementation
70constists of a two Scrolledlistboxs, 2 buttons, and 2 labels.
71The disjoint behavior of this widget exists between the interac‐
73tion of the two Scrolledlistboxes with one another. That is, a
74given instance of a Disjointlistbox will never exist, without the
75aid of a hack magician, which has Scrolledlistbox widgets with
76items in common. That means the relationship between the two is
77maintained similar to that of disjoint sets.
78Users may transfer items between the two Listbox widgets using
80the the two buttons.
81Options exists which include the ability to configure the "items"
83displayed by the 2 Scrolledlistboxes and to control the placement
84of the insertion and removal buttons. The iwidgets::dis‐
87on the widget. It has the following general form: pathName op‐
89havior of the command. The following commands are possible for
90disjointlistbox widgets:
91
93tion option given by option. Option may have any of the values
94accepted by the iwidgets::disjointlistbox command. pathName con‐
96configuration options of the widget. If no option is specified,
97returns a list describing all of the available options for path‐
99list). If option is specified with no value, then the command
100returns a list describing the one named option (this list will be
101identical to the corresponding sublist of the value returned if
102no option is specified). If one or more option−value pairs are
103specified, then the command modifies the given widget option(s)
104to have the given value(s); in this case the command returns an
105empty string. Option may have any of the values accepted by the
107rent contents of the left‐most Scrolledlistbox with the input
108list of items. Removes all (if any) items from the right‐most
109Scrolledlistbox which exist in the input list option to maintain
110the disjoint property between the two pathName setrhs Set the
111current contents of the right‐most Scrolledlistbox with the input
112list of items. Removes all (if any) items from the left‐most
113Scrolledlistbox which exist in the input list option to maintain
114the disjoint property between the two pathName getlhs Returns the
115current contents of the left‐most Scrolledlistbox pathName getrhs
116Returns the current contents of the right‐most Scrolledlistbox
118contents of the left‐most Scrolledlistbox. Removes all (if any)
119items from the right‐most Scrolledlistbox which exist in the in‐
120put list option to maintain the disjoint property between the two
122contents of the right‐most Scrolledlistbox. Removes all (if any)
123items from the left‐most Scrolledlistbox which exist in the input
124list option to maintain the disjoint property between the two.
125Name: lhs
126Class: Scrolledlistbox
127The lhs component is the scrolledlistbox for the rhs button. See
128the "scrolledlistbox" widget manual entry for details on the lhs
129component item.
130Name: rhs
131Class: Scrolledlistbox
132The rhs component is the scrolledlistbox for the rhs button. See
133the "scrolledlistbox" widget manual entry for details on the rhs
134component item.
135Name: lhsbutton
136Class: utton
137The lhsbutton component is the button for users to remove select‐
138ed items from the lhs Scrolledlistbox. See the "button" widget
139manual entry for details on the lhs button component.
140Name: rhsbutton
141Class: Button
142The rhsbutton component is the button for users to remove select‐
143ed items from the rhs Scrolledlistbox. See the "button" widget
144manual entry for details on the rhs button component.
145Name: lhsCount
146Class: Label
147The lhsCount component is the label for displaying a count of the
148current items in the Scrolledlistbox. See the "Label" widget
149manual entry for details on the lhsCount label component.
150Name: rhsCount
151Class: Label
152The rhsCount component is the label for displaying a count of the
153current items in the Scrolledlistbox. See the "Label" widget
154manual entry for details on the rhsCount label component.
155package require Iwidgets 4.0 iwidgets::disjointlistbox .dlb pack
156.dlb ‐padx 10 ‐pady 10 ‐fill both ‐expand yes John A. Tucker An‐
157thony Parent disjointlistbox, widget
158