1swaplist(An)dialog which allows a user to move options between two lisstwsaplist(n)
2
3
4
5______________________________________________________________________________
6

NAME

8       swaplist  -  A  dialog  which allows a user to move options between two
9       lists
10

SYNOPSIS

12       package require Tcl  8.4
13
14       package require Tk  8.4
15
16       package require swaplist  ?0.1?
17
18       ::swaplist::swaplist pathName variable completeList  selectedList  ?op‐
19       tions?
20
21______________________________________________________________________________
22

DESCRIPTION

24       This  package  provides  a  dialog which consists of 2 listboxes, along
25       with buttons to move items between them and reorder the right list.
26
27       ::swaplist::swaplist pathName variable completeList  selectedList  ?op‐
28       tions?
29              Creates  a  dialog  which presents the user with a pair of list‐
30              boxes. Items are selected by using the buttons to move  them  to
31              the  right  list.  The contents of the right list are put in the
32              variable upon closure of the  dialog.   The  command  returns  a
33              boolean  indicating  if the user pressed OK or not. If -geometry
34              is not specified, the dialog is centered in its parent  toplevel
35              unless  its  parent is . in which case the dialog is centered in
36              the screen.
37
38              Options:
39
40              -embed if this flag is supplied, the  procedure  will  create  a
41                     swaplist  widget named pathName, with the variable set as
42                     the listvariable for the right side  listbox.  This  flag
43                     will  also cause the -title and -geometry flags to be ig‐
44                     nored.
45
46              -reorder
47                     boolean specifying if buttons allowing the user to change
48                     the  order of the right listbox should appear or not. de‐
49                     faults to true
50
51              -title sets the title of the dialog window. defaults to "Config‐
52                     uration"
53
54              -llabel
55                     sets the heading above the left list. defaults to "Avail‐
56                     able:"
57
58              -rlabel
59                     sets the heading above the right list. defaults  to  "Se‐
60                     lected:"
61
62              -lbuttontext
63                     sets the text on the "move left" button. defaults to "<<"
64
65              -rbuttontext
66                     sets  the  text  on  the "move right" button. defaults to
67                     ">>"
68
69              -ubuttontext
70                     sets the text on the "move up" button. defaults to  "Move
71                     Up"
72
73              -dbuttontext
74                     sets  the  text  on  the  "move down" button. defaults to
75                     "Move Down"
76
77              -geometry
78                     sets the geometry of the dialog window.
79

EXAMPLE

81              package require swaplist
82              namespace import swaplist::*
83
84              if {[swaplist .slist opts "1 2 3 4 5 6 7 8 9" "1 3 5"]} {
85                  puts "user chose numbers: $ops"
86              }
87
88
89

KEYWORDS

91       dialog, disjointlistbox, listbox
92
93
94
95swaplist                              0.1                          swaplist(n)
Impressum