1iwidgets::fileselectiondialog  − Create and manipulate a file se‐
2lection dialog widget iwidgets::fileselectiondialog pathName ?op‐

tions? itk::Toplevel <‐ iwidgets::Shell <‐ iwidgets::Dialogshell

4<‐ iwidgets::Dialog <‐ iwidgets::Fileselectiondialog

activeBackground background borderWidth cursor

foreground highlightColor highlightThickness insertBackground

insertBorderWidth insertOffTime insertOnTime insertWidth

selectBackground selectBorderWidth selectForeground

9See the "options" manual entry for details on  the  standard  op‐
10tions.

textBackground textFont

12See the "entryfield" widget manual entry for details on the above
13associated options.

childSitePos directory dirsLabel dirSearchCommand

dirsOn filesLabel filesLabelOn fileSearchCommand

filesOn fileType filterLabel filterOn

invalid mask noMatchString selectionLabel

selectionOn

19See the "fileselectionbox" widget manual entry for details on the
20above associated options.

labelFont

22See  the  "labeledwidget"  widget manual entry for details on the
23above associated options.

textBackground textFont

25See the "scrolledlistbox" widget manual entry for details on  the
26above associated options.

activeRelief elementBorderWidth jumptroughColor

28See  the "scrollbar" widget class manual entry for details on the
29above associated options.
30

buttonBoxPadX buttonBoxPadY buttonBoxPos padX

padY separator thickness

33See the "dialogshell" widget manual  entry  for  details  on  the
34above inherited options.

height master modality width

36See  the "shell" widget manual entry for details on the above in‐
37herited options.

title

39See the "Toplevel" widget  manual entry for details on the  above
40inherited options.
41
42The  iwidgets::fileselectiondialog  command creates a file selec‐
43tion dialog similar to the OSF/Motif standard  composite  widget.
44The  fileselectiondialog  is derived from the Dialog class and is
45composed of a FileSelectionBox with attributes set to  manipulate
46the dialog buttons.
47
48The  iwidgets::fileselectiondialog command creates a new Tcl com‐
49mand whose name is pathName.  This command may be used to  invoke
50various  operations  on the widget.  It has the following general
51form: pathName option ?arg arg ...?  Option and the  args  deter‐
52mine  the  exact behavior of the command.  The following commands
53are possible for fileselectiondialog widgets:

get childsite filter

55See the "fileselectionbox" class manual entry for details on  the
56associated methods.

add buttonconfigure defaulthide

insert invoke show

59See  the "buttonbox" widget manual entry for details on the above
60inherited methods.

activate center deactivate

62See the "shell" widget manual entry for details on the above  in‐
63herited methods.
64

pathName cget option Returns the current value of the configura‐

66tion option given by option.  Option may have any of  the  values
67accepted  by the iwidgets::fileselectiondialog command.  pathName

configure ?option? ?value option value ...? Query or modify the

69configuration  options of the widget.  If no option is specified,
70returns a list describing all of the available options for  path‐

Name (see Tk_ConfigureInfo for information on the format of this

72list).  If option is specified with no value,  then  the  command
73returns a list describing the one named option (this list will be
74identical to the corresponding sublist of the value  returned  if
75no  option  is specified).  If one or more option−value pairs are
76specified, then the command modifies the given  widget  option(s)
77to  have the given value(s);  in this case the command returns an
78empty string.  Option may have any of the values accepted by  the

iwidgets::fileselectiondialog command.

80
81Name:           fsb
82Class:          Fileselectionbox
83The  fsb  component is the file selection box for the file selec‐
84tion dialog.  See the "fileselectionbox" widget manual entry  for
85details on the fsb component item.
86
87 package require Iwidgets 4.0
88 #
89 # Non‐modal example
90 #
91 proc okCallback {} {
92     puts "You selected [.nmfsd get]"
93     .nmfsd deactivate
94 }
95
96 iwidgets::fileselectiondialog .nmfsd ‐title Non‐Modal
97 .nmfsd buttonconfigure OK ‐command okCallback
98
99 .nmfsd activate
100
101 #
102 # Modal example
103 #
104 iwidgets::fileselectiondialog .mfsd ‐modality application
105 .mfsd center
106
107 if {[.mfsd activate]} {
108     puts "You selected [.mfsd get]"
109 } else {
110     puts "You cancelled the dialog"
111 } Mark L. Ulferts fileselectiondialog, fileselectionbox, dialog,
112dialogshell, shell, widget
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132