1tixExFileSelectBox(n)        Tix Built-In Commands       tixExFileSelectBox(n)
2
3
4

NAME

6       tixExFileSelectBox - Create and manipulate tixExFileSelectBox widgets
7

SYNOPSIS

9       tixExFileSelectBox pathName ?options?
10

SUPER-CLASS

12       The TixExFileSelectBox class does not have a super-class.
13

STANDARD OPTIONS

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

WIDGET-SPECIFIC OPTIONS

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
42       Name:          directory
43       Class:         Directory
44       Switch:        -directory
45       Alias:         -dir
46
47              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
72       Name:          value
73       Class:         Value
74       Switch:        -value
75       Alias:         -selection
76
77              Specifies the name of the filename  currently  selected  by  the
78              user.
79

SUBWIDGETS

81       Name:          cancel
82       Class:         Button
83
84              The button widget with the "Cancel" label.
85
86       Name:          dir
87       Class:         TixComboBox
88
89              The ComboBox subwidget under the "Directories" heading.
90
91       Name:          dirlist
92       Class:         TixDirList
93
94              The DirList subwidget that shows the hierarchical list of direc‐
95              tories.
96
97       Name:          file
98       Class:         TixComboBox
99
100              The ComboBox subwidget under the "Files" heading.
101
102       Name:          filelist
103       Class:         TixScrolledListBox
104
105              The ScrolledListBox subwidget that shows the list of filenames.
106
107       Name:          hidden
108       Class:         Checkbutton
109
110              The checkbutton widget with the "Show Hidden Files" label.
111
112       Name:          ok
113       Class:         Button
114
115              The button widget with the "OK" label.
116
117       Name:          types
118       Class:         TixComboBox
119
120              The ComboBox subwidget under the "List Files of Type" heading.
121

DESCRIPTION

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
129       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

WIDGET COMMANDS

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
145       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
150       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
163       pathName filter
164              Forces the ExFileSelectBox widget to re-filter all the filenames
165              according to the -pattern option.
166
167       pathName invoke
168              Forces the ExFileSelectBox widget to perform actions as  if  the
169              user has pressed the "OK" button.
170
171       pathName subwidget  name ?args?
172              When  no options are given, this command returns the pathname of
173              the subwidget of the specified name.
174
175              When options are given, the widget command of the specified sub‐
176              widget will be called with these options.
177

KEYWORDS

179       Tix(n)
180
181
182
183
184
185
186Tix                                   4.0                tixExFileSelectBox(n)
Impressum