1iwidgets::extfileselectionbox − Create and manipulate a file se‐
2lection box widget iwidgets::extfileselectionbox pathName ?op‐
8See the "options" manual entry for details on the standard op‐
9tions.
11See the "combobox" widget manual entry for details on the above
12associated options.
14See the "labeledwidget" widget manual entry for details on the
15above associated options.
17See the "panedwindow" widget manual entry for details on the
18above associated options.
20See the "scrollbar" widget class manual entry for details on the
21above associated options.
23See the "scrolledlistbox" widget manual entry for details on the
24above associated options.
25Name: automount
26Class: Automount
27Command‐Line Switch: ‐automount
28Specifies a list of directory prefixes to ignore. Typically, this
29option would be used as follows:
30 ‐automount {export tmp_mnt}
31Name: childSitePos
32Class: Position
33Command‐Line Switch: ‐childsitepos
34Specifies the position of the child site in the extended filese‐
35lection box: n, s, e, w, top, or bottom. The default is s.
36Name: directory
37Class: Directory
38Command‐Line Switch: ‐directory
39Specifies the initial default directory. The default is the
40present working directory.
41Name: dirSearchCommand
42Class: Command
43Command‐Line Switch: ‐dirsearchcommand
44Specifies a Tcl command to be executed to perform a directory
45search. The command will receive the current working directory
46and filter mask as arguments. The command should return a list
47of files which will be placed into the directory list.
48Name: dirsLabel
49Class: Text
50Command‐Line Switch: ‐dirslabel
51Specifies the text of the label for the directory list. The de‐
52fault is "Directories".
53Name: dirsOn
54Class: DirsOn
55Command‐Line Switch: ‐dirson
56Specifies whether or not to display the directory list. The val‐
57ue may be given in any of the forms acceptable to Tcl_GetBoolean.
58The default is true.
59Name: fileSearchCommand
60Class: Command
61Command‐Line Switch: ‐filesearchcommand
62Specifies a Tcl command to be executed to perform a file search.
63The command will receive the current working directory and filter
64mask as arguments. The command should return a list of files
65which will be placed into the file list.
66Name: filesLabel
67Class: Text
68Command‐Line Switch: ‐fileslabel
69Specifies the text of the label for the files list. The default
70is "Files".
71Name: filesOn
72Class: FilesOn
73Command‐Line Switch: ‐fileson
74Specifies whether or not to display the files list. The value
75may be given in any of the forms acceptable to Tcl_GetBoolean.
76The default is true.
77Name: fileType
78Class: FileType
79Command‐Line Switch: ‐filetype
80Specify the type of files which may appear in the file list: reg‐
82Name: filterCommand
83Class: Command
84Command‐Line Switch: ‐filtercommand
85Specifies a Tcl command to be executed upon hitting the Return
86key in the filter combobox widget.
87Name: filterLabel
88Class: Text
89Command‐Line Switch: ‐filterlabel
90Specifies the text of the label for the filter combobox. The de‐
91fault is "Filter".
92Name: filterOn
93Class: FilterOn
94Command‐Line Switch: ‐filteron
95Specifies whether or not to display the filter combobox. The
96value may be given in any of the forms acceptable to Tcl_Get‐
98Name: height
99Class: Height
100Command‐Line Switch: ‐height
101Specifies the height of the selection box. The value may be
102specified in any of the forms acceptable to Tk_GetPixels. The
103default is 300 pixels.
104Name: invalid
105Class: Command
106Command‐Line Switch: ‐invalid
107Command to be executed should the filter contents be proven in‐
108valid. The default is {bell}.
109Name: mask
110Class: Mask
111Command‐Line Switch: ‐mask
112Specifies the initial file mask string. The default is "*".
113Name: noMatchString
114Class: NoMatchString
115Command‐Line Switch: ‐nomatchstring
116Specifies the string to be displayed in the files list should no
117files match the mask. The default is "".
118Name: selectDirCommand
119Class: Command
120Command‐Line Switch: ‐selectdirommand
121Specifies a Tcl command to be executed following selection of a
122directory in the directory list.
123Name: selectFileCommand
124Class: Command
125Command‐Line Switch: ‐selectfileommand
126Specifies a Tcl command to be executed following selection of a
127file in the files list.
128Name: selectionCommand
129Class: Command
130Command‐Line Switch: ‐selectioncommand
131Specifies a Tcl command to be executed upon hitting the Return
132key in the selection combobox widget.
133Name: selectionLabel
134Class: Text
135Command‐Line Switch: ‐selectionlabel
136Specifies the text of the label for the selection combobox. The
137default is "Selection".
138Name: selectionOn
139Class: SelectionOn
140Command‐Line Switch: ‐selectionon
141Specifies whether or not to display the selection combobox. The
142value may be given in any of the forms acceptable to Tcl_Get‐
144Name: width
145Class: Width
146Command‐Line Switch: ‐width
147Specifies the width of the selection box. The value may be spec‐
148ified in any of the forms acceptable to Tk_GetPixels. The de‐
149fault is 350 pixels.
150The iwidgets::extfileselectionbox command creates an extended
152file selection box which is slightly different than the filese‐
153lectionbox widget. The differences are mostly cosmetic in that
154the listboxes are within a panedwindow and the entryfields for
155the filter and selection have been replaced by comboboxes. Other
156than that the interface is practically the same.
157The iwidgets::extfileselectionbox command creates a new Tcl com‐
159mand whose name is pathName. This command may be used to invoke
160various operations on the widget. It has the following general
161form: pathName option ?arg arg ...? Option and the args deter‐
162mine the exact behavior of the command. The following commands
163are possible for extfileselectionbox widgets:
164
166tion option given by option. Option may have any of the values
167accepted by the iwidgets::extfileselectionbox command. pathName
170configuration options of the widget. If no option is specified,
171returns a list describing all of the available options for path‐
173list). If option is specified with no value, then the command
174returns a list describing the one named option (this list will be
175identical to the corresponding sublist of the value returned if
176no option is specified). If one or more option−value pairs are
177specified, then the command modifies the given widget option(s)
178to have the given value(s); in this case the command returns an
179empty string. Option may have any of the values accepted by the
181the current contents of the extended file selection box based on
182the current filter combobox value. pathName get Returns the cur‐
183rent value of the selection combobox widget.
184Name: dirs
186Class: Scrolledlistbox
187The dirs component is the directory list box for the extended
188fileselection box. See the "scrolledlistbox" widget manual entry
189for details on the dirs component item.
190Name: files
191Class: Scrolledlistbox
192The files component is the file list box for the extended filese‐
193lection box. See the "scrolledlistbox" widget manual entry for
194details on the files component item.
195Name: filter
196Class: Combobox
197The filter component is the field for user input of the filter
198value. See the "combobox" widget manual entry for details on the
199filter component item.
200Name: selection
201Class: Combobox
202The selection component is the field for user input of the cur‐
203rently selected file value. See the "combobox" widget manual en‐
204try for details on the selection component item.
205package require Iwidgets 4.0 iwidgets::extfileselectionbox .fsb
207pack .fsb ‐padx 10 ‐pady 10 ‐fill both ‐expand yes Mark L.
208Ulferts Anthony Parent extfileselectionbox, widget
209