5 <link rel="stylesheet" href="styles.css"> |
5 <link rel="stylesheet" href="styles.css"> |
6 </head> |
6 </head> |
7 <body> |
7 <body> |
8 <a NAME="top" ID="top"></a> |
8 <a NAME="top" ID="top"></a> |
9 <h1>eric7.Project.QuickFindFileDialog</h1> |
9 <h1>eric7.Project.QuickFindFileDialog</h1> |
10 |
|
11 <p> |
10 <p> |
12 Module implementing a quick search for files. |
11 Module implementing a quick search for files. |
13 </p> |
12 </p> |
14 <p> |
13 <p> |
15 This is basically the FindFileNameDialog modified to support faster |
14 This is basically the FindFileNameDialog modified to support faster |
16 interactions. |
15 interactions. |
17 </p> |
16 </p> |
|
17 |
18 <h3>Global Attributes</h3> |
18 <h3>Global Attributes</h3> |
19 |
19 <table> |
20 <table> |
20 <tr><td>None</td></tr> |
21 <tr><td>None</td></tr> |
21 </table> |
22 </table> |
22 |
23 <h3>Classes</h3> |
23 <h3>Classes</h3> |
24 |
24 <table> |
25 <table> |
|
26 |
|
27 <tr> |
25 <tr> |
28 <td><a href="#QuickFindFileDialog">QuickFindFileDialog</a></td> |
26 <td><a href="#QuickFindFileDialog">QuickFindFileDialog</a></td> |
29 <td>Class implementing the Quick Find File by Name Dialog.</td> |
27 <td>Class implementing the Quick Find File by Name Dialog.</td> |
30 </tr> |
28 </tr> |
31 </table> |
29 </table> |
|
30 |
32 <h3>Functions</h3> |
31 <h3>Functions</h3> |
33 |
32 <table> |
34 <table> |
33 <tr><td>None</td></tr> |
35 <tr><td>None</td></tr> |
34 </table> |
36 </table> |
35 |
37 <hr /> |
36 <hr /> |
38 <hr /> |
37 <hr /> |
39 <a NAME="QuickFindFileDialog" ID="QuickFindFileDialog"></a> |
38 <a NAME="QuickFindFileDialog" ID="QuickFindFileDialog"></a> |
40 <h2>QuickFindFileDialog</h2> |
39 <h2>QuickFindFileDialog</h2> |
41 |
|
42 <p> |
40 <p> |
43 Class implementing the Quick Find File by Name Dialog. |
41 Class implementing the Quick Find File by Name Dialog. |
44 </p> |
42 </p> |
45 <p> |
43 <p> |
46 This dialog provides a slightly more streamlined behaviour |
44 This dialog provides a slightly more streamlined behaviour |
47 than the standard FindFileNameDialog in that it tries to |
45 than the standard FindFileNameDialog in that it tries to |
48 match any name in the project against (fragmentary) bits of |
46 match any name in the project against (fragmentary) bits of |
49 file names. |
47 file names. |
50 </p> |
48 </p> |
|
49 |
51 <h3>Signals</h3> |
50 <h3>Signals</h3> |
52 <dl> |
51 <dl> |
53 |
52 |
54 <dt>designerFile(str)</dt> |
53 <dt>designerFile(str)</dt> |
55 <dd> |
54 <dd> |
65 </dd> |
64 </dd> |
66 </dl> |
65 </dl> |
67 <h3>Derived from</h3> |
66 <h3>Derived from</h3> |
68 QWidget, Ui_QuickFindFile |
67 QWidget, Ui_QuickFindFile |
69 <h3>Class Attributes</h3> |
68 <h3>Class Attributes</h3> |
70 |
69 <table> |
71 <table> |
70 <tr><td>None</td></tr> |
72 <tr><td>None</td></tr> |
71 </table> |
73 </table> |
72 |
74 <h3>Class Methods</h3> |
73 <h3>Class Methods</h3> |
75 |
74 <table> |
76 <table> |
75 <tr><td>None</td></tr> |
77 <tr><td>None</td></tr> |
76 </table> |
78 </table> |
77 |
79 <h3>Methods</h3> |
78 <h3>Methods</h3> |
80 |
79 <table> |
81 <table> |
|
82 |
|
83 <tr> |
80 <tr> |
84 <td><a href="#QuickFindFileDialog.__init__">QuickFindFileDialog</a></td> |
81 <td><a href="#QuickFindFileDialog.__init__">QuickFindFileDialog</a></td> |
85 <td>Constructor</td> |
82 <td>Constructor</td> |
86 </tr> |
83 </tr> |
87 <tr> |
84 <tr> |
127 <tr> |
124 <tr> |
128 <td><a href="#QuickFindFileDialog.show">show</a></td> |
125 <td><a href="#QuickFindFileDialog.show">show</a></td> |
129 <td>Public method to enable/disable the project checkbox.</td> |
126 <td>Public method to enable/disable the project checkbox.</td> |
130 </tr> |
127 </tr> |
131 </table> |
128 </table> |
|
129 |
132 <h3>Static Methods</h3> |
130 <h3>Static Methods</h3> |
133 |
131 <table> |
134 <table> |
132 <tr><td>None</td></tr> |
135 <tr><td>None</td></tr> |
133 </table> |
136 </table> |
134 |
137 |
135 |
138 <a NAME="QuickFindFileDialog.__init__" ID="QuickFindFileDialog.__init__"></a> |
136 <a NAME="QuickFindFileDialog.__init__" ID="QuickFindFileDialog.__init__"></a> |
139 <h4>QuickFindFileDialog (Constructor)</h4> |
137 <h4>QuickFindFileDialog (Constructor)</h4> |
140 <b>QuickFindFileDialog</b>(<i>project, parent=None</i>) |
138 <b>QuickFindFileDialog</b>(<i>project, parent=None</i>) |
141 |
|
142 <p> |
139 <p> |
143 Constructor |
140 Constructor |
144 </p> |
141 </p> |
|
142 |
145 <dl> |
143 <dl> |
146 |
144 |
147 <dt><i>project</i> (Project)</dt> |
145 <dt><i>project</i> (Project)</dt> |
148 <dd> |
146 <dd> |
149 reference to the project object |
147 reference to the project object |
154 </dd> |
152 </dd> |
155 </dl> |
153 </dl> |
156 <a NAME="QuickFindFileDialog.__generateLocations" ID="QuickFindFileDialog.__generateLocations"></a> |
154 <a NAME="QuickFindFileDialog.__generateLocations" ID="QuickFindFileDialog.__generateLocations"></a> |
157 <h4>QuickFindFileDialog.__generateLocations</h4> |
155 <h4>QuickFindFileDialog.__generateLocations</h4> |
158 <b>__generateLocations</b>(<i></i>) |
156 <b>__generateLocations</b>(<i></i>) |
159 |
|
160 <p> |
157 <p> |
161 Private method to generate a set of locations that can be searched. |
158 Private method to generate a set of locations that can be searched. |
162 </p> |
159 </p> |
|
160 |
163 <dl> |
161 <dl> |
164 <dt>Yield:</dt> |
162 <dt>Yield:</dt> |
165 <dd> |
163 <dd> |
166 set of files in our project |
164 set of files in our project |
167 </dd> |
165 </dd> |
173 </dd> |
171 </dd> |
174 </dl> |
172 </dl> |
175 <a NAME="QuickFindFileDialog.__openFile" ID="QuickFindFileDialog.__openFile"></a> |
173 <a NAME="QuickFindFileDialog.__openFile" ID="QuickFindFileDialog.__openFile"></a> |
176 <h4>QuickFindFileDialog.__openFile</h4> |
174 <h4>QuickFindFileDialog.__openFile</h4> |
177 <b>__openFile</b>(<i>itm=None</i>) |
175 <b>__openFile</b>(<i>itm=None</i>) |
178 |
|
179 <p> |
176 <p> |
180 Private slot to open a file. |
177 Private slot to open a file. |
181 </p> |
178 </p> |
182 <p> |
179 <p> |
183 It emits the signal sourceFile or designerFile depending on the |
180 It emits the signal sourceFile or designerFile depending on the |
184 file extension. |
181 file extension. |
185 </p> |
182 </p> |
|
183 |
186 <dl> |
184 <dl> |
187 |
185 |
188 <dt><i>itm</i> (QTreeWidgetItem)</dt> |
186 <dt><i>itm</i> (QTreeWidgetItem)</dt> |
189 <dd> |
187 <dd> |
190 item to be opened |
188 item to be opened |
203 </dd> |
201 </dd> |
204 </dl> |
202 </dl> |
205 <a NAME="QuickFindFileDialog.__searchFile" ID="QuickFindFileDialog.__searchFile"></a> |
203 <a NAME="QuickFindFileDialog.__searchFile" ID="QuickFindFileDialog.__searchFile"></a> |
206 <h4>QuickFindFileDialog.__searchFile</h4> |
204 <h4>QuickFindFileDialog.__searchFile</h4> |
207 <b>__searchFile</b>(<i></i>) |
205 <b>__searchFile</b>(<i></i>) |
208 |
|
209 <p> |
206 <p> |
210 Private slot to handle the search. |
207 Private slot to handle the search. |
211 </p> |
208 </p> |
|
209 |
212 <a NAME="QuickFindFileDialog.__sortedMatches" ID="QuickFindFileDialog.__sortedMatches"></a> |
210 <a NAME="QuickFindFileDialog.__sortedMatches" ID="QuickFindFileDialog.__sortedMatches"></a> |
213 <h4>QuickFindFileDialog.__sortedMatches</h4> |
211 <h4>QuickFindFileDialog.__sortedMatches</h4> |
214 <b>__sortedMatches</b>(<i>items, searchTerm</i>) |
212 <b>__sortedMatches</b>(<i>items, searchTerm</i>) |
215 |
|
216 <p> |
213 <p> |
217 Private method to find the subset of items which match a search term. |
214 Private method to find the subset of items which match a search term. |
218 </p> |
215 </p> |
|
216 |
219 <dl> |
217 <dl> |
220 |
218 |
221 <dt><i>items</i> (list of str)</dt> |
219 <dt><i>items</i> (list of str)</dt> |
222 <dd> |
220 <dd> |
223 list of items to be scanned for the search term |
221 list of items to be scanned for the search term |
241 </dd> |
239 </dd> |
242 </dl> |
240 </dl> |
243 <a NAME="QuickFindFileDialog.eventFilter" ID="QuickFindFileDialog.eventFilter"></a> |
241 <a NAME="QuickFindFileDialog.eventFilter" ID="QuickFindFileDialog.eventFilter"></a> |
244 <h4>QuickFindFileDialog.eventFilter</h4> |
242 <h4>QuickFindFileDialog.eventFilter</h4> |
245 <b>eventFilter</b>(<i>source, event</i>) |
243 <b>eventFilter</b>(<i>source, event</i>) |
246 |
|
247 <p> |
244 <p> |
248 Public method to handle event for another object. |
245 Public method to handle event for another object. |
249 </p> |
246 </p> |
|
247 |
250 <dl> |
248 <dl> |
251 |
249 |
252 <dt><i>source</i> (QObject)</dt> |
250 <dt><i>source</i> (QObject)</dt> |
253 <dd> |
251 <dd> |
254 object to handle events for |
252 object to handle events for |
271 </dd> |
269 </dd> |
272 </dl> |
270 </dl> |
273 <a NAME="QuickFindFileDialog.on_buttonBox_clicked" ID="QuickFindFileDialog.on_buttonBox_clicked"></a> |
271 <a NAME="QuickFindFileDialog.on_buttonBox_clicked" ID="QuickFindFileDialog.on_buttonBox_clicked"></a> |
274 <h4>QuickFindFileDialog.on_buttonBox_clicked</h4> |
272 <h4>QuickFindFileDialog.on_buttonBox_clicked</h4> |
275 <b>on_buttonBox_clicked</b>(<i>button</i>) |
273 <b>on_buttonBox_clicked</b>(<i>button</i>) |
276 |
|
277 <p> |
274 <p> |
278 Private slot called by a button of the button box clicked. |
275 Private slot called by a button of the button box clicked. |
279 </p> |
276 </p> |
|
277 |
280 <dl> |
278 <dl> |
281 |
279 |
282 <dt><i>button</i> (QAbstractButton)</dt> |
280 <dt><i>button</i> (QAbstractButton)</dt> |
283 <dd> |
281 <dd> |
284 button that was clicked |
282 button that was clicked |
285 </dd> |
283 </dd> |
286 </dl> |
284 </dl> |
287 <a NAME="QuickFindFileDialog.on_fileList_currentItemChanged" ID="QuickFindFileDialog.on_fileList_currentItemChanged"></a> |
285 <a NAME="QuickFindFileDialog.on_fileList_currentItemChanged" ID="QuickFindFileDialog.on_fileList_currentItemChanged"></a> |
288 <h4>QuickFindFileDialog.on_fileList_currentItemChanged</h4> |
286 <h4>QuickFindFileDialog.on_fileList_currentItemChanged</h4> |
289 <b>on_fileList_currentItemChanged</b>(<i>current, previous</i>) |
287 <b>on_fileList_currentItemChanged</b>(<i>current, previous</i>) |
290 |
|
291 <p> |
288 <p> |
292 Private slot handling a change of the current item. |
289 Private slot handling a change of the current item. |
293 </p> |
290 </p> |
|
291 |
294 <dl> |
292 <dl> |
295 |
293 |
296 <dt><i>current</i> (QTreeWidgetItem)</dt> |
294 <dt><i>current</i> (QTreeWidgetItem)</dt> |
297 <dd> |
295 <dd> |
298 current item |
296 current item |
303 </dd> |
301 </dd> |
304 </dl> |
302 </dl> |
305 <a NAME="QuickFindFileDialog.on_fileList_itemActivated" ID="QuickFindFileDialog.on_fileList_itemActivated"></a> |
303 <a NAME="QuickFindFileDialog.on_fileList_itemActivated" ID="QuickFindFileDialog.on_fileList_itemActivated"></a> |
306 <h4>QuickFindFileDialog.on_fileList_itemActivated</h4> |
304 <h4>QuickFindFileDialog.on_fileList_itemActivated</h4> |
307 <b>on_fileList_itemActivated</b>(<i>itm, column</i>) |
305 <b>on_fileList_itemActivated</b>(<i>itm, column</i>) |
308 |
|
309 <p> |
306 <p> |
310 Private slot to handle the double click on a file item. |
307 Private slot to handle the double click on a file item. |
311 </p> |
308 </p> |
312 <p> |
309 <p> |
313 It emits the signal sourceFile or designerFile depending on the |
310 It emits the signal sourceFile or designerFile depending on the |
314 file extension. |
311 file extension. |
315 </p> |
312 </p> |
|
313 |
316 <dl> |
314 <dl> |
317 |
315 |
318 <dt><i>itm</i> (QTreeWidgetItem)</dt> |
316 <dt><i>itm</i> (QTreeWidgetItem)</dt> |
319 <dd> |
317 <dd> |
320 the double clicked listview item |
318 the double clicked listview item |
325 </dd> |
323 </dd> |
326 </dl> |
324 </dl> |
327 <a NAME="QuickFindFileDialog.on_fileNameEdit_returnPressed" ID="QuickFindFileDialog.on_fileNameEdit_returnPressed"></a> |
325 <a NAME="QuickFindFileDialog.on_fileNameEdit_returnPressed" ID="QuickFindFileDialog.on_fileNameEdit_returnPressed"></a> |
328 <h4>QuickFindFileDialog.on_fileNameEdit_returnPressed</h4> |
326 <h4>QuickFindFileDialog.on_fileNameEdit_returnPressed</h4> |
329 <b>on_fileNameEdit_returnPressed</b>(<i></i>) |
327 <b>on_fileNameEdit_returnPressed</b>(<i></i>) |
330 |
|
331 <p> |
328 <p> |
332 Private slot to handle enter being pressed on the file name edit box. |
329 Private slot to handle enter being pressed on the file name edit box. |
333 </p> |
330 </p> |
|
331 |
334 <a NAME="QuickFindFileDialog.on_fileNameEdit_textChanged" ID="QuickFindFileDialog.on_fileNameEdit_textChanged"></a> |
332 <a NAME="QuickFindFileDialog.on_fileNameEdit_textChanged" ID="QuickFindFileDialog.on_fileNameEdit_textChanged"></a> |
335 <h4>QuickFindFileDialog.on_fileNameEdit_textChanged</h4> |
333 <h4>QuickFindFileDialog.on_fileNameEdit_textChanged</h4> |
336 <b>on_fileNameEdit_textChanged</b>(<i>text</i>) |
334 <b>on_fileNameEdit_textChanged</b>(<i>text</i>) |
337 |
|
338 <p> |
335 <p> |
339 Private slot to handle the textChanged signal of the file name edit. |
336 Private slot to handle the textChanged signal of the file name edit. |
340 </p> |
337 </p> |
|
338 |
341 <dl> |
339 <dl> |
342 |
340 |
343 <dt><i>text</i> (str)</dt> |
341 <dt><i>text</i> (str)</dt> |
344 <dd> |
342 <dd> |
345 (ignored) |
343 (ignored) |
346 </dd> |
344 </dd> |
347 </dl> |
345 </dl> |
348 <a NAME="QuickFindFileDialog.show" ID="QuickFindFileDialog.show"></a> |
346 <a NAME="QuickFindFileDialog.show" ID="QuickFindFileDialog.show"></a> |
349 <h4>QuickFindFileDialog.show</h4> |
347 <h4>QuickFindFileDialog.show</h4> |
350 <b>show</b>(<i></i>) |
348 <b>show</b>(<i></i>) |
351 |
|
352 <p> |
349 <p> |
353 Public method to enable/disable the project checkbox. |
350 Public method to enable/disable the project checkbox. |
354 </p> |
351 </p> |
|
352 |
355 <div align="right"><a href="#top">Up</a></div> |
353 <div align="right"><a href="#top">Up</a></div> |
356 <hr /> |
354 <hr /> |
357 </body></html> |
355 </body></html> |