1tixExFileSelectBox(n) Tix Built-In Commands tixExFileSelectBox(n)
2
6 tixExFileSelectBox - Create and manipulate tixExFileSelectBox widgets
7
9 tixExFileSelectBox pathName ?options?
10
12 The TixExFileSelectBox class does not have a super-class.
13
15 TixExFileSelectBox supports all the standard options of a frame widget.
16 See the options(n) manual entry for details on the standard options.
17
19 [-browsecmd browseCmd] Specifies a command to call whenever the user
20 browses on a filename in the file listbox (usually by single-clicking
21 on the filename). The command is called with one argument, the complete
22 pathname of the file. [-command command] Specifies the command to be
23 called when the user chooses on a filename the file listbox (usually by
24 double-clicking on the filename). The command is called with one argu‐
25 ment, the complete pathname of the file. [-dialog dialog] Specifies a
26 dialog box which contains this ExFileSelectBox widget. The dialog box
27 must be a widget of the class TixShell or its descendant classes. This
28 is an internal option and should not be used by application program‐
29 mers. [-dircmd dircmd] Specifies the TCL command to be called when a
30 file listing is needed for a particular directory. If this option is
31 not specified, by default the ExFileSelectBox widget will attempt to
32 read the directory as a Unix directory. On special occasions, the
33 application programmer may want to supply a special method for reading
34 directories: for example, when he needs to list remote files. In this
35 case, the -dircmd option can be used. The specified command accepts
36 three arguments: the first is the name of the directory to be listed;
37 the second is a list of file patterns, the third is a Boolean value
38 indicating whether hidden files should be listed. This command returns
39 a list of names of the files of this directory which match with the
40 file patterns.
41 Name: directory
43 Class: Directory
44 Switch: -directory
45 Alias: -dir
46 Specifies the current directory whose files and sub-directories
48 are displayed in the ExFileSelectBox. [-disablecallback dis‐
49 ableCallback] A boolean value indicating whether callbacks
50 should be disabled. When set to true, the TCL command specified
51 by the -command option is not executed when the -value of the
52 ExFileSelectBox widget changes. [-filetypes fileTypes] Speci‐
53 fies the file types that can be selected from the "List Files of
54 Type:" ComboBox subwidget. The value of this option must be a
55 TCL list; each item of this list must in turn be a list of two
56 elements. The first element is a list of file patterns. The
57 second element is a string that describe these file patterns.
58 For example:
59 tixExFileSelectBox .box -filetypes {
60 {{*} {All files}}
61 {{*.txt} {Text files}}
62 {{*.c *.h} {C source files}}
63 }
64 [-showhidden showHidden] Specifies whether hidden directories
65 should be shown. By default, a directory name starting with a
66 period "." is considered as a hidden directory. [-pattern pat‐
67 tern] Specifies whether the file pattern(s) to match with the
68 files in the current directory. One or more file patterns can be
69 given at the same time. For example, {*.c *.h} will match all
70 files that have either the ".h" or ".c" extensions.
71 Name: value
73 Class: Value
74 Switch: -value
75 Alias: -selection
76 Specifies the name of the filename currently selected by the
78 user.
79
81 Name: cancel
82 Class: Button
83 The button widget with the "Cancel" label.
85 Name: dir
87 Class: TixComboBox
88 The ComboBox subwidget under the "Directories" heading.
90 Name: dirlist
92 Class: TixDirList
93 The DirList subwidget that shows the hierarchical list of direc‐
95 tories.
96 Name: file
98 Class: TixComboBox
99 The ComboBox subwidget under the "Files" heading.
101 Name: filelist
103 Class: TixScrolledListBox
104 The ScrolledListBox subwidget that shows the list of filenames.
106 Name: hidden
108 Class: Checkbutton
109 The checkbutton widget with the "Show Hidden Files" label.
111 Name: ok
113 Class: Button
114 The button widget with the "OK" label.
116 Name: types
118 Class: TixComboBox
119 The ComboBox subwidget under the "List Files of Type" heading.
121
123 The tixExFileSelectBox command creates a new window (given by the path‐
124 Name argument) and makes it into a ExFileSelectBox widget. Additional
125 options, described above, may be specified on the command line or in
126 the option database to configure aspects of the ExFileSelectBox such as
127 its cursor and relief.
128 The ExFileSelectBox widget is usually embedded in a tixExFileSelectDia‐
130 log widget. It provides an convenient method for the user to select
131 files. The style of the ExFileSelectBox widget is very similar to the
132 standard file dialog in MS Windows 3.1.
133
135 The tixExFileSelectBox command creates a new Tcl command whose name is
136 the same as the path name of the ExFileSelectBox's window. This command
137 may be used to invoke various operations on the widget. It has the fol‐
138 lowing general form:
139 pathName option ?arg arg ...?
140 PathName is the name of the command, which is the same as the ExFileSe‐
141 lectBox widget's path name. Option and the args determine the exact
142 behavior of the command. The following commands are possible for
143 ExFileSelectBox widgets:
144 pathName cget option
146 Returns the current value of the configuration option given by
147 option. Option may have any of the values accepted by the tixEx‐
148 FileSelectBox command.
149 pathName configure ?option? ?value option value ...?
151 Query or modify the configuration options of the widget. If no
152 option is specified, returns a list describing all of the avail‐
153 able options for pathName (see Tk_ConfigureInfo for information
154 on the format of this list). If option is specified with no
155 value, then the command returns a list describing the one named
156 option (this list will be identical to the corresponding sublist
157 of the value returned if no option is specified). If one or
158 more option-value pairs are specified, then the command modifies
159 the given widget option(s) to have the given value(s); in this
160 case the command returns an empty string. Option may have any
161 of the values accepted by the tixExFileSelectBox command.
162 pathName filter
164 Forces the ExFileSelectBox widget to re-filter all the filenames
165 according to the -pattern option.
166 pathName invoke
168 Forces the ExFileSelectBox widget to perform actions as if the
169 user has pressed the "OK" button.
170 pathName subwidget name ?args?
172 When no options are given, this command returns the pathname of
173 the subwidget of the specified name.
174 When options are given, the widget command of the specified sub‐
176 widget will be called with these options.
177
179 Tix(n)
180Tix 4.0 tixExFileSelectBox(n)