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.WebBrowser.OpenSearch.OpenSearchManager</h1> |
9 <h1>eric7.WebBrowser.OpenSearch.OpenSearchManager</h1> |
10 |
|
11 <p> |
10 <p> |
12 Module implementing a manager for open search engines. |
11 Module implementing a manager for open search engines. |
13 </p> |
12 </p> |
|
13 |
14 <h3>Global Attributes</h3> |
14 <h3>Global Attributes</h3> |
15 |
|
16 <table> |
15 <table> |
17 <tr><td>None</td></tr> |
16 <tr><td>None</td></tr> |
18 </table> |
17 </table> |
|
18 |
19 <h3>Classes</h3> |
19 <h3>Classes</h3> |
20 |
|
21 <table> |
20 <table> |
22 |
|
23 <tr> |
21 <tr> |
24 <td><a href="#OpenSearchManager">OpenSearchManager</a></td> |
22 <td><a href="#OpenSearchManager">OpenSearchManager</a></td> |
25 <td>Class implementing a manager for open search engines.</td> |
23 <td>Class implementing a manager for open search engines.</td> |
26 </tr> |
24 </tr> |
27 </table> |
25 </table> |
|
26 |
28 <h3>Functions</h3> |
27 <h3>Functions</h3> |
29 |
|
30 <table> |
28 <table> |
31 <tr><td>None</td></tr> |
29 <tr><td>None</td></tr> |
32 </table> |
30 </table> |
|
31 |
33 <hr /> |
32 <hr /> |
34 <hr /> |
33 <hr /> |
35 <a NAME="OpenSearchManager" ID="OpenSearchManager"></a> |
34 <a NAME="OpenSearchManager" ID="OpenSearchManager"></a> |
36 <h2>OpenSearchManager</h2> |
35 <h2>OpenSearchManager</h2> |
37 |
|
38 <p> |
36 <p> |
39 Class implementing a manager for open search engines. |
37 Class implementing a manager for open search engines. |
40 </p> |
38 </p> |
|
39 |
41 <h3>Signals</h3> |
40 <h3>Signals</h3> |
42 <dl> |
41 <dl> |
43 |
42 |
44 <dt>changed()</dt> |
43 <dt>changed()</dt> |
45 <dd> |
44 <dd> |
190 <tr> |
187 <tr> |
191 <td><a href="#OpenSearchManager.setKeywordsForEngine">setKeywordsForEngine</a></td> |
188 <td><a href="#OpenSearchManager.setKeywordsForEngine">setKeywordsForEngine</a></td> |
192 <td>Public method to set the keywords for an engine.</td> |
189 <td>Public method to set the keywords for an engine.</td> |
193 </tr> |
190 </tr> |
194 </table> |
191 </table> |
|
192 |
195 <h3>Static Methods</h3> |
193 <h3>Static Methods</h3> |
196 |
|
197 <table> |
194 <table> |
198 <tr><td>None</td></tr> |
195 <tr><td>None</td></tr> |
199 </table> |
196 </table> |
200 |
197 |
|
198 |
201 <a NAME="OpenSearchManager.__init__" ID="OpenSearchManager.__init__"></a> |
199 <a NAME="OpenSearchManager.__init__" ID="OpenSearchManager.__init__"></a> |
202 <h4>OpenSearchManager (Constructor)</h4> |
200 <h4>OpenSearchManager (Constructor)</h4> |
203 <b>OpenSearchManager</b>(<i>parent=None</i>) |
201 <b>OpenSearchManager</b>(<i>parent=None</i>) |
204 |
|
205 <p> |
202 <p> |
206 Constructor |
203 Constructor |
207 </p> |
204 </p> |
|
205 |
208 <dl> |
206 <dl> |
209 |
207 |
210 <dt><i>parent</i> (QObject)</dt> |
208 <dt><i>parent</i> (QObject)</dt> |
211 <dd> |
209 <dd> |
212 reference to the parent object |
210 reference to the parent object |
213 </dd> |
211 </dd> |
214 </dl> |
212 </dl> |
215 <a NAME="OpenSearchManager.__addEngineByEngine" ID="OpenSearchManager.__addEngineByEngine"></a> |
213 <a NAME="OpenSearchManager.__addEngineByEngine" ID="OpenSearchManager.__addEngineByEngine"></a> |
216 <h4>OpenSearchManager.__addEngineByEngine</h4> |
214 <h4>OpenSearchManager.__addEngineByEngine</h4> |
217 <b>__addEngineByEngine</b>(<i>engine</i>) |
215 <b>__addEngineByEngine</b>(<i>engine</i>) |
218 |
|
219 <p> |
216 <p> |
220 Private method to add a new search engine given a reference to an |
217 Private method to add a new search engine given a reference to an |
221 engine. |
218 engine. |
222 </p> |
219 </p> |
|
220 |
223 <dl> |
221 <dl> |
224 |
222 |
225 <dt><i>engine</i> (OpenSearchEngine)</dt> |
223 <dt><i>engine</i> (OpenSearchEngine)</dt> |
226 <dd> |
224 <dd> |
227 reference to an engine object |
225 reference to an engine object |
318 </dd> |
316 </dd> |
319 </dl> |
317 </dl> |
320 <a NAME="OpenSearchManager.__engineFromUrlAvailable" ID="OpenSearchManager.__engineFromUrlAvailable"></a> |
318 <a NAME="OpenSearchManager.__engineFromUrlAvailable" ID="OpenSearchManager.__engineFromUrlAvailable"></a> |
321 <h4>OpenSearchManager.__engineFromUrlAvailable</h4> |
319 <h4>OpenSearchManager.__engineFromUrlAvailable</h4> |
322 <b>__engineFromUrlAvailable</b>(<i>reply</i>) |
320 <b>__engineFromUrlAvailable</b>(<i>reply</i>) |
323 |
|
324 <p> |
321 <p> |
325 Private slot to add a search engine from the net. |
322 Private slot to add a search engine from the net. |
326 </p> |
323 </p> |
|
324 |
327 <dl> |
325 <dl> |
328 |
326 |
329 <dt><i>reply</i> (QNetworkReply)</dt> |
327 <dt><i>reply</i> (QNetworkReply)</dt> |
330 <dd> |
328 <dd> |
331 reference to the network reply |
329 reference to the network reply |
332 </dd> |
330 </dd> |
333 </dl> |
331 </dl> |
334 <a NAME="OpenSearchManager.addEngine" ID="OpenSearchManager.addEngine"></a> |
332 <a NAME="OpenSearchManager.addEngine" ID="OpenSearchManager.addEngine"></a> |
335 <h4>OpenSearchManager.addEngine</h4> |
333 <h4>OpenSearchManager.addEngine</h4> |
336 <b>addEngine</b>(<i>engine</i>) |
334 <b>addEngine</b>(<i>engine</i>) |
337 |
|
338 <p> |
335 <p> |
339 Public method to add a new search engine. |
336 Public method to add a new search engine. |
340 </p> |
337 </p> |
|
338 |
341 <dl> |
339 <dl> |
342 |
340 |
343 <dt><i>engine</i> (str)</dt> |
341 <dt><i>engine</i> (str)</dt> |
344 <dd> |
342 <dd> |
345 URL of the engine definition file (QUrl) or |
343 URL of the engine definition file (QUrl) or |
398 </dd> |
396 </dd> |
399 </dl> |
397 </dl> |
400 <a NAME="OpenSearchManager.close" ID="OpenSearchManager.close"></a> |
398 <a NAME="OpenSearchManager.close" ID="OpenSearchManager.close"></a> |
401 <h4>OpenSearchManager.close</h4> |
399 <h4>OpenSearchManager.close</h4> |
402 <b>close</b>(<i></i>) |
400 <b>close</b>(<i></i>) |
403 |
|
404 <p> |
401 <p> |
405 Public method to close the open search engines manager. |
402 Public method to close the open search engines manager. |
406 </p> |
403 </p> |
|
404 |
407 <a NAME="OpenSearchManager.convertKeywordSearchToUrl" ID="OpenSearchManager.convertKeywordSearchToUrl"></a> |
405 <a NAME="OpenSearchManager.convertKeywordSearchToUrl" ID="OpenSearchManager.convertKeywordSearchToUrl"></a> |
408 <h4>OpenSearchManager.convertKeywordSearchToUrl</h4> |
406 <h4>OpenSearchManager.convertKeywordSearchToUrl</h4> |
409 <b>convertKeywordSearchToUrl</b>(<i>keywordSearch</i>) |
407 <b>convertKeywordSearchToUrl</b>(<i>keywordSearch</i>) |
410 |
|
411 <p> |
408 <p> |
412 Public method to get the search URL for a keyword search. |
409 Public method to get the search URL for a keyword search. |
413 </p> |
410 </p> |
|
411 |
414 <dl> |
412 <dl> |
415 |
413 |
416 <dt><i>keywordSearch</i> (str)</dt> |
414 <dt><i>keywordSearch</i> (str)</dt> |
417 <dd> |
415 <dd> |
418 search string for keyword search |
416 search string for keyword search |
547 </dd> |
545 </dd> |
548 </dl> |
546 </dl> |
549 <a NAME="OpenSearchManager.enginesChanged" ID="OpenSearchManager.enginesChanged"></a> |
547 <a NAME="OpenSearchManager.enginesChanged" ID="OpenSearchManager.enginesChanged"></a> |
550 <h4>OpenSearchManager.enginesChanged</h4> |
548 <h4>OpenSearchManager.enginesChanged</h4> |
551 <b>enginesChanged</b>(<i></i>) |
549 <b>enginesChanged</b>(<i></i>) |
552 |
|
553 <p> |
550 <p> |
554 Public slot to tell the search engine manager, that something has |
551 Public slot to tell the search engine manager, that something has |
555 changed. |
552 changed. |
556 </p> |
553 </p> |
|
554 |
557 <a NAME="OpenSearchManager.enginesCount" ID="OpenSearchManager.enginesCount"></a> |
555 <a NAME="OpenSearchManager.enginesCount" ID="OpenSearchManager.enginesCount"></a> |
558 <h4>OpenSearchManager.enginesCount</h4> |
556 <h4>OpenSearchManager.enginesCount</h4> |
559 <b>enginesCount</b>(<i></i>) |
557 <b>enginesCount</b>(<i></i>) |
560 |
|
561 <p> |
558 <p> |
562 Public method to get the number of available engines. |
559 Public method to get the number of available engines. |
563 </p> |
560 </p> |
|
561 |
564 <dl> |
562 <dl> |
565 <dt>Return:</dt> |
563 <dt>Return:</dt> |
566 <dd> |
564 <dd> |
567 number of engines |
565 number of engines |
568 </dd> |
566 </dd> |
646 </dd> |
644 </dd> |
647 </dl> |
645 </dl> |
648 <a NAME="OpenSearchManager.load" ID="OpenSearchManager.load"></a> |
646 <a NAME="OpenSearchManager.load" ID="OpenSearchManager.load"></a> |
649 <h4>OpenSearchManager.load</h4> |
647 <h4>OpenSearchManager.load</h4> |
650 <b>load</b>(<i></i>) |
648 <b>load</b>(<i></i>) |
651 |
|
652 <p> |
649 <p> |
653 Public method to load the search engines configuration. |
650 Public method to load the search engines configuration. |
654 </p> |
651 </p> |
|
652 |
655 <a NAME="OpenSearchManager.loadDirectory" ID="OpenSearchManager.loadDirectory"></a> |
653 <a NAME="OpenSearchManager.loadDirectory" ID="OpenSearchManager.loadDirectory"></a> |
656 <h4>OpenSearchManager.loadDirectory</h4> |
654 <h4>OpenSearchManager.loadDirectory</h4> |
657 <b>loadDirectory</b>(<i>dirName</i>) |
655 <b>loadDirectory</b>(<i>dirName</i>) |
658 |
|
659 <p> |
656 <p> |
660 Public method to load the search engine definitions from files. |
657 Public method to load the search engine definitions from files. |
661 </p> |
658 </p> |
|
659 |
662 <dl> |
660 <dl> |
663 |
661 |
664 <dt><i>dirName</i> (str)</dt> |
662 <dt><i>dirName</i> (str)</dt> |
665 <dd> |
663 <dd> |
666 name of the directory to load the files from |
664 name of the directory to load the files from |
679 </dd> |
677 </dd> |
680 </dl> |
678 </dl> |
681 <a NAME="OpenSearchManager.removeEngine" ID="OpenSearchManager.removeEngine"></a> |
679 <a NAME="OpenSearchManager.removeEngine" ID="OpenSearchManager.removeEngine"></a> |
682 <h4>OpenSearchManager.removeEngine</h4> |
680 <h4>OpenSearchManager.removeEngine</h4> |
683 <b>removeEngine</b>(<i>name</i>) |
681 <b>removeEngine</b>(<i>name</i>) |
684 |
|
685 <p> |
682 <p> |
686 Public method to remove an engine. |
683 Public method to remove an engine. |
687 </p> |
684 </p> |
|
685 |
688 <dl> |
686 <dl> |
689 |
687 |
690 <dt><i>name</i> (str)</dt> |
688 <dt><i>name</i> (str)</dt> |
691 <dd> |
689 <dd> |
692 name of the engine |
690 name of the engine |
693 </dd> |
691 </dd> |
694 </dl> |
692 </dl> |
695 <a NAME="OpenSearchManager.restoreDefaults" ID="OpenSearchManager.restoreDefaults"></a> |
693 <a NAME="OpenSearchManager.restoreDefaults" ID="OpenSearchManager.restoreDefaults"></a> |
696 <h4>OpenSearchManager.restoreDefaults</h4> |
694 <h4>OpenSearchManager.restoreDefaults</h4> |
697 <b>restoreDefaults</b>(<i></i>) |
695 <b>restoreDefaults</b>(<i></i>) |
698 |
|
699 <p> |
696 <p> |
700 Public method to restore the default search engines. |
697 Public method to restore the default search engines. |
701 </p> |
698 </p> |
|
699 |
702 <a NAME="OpenSearchManager.save" ID="OpenSearchManager.save"></a> |
700 <a NAME="OpenSearchManager.save" ID="OpenSearchManager.save"></a> |
703 <h4>OpenSearchManager.save</h4> |
701 <h4>OpenSearchManager.save</h4> |
704 <b>save</b>(<i></i>) |
702 <b>save</b>(<i></i>) |
705 |
|
706 <p> |
703 <p> |
707 Public method to save the search engines configuration. |
704 Public method to save the search engines configuration. |
708 </p> |
705 </p> |
|
706 |
709 <a NAME="OpenSearchManager.saveDirectory" ID="OpenSearchManager.saveDirectory"></a> |
707 <a NAME="OpenSearchManager.saveDirectory" ID="OpenSearchManager.saveDirectory"></a> |
710 <h4>OpenSearchManager.saveDirectory</h4> |
708 <h4>OpenSearchManager.saveDirectory</h4> |
711 <b>saveDirectory</b>(<i>dirName</i>) |
709 <b>saveDirectory</b>(<i>dirName</i>) |
712 |
|
713 <p> |
710 <p> |
714 Public method to save the search engine definitions to files. |
711 Public method to save the search engine definitions to files. |
715 </p> |
712 </p> |
|
713 |
716 <dl> |
714 <dl> |
717 |
715 |
718 <dt><i>dirName</i> (str)</dt> |
716 <dt><i>dirName</i> (str)</dt> |
719 <dd> |
717 <dd> |
720 name of the directory to write the files to |
718 name of the directory to write the files to |
721 </dd> |
719 </dd> |
722 </dl> |
720 </dl> |
723 <a NAME="OpenSearchManager.setCurrentEngine" ID="OpenSearchManager.setCurrentEngine"></a> |
721 <a NAME="OpenSearchManager.setCurrentEngine" ID="OpenSearchManager.setCurrentEngine"></a> |
724 <h4>OpenSearchManager.setCurrentEngine</h4> |
722 <h4>OpenSearchManager.setCurrentEngine</h4> |
725 <b>setCurrentEngine</b>(<i>engine</i>) |
723 <b>setCurrentEngine</b>(<i>engine</i>) |
726 |
|
727 <p> |
724 <p> |
728 Public method to set the current engine. |
725 Public method to set the current engine. |
729 </p> |
726 </p> |
|
727 |
730 <dl> |
728 <dl> |
731 |
729 |
732 <dt><i>engine</i> (OpenSearchEngine)</dt> |
730 <dt><i>engine</i> (OpenSearchEngine)</dt> |
733 <dd> |
731 <dd> |
734 reference to the new current engine |
732 reference to the new current engine |
735 </dd> |
733 </dd> |
736 </dl> |
734 </dl> |
737 <a NAME="OpenSearchManager.setCurrentEngineName" ID="OpenSearchManager.setCurrentEngineName"></a> |
735 <a NAME="OpenSearchManager.setCurrentEngineName" ID="OpenSearchManager.setCurrentEngineName"></a> |
738 <h4>OpenSearchManager.setCurrentEngineName</h4> |
736 <h4>OpenSearchManager.setCurrentEngineName</h4> |
739 <b>setCurrentEngineName</b>(<i>name</i>) |
737 <b>setCurrentEngineName</b>(<i>name</i>) |
740 |
|
741 <p> |
738 <p> |
742 Public method to set the current engine by name. |
739 Public method to set the current engine by name. |
743 </p> |
740 </p> |
|
741 |
744 <dl> |
742 <dl> |
745 |
743 |
746 <dt><i>name</i> (str)</dt> |
744 <dt><i>name</i> (str)</dt> |
747 <dd> |
745 <dd> |
748 name of the new current engine |
746 name of the new current engine |
749 </dd> |
747 </dd> |
750 </dl> |
748 </dl> |
751 <a NAME="OpenSearchManager.setEngineForKeyword" ID="OpenSearchManager.setEngineForKeyword"></a> |
749 <a NAME="OpenSearchManager.setEngineForKeyword" ID="OpenSearchManager.setEngineForKeyword"></a> |
752 <h4>OpenSearchManager.setEngineForKeyword</h4> |
750 <h4>OpenSearchManager.setEngineForKeyword</h4> |
753 <b>setEngineForKeyword</b>(<i>keyword, engine</i>) |
751 <b>setEngineForKeyword</b>(<i>keyword, engine</i>) |
754 |
|
755 <p> |
752 <p> |
756 Public method to set the engine for a keyword. |
753 Public method to set the engine for a keyword. |
757 </p> |
754 </p> |
|
755 |
758 <dl> |
756 <dl> |
759 |
757 |
760 <dt><i>keyword</i> (str)</dt> |
758 <dt><i>keyword</i> (str)</dt> |
761 <dd> |
759 <dd> |
762 keyword to get engine for |
760 keyword to get engine for |