21 </head> |
21 </head> |
22 <body><a NAME="top" ID="top"></a> |
22 <body><a NAME="top" ID="top"></a> |
23 <h1>eric5.E5Gui.E5FileDialog</h1> |
23 <h1>eric5.E5Gui.E5FileDialog</h1> |
24 <p> |
24 <p> |
25 Module implementing alternative functions for the QFileDialog static methods |
25 Module implementing alternative functions for the QFileDialog static methods |
26 to cope with dustributor's usage of KDE wrapper dialogs for Qt file dialogs. |
26 to cope with distributor's usage of KDE wrapper dialogs for Qt file dialogs. |
27 </p> |
27 </p> |
28 <h3>Global Attributes</h3> |
28 <h3>Global Attributes</h3> |
29 <table> |
29 <table> |
30 <tr><td>None</td></tr> |
30 <tr><td>DontConfirmOverwrite</td></tr><tr><td>DontResolveSymlinks</td></tr><tr><td>DontUseNativeDialog</td></tr><tr><td>DontUseSheet</td></tr><tr><td>HideNameFilterDetails</td></tr><tr><td>ReadOnly</td></tr><tr><td>ShowDirsOnly</td></tr> |
31 </table> |
31 </table> |
32 <h3>Classes</h3> |
32 <h3>Classes</h3> |
33 <table> |
33 <table> |
34 <tr><td>None</td></tr> |
34 <tr><td>None</td></tr> |
35 </table> |
35 </table> |
37 <table> |
37 <table> |
38 <tr> |
38 <tr> |
39 <td><a href="#__reorderFilter">__reorderFilter</a></td> |
39 <td><a href="#__reorderFilter">__reorderFilter</a></td> |
40 <td>Private function to reorder the file filter to cope with a KDE issue introduced by distributor's usage of KDE file dialogs.</td> |
40 <td>Private function to reorder the file filter to cope with a KDE issue introduced by distributor's usage of KDE file dialogs.</td> |
41 </tr><tr> |
41 </tr><tr> |
|
42 <td><a href="#getExistingDirectory">getExistingDirectory</a></td> |
|
43 <td>Module function to get the name of a directory.</td> |
|
44 </tr><tr> |
|
45 <td><a href="#getOpenFileName">getOpenFileName</a></td> |
|
46 <td>Module function to get the name of a file for opening it.</td> |
|
47 </tr><tr> |
42 <td><a href="#getOpenFileNameAndFilter">getOpenFileNameAndFilter</a></td> |
48 <td><a href="#getOpenFileNameAndFilter">getOpenFileNameAndFilter</a></td> |
43 <td>Module function to get the name of a file for opening it and the selected file name filter.</td> |
49 <td>Module function to get the name of a file for opening it and the selected file name filter.</td> |
44 </tr><tr> |
50 </tr><tr> |
|
51 <td><a href="#getOpenFileNames">getOpenFileNames</a></td> |
|
52 <td>Module function to get a list of names of files for opening.</td> |
|
53 </tr><tr> |
45 <td><a href="#getOpenFileNamesAndFilter">getOpenFileNamesAndFilter</a></td> |
54 <td><a href="#getOpenFileNamesAndFilter">getOpenFileNamesAndFilter</a></td> |
46 <td>Module function to get a list of names of files for opening and the selected file name filter.</td> |
55 <td>Module function to get a list of names of files for opening and the selected file name filter.</td> |
|
56 </tr><tr> |
|
57 <td><a href="#getSaveFileName">getSaveFileName</a></td> |
|
58 <td>Module function to get the name of a file for saving it.</td> |
47 </tr><tr> |
59 </tr><tr> |
48 <td><a href="#getSaveFileNameAndFilter">getSaveFileNameAndFilter</a></td> |
60 <td><a href="#getSaveFileNameAndFilter">getSaveFileNameAndFilter</a></td> |
49 <td>Module function to get the name of a file for saving it and the selected file name filter.</td> |
61 <td>Module function to get the name of a file for saving it and the selected file name filter.</td> |
50 </tr> |
62 </tr> |
51 </table> |
63 </table> |
52 <hr /><hr /> |
64 <hr /><hr /> |
53 <a NAME="__reorderFilter" ID="__reorderFilter"></a> |
65 <a NAME="__reorderFilter" ID="__reorderFilter"></a> |
54 <h2>__reorderFilter</h2> |
66 <h2>__reorderFilter</h2> |
55 <b>__reorderFilter</b>(<i>filter, initialFilter = ""</i>) |
67 <b>__reorderFilter</b>(<i>filter, initialFilter = ""</i>) |
56 <p> |
68 <p> |
57 Private function to reorder the file filter to cope with a KDE issue introduced |
69 Private function to reorder the file filter to cope with a KDE issue |
58 by distributor's usage of KDE file dialogs. |
70 introduced by distributor's usage of KDE file dialogs. |
59 </p><dl> |
71 </p><dl> |
60 <dt><i>filter</i></dt> |
72 <dt><i>filter</i></dt> |
61 <dd> |
73 <dd> |
62 Qt file filter (string) |
74 Qt file filter (string) |
63 </dd><dt><i>initialFilter</i></dt> |
75 </dd><dt><i>initialFilter</i></dt> |
66 </dd> |
78 </dd> |
67 </dl><dl> |
79 </dl><dl> |
68 <dt>Returns:</dt> |
80 <dt>Returns:</dt> |
69 <dd> |
81 <dd> |
70 the rearranged Qt file filter (string) |
82 the rearranged Qt file filter (string) |
|
83 </dd> |
|
84 </dl> |
|
85 <div align="right"><a href="#top">Up</a></div> |
|
86 <hr /><hr /> |
|
87 <a NAME="getExistingDirectory" ID="getExistingDirectory"></a> |
|
88 <h2>getExistingDirectory</h2> |
|
89 <b>getExistingDirectory</b>(<i>parent = None, caption = "", directory = "", options = QFileDialog.ShowDirsOnly</i>) |
|
90 <p> |
|
91 Module function to get the name of a directory. |
|
92 </p><dl> |
|
93 <dt><i>parent</i></dt> |
|
94 <dd> |
|
95 parent widget of the dialog (QWidget) |
|
96 </dd><dt><i>caption</i></dt> |
|
97 <dd> |
|
98 window title of the dialog (string) |
|
99 </dd><dt><i>directory</i></dt> |
|
100 <dd> |
|
101 working directory of the dialog (string) |
|
102 </dd><dt><i>options</i></dt> |
|
103 <dd> |
|
104 various options for the dialog (QFileDialog.Options) |
|
105 </dd> |
|
106 </dl><dl> |
|
107 <dt>Returns:</dt> |
|
108 <dd> |
|
109 name of selected directory (string) |
|
110 </dd> |
|
111 </dl> |
|
112 <div align="right"><a href="#top">Up</a></div> |
|
113 <hr /><hr /> |
|
114 <a NAME="getOpenFileName" ID="getOpenFileName"></a> |
|
115 <h2>getOpenFileName</h2> |
|
116 <b>getOpenFileName</b>(<i>parent = None, caption = "", directory = "", filter = "", options = QFileDialog.Options()</i>) |
|
117 <p> |
|
118 Module function to get the name of a file for opening it. |
|
119 </p><dl> |
|
120 <dt><i>parent</i></dt> |
|
121 <dd> |
|
122 parent widget of the dialog (QWidget) |
|
123 </dd><dt><i>caption</i></dt> |
|
124 <dd> |
|
125 window title of the dialog (string) |
|
126 </dd><dt><i>directory</i></dt> |
|
127 <dd> |
|
128 working directory of the dialog (string) |
|
129 </dd><dt><i>filter</i></dt> |
|
130 <dd> |
|
131 filter string for the dialog (string) |
|
132 </dd><dt><i>options</i></dt> |
|
133 <dd> |
|
134 various options for the dialog (QFileDialog.Options) |
|
135 </dd> |
|
136 </dl><dl> |
|
137 <dt>Returns:</dt> |
|
138 <dd> |
|
139 name of file to be opened (string) |
71 </dd> |
140 </dd> |
72 </dl> |
141 </dl> |
73 <div align="right"><a href="#top">Up</a></div> |
142 <div align="right"><a href="#top">Up</a></div> |
74 <hr /><hr /> |
143 <hr /><hr /> |
75 <a NAME="getOpenFileNameAndFilter" ID="getOpenFileNameAndFilter"></a> |
144 <a NAME="getOpenFileNameAndFilter" ID="getOpenFileNameAndFilter"></a> |
104 name of file to be opened and selected filter (string, string) |
173 name of file to be opened and selected filter (string, string) |
105 </dd> |
174 </dd> |
106 </dl> |
175 </dl> |
107 <div align="right"><a href="#top">Up</a></div> |
176 <div align="right"><a href="#top">Up</a></div> |
108 <hr /><hr /> |
177 <hr /><hr /> |
|
178 <a NAME="getOpenFileNames" ID="getOpenFileNames"></a> |
|
179 <h2>getOpenFileNames</h2> |
|
180 <b>getOpenFileNames</b>(<i>parent = None, caption = "", directory = "", filter = "", options = QFileDialog.Options()</i>) |
|
181 <p> |
|
182 Module function to get a list of names of files for opening. |
|
183 </p><dl> |
|
184 <dt><i>parent</i></dt> |
|
185 <dd> |
|
186 parent widget of the dialog (QWidget) |
|
187 </dd><dt><i>caption</i></dt> |
|
188 <dd> |
|
189 window title of the dialog (string) |
|
190 </dd><dt><i>directory</i></dt> |
|
191 <dd> |
|
192 working directory of the dialog (string) |
|
193 </dd><dt><i>filter</i></dt> |
|
194 <dd> |
|
195 filter string for the dialog (string) |
|
196 </dd><dt><i>options</i></dt> |
|
197 <dd> |
|
198 various options for the dialog (QFileDialog.Options) |
|
199 </dd> |
|
200 </dl><dl> |
|
201 <dt>Returns:</dt> |
|
202 <dd> |
|
203 list of file names to be opened (list of string) |
|
204 </dd> |
|
205 </dl> |
|
206 <div align="right"><a href="#top">Up</a></div> |
|
207 <hr /><hr /> |
109 <a NAME="getOpenFileNamesAndFilter" ID="getOpenFileNamesAndFilter"></a> |
208 <a NAME="getOpenFileNamesAndFilter" ID="getOpenFileNamesAndFilter"></a> |
110 <h2>getOpenFileNamesAndFilter</h2> |
209 <h2>getOpenFileNamesAndFilter</h2> |
111 <b>getOpenFileNamesAndFilter</b>(<i>parent = None, caption = "", directory = "", filter = "", initialFilter = "", options = QFileDialog.Options()</i>) |
210 <b>getOpenFileNamesAndFilter</b>(<i>parent = None, caption = "", directory = "", filter = "", initialFilter = "", options = QFileDialog.Options()</i>) |
112 <p> |
211 <p> |
113 Module function to get a list of names of files for opening and the selected |
212 Module function to get a list of names of files for opening and the |
114 file name filter. |
213 selected file name filter. |
115 </p><dl> |
214 </p><dl> |
116 <dt><i>parent</i></dt> |
215 <dt><i>parent</i></dt> |
117 <dd> |
216 <dd> |
118 parent widget of the dialog (QWidget) |
217 parent widget of the dialog (QWidget) |
119 </dd><dt><i>caption</i></dt> |
218 </dd><dt><i>caption</i></dt> |
135 </dl><dl> |
234 </dl><dl> |
136 <dt>Returns:</dt> |
235 <dt>Returns:</dt> |
137 <dd> |
236 <dd> |
138 list of file names to be opened and selected filter |
237 list of file names to be opened and selected filter |
139 (list of string, string) |
238 (list of string, string) |
|
239 </dd> |
|
240 </dl> |
|
241 <div align="right"><a href="#top">Up</a></div> |
|
242 <hr /><hr /> |
|
243 <a NAME="getSaveFileName" ID="getSaveFileName"></a> |
|
244 <h2>getSaveFileName</h2> |
|
245 <b>getSaveFileName</b>(<i>parent = None, caption = "", directory = "", filter = "", options = QFileDialog.Options()</i>) |
|
246 <p> |
|
247 Module function to get the name of a file for saving it. |
|
248 </p><dl> |
|
249 <dt><i>parent</i></dt> |
|
250 <dd> |
|
251 parent widget of the dialog (QWidget) |
|
252 </dd><dt><i>caption</i></dt> |
|
253 <dd> |
|
254 window title of the dialog (string) |
|
255 </dd><dt><i>directory</i></dt> |
|
256 <dd> |
|
257 working directory of the dialog (string) |
|
258 </dd><dt><i>filter</i></dt> |
|
259 <dd> |
|
260 filter string for the dialog (string) |
|
261 </dd><dt><i>options</i></dt> |
|
262 <dd> |
|
263 various options for the dialog (QFileDialog.Options) |
|
264 </dd> |
|
265 </dl><dl> |
|
266 <dt>Returns:</dt> |
|
267 <dd> |
|
268 name of file to be saved (string) |
140 </dd> |
269 </dd> |
141 </dl> |
270 </dl> |
142 <div align="right"><a href="#top">Up</a></div> |
271 <div align="right"><a href="#top">Up</a></div> |
143 <hr /><hr /> |
272 <hr /><hr /> |
144 <a NAME="getSaveFileNameAndFilter" ID="getSaveFileNameAndFilter"></a> |
273 <a NAME="getSaveFileNameAndFilter" ID="getSaveFileNameAndFilter"></a> |