--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/eric7/Documentation/Source/eric7.Preferences.ConfigurationPages.EditorAPIsPage.html Mon May 24 11:19:57 2021 +0200 @@ -0,0 +1,408 @@ +<!DOCTYPE html> +<html><head> +<title>eric7.Preferences.ConfigurationPages.EditorAPIsPage</title> +<meta charset="UTF-8"> +<style> +body { + background: #EDECE6; + margin: 0em 1em 10em 1em; + color: black; +} + +h1 { color: white; background: #85774A; } +h2 { color: white; background: #85774A; } +h3 { color: white; background: #9D936E; } +h4 { color: white; background: #9D936E; } + +a { color: #BA6D36; } + +</style> +</head> +<body> +<a NAME="top" ID="top"></a> +<h1>eric7.Preferences.ConfigurationPages.EditorAPIsPage</h1> + +<p> +Module implementing the Editor APIs configuration page. +</p> +<h3>Global Attributes</h3> + +<table> +<tr><td>None</td></tr> +</table> +<h3>Classes</h3> + +<table> + +<tr> +<td><a href="#EditorAPIsPage">EditorAPIsPage</a></td> +<td>Class implementing the Editor APIs configuration page.</td> +</tr> +</table> +<h3>Functions</h3> + +<table> + +<tr> +<td><a href="#create">create</a></td> +<td>Module function to create the configuration page.</td> +</tr> +</table> +<hr /> +<hr /> +<a NAME="EditorAPIsPage" ID="EditorAPIsPage"></a> +<h2>EditorAPIsPage</h2> + +<p> + Class implementing the Editor APIs configuration page. +</p> +<h3>Derived from</h3> +ConfigurationPageBase, Ui_EditorAPIsPage +<h3>Class Attributes</h3> + +<table> +<tr><td>None</td></tr> +</table> +<h3>Class Methods</h3> + +<table> +<tr><td>None</td></tr> +</table> +<h3>Methods</h3> + +<table> + +<tr> +<td><a href="#EditorAPIsPage.__init__">EditorAPIsPage</a></td> +<td>Constructor</td> +</tr> +<tr> +<td><a href="#EditorAPIsPage.__apiKey">__apiKey</a></td> +<td>Private method to generate a key for the apis dictionary.</td> +</tr> +<tr> +<td><a href="#EditorAPIsPage.__apiPreparationCancelled">__apiPreparationCancelled</a></td> +<td>Private slot called after the API preparation has been cancelled.</td> +</tr> +<tr> +<td><a href="#EditorAPIsPage.__apiPreparationFinished">__apiPreparationFinished</a></td> +<td>Private method called after the API preparation has finished.</td> +</tr> +<tr> +<td><a href="#EditorAPIsPage.__apiPreparationStarted">__apiPreparationStarted</a></td> +<td>Private method called after the API preparation has started.</td> +</tr> +<tr> +<td><a href="#EditorAPIsPage.__editorGetApisFromApiList">__editorGetApisFromApiList</a></td> +<td>Private slot to retrieve the api filenames from the list.</td> +</tr> +<tr> +<td><a href="#EditorAPIsPage.__fillApisList">__fillApisList</a></td> +<td>Private slot to fill the list of API files.</td> +</tr> +<tr> +<td><a href="#EditorAPIsPage.__fillProjectTypeComboBox">__fillProjectTypeComboBox</a></td> +<td>Private slot to fill the selection of available project types for the given language.</td> +</tr> +<tr> +<td><a href="#EditorAPIsPage.on_addApiFileButton_clicked">on_addApiFileButton_clicked</a></td> +<td>Private slot to add the api file displayed to the listbox.</td> +</tr> +<tr> +<td><a href="#EditorAPIsPage.on_addInstalledApiFileButton_clicked">on_addInstalledApiFileButton_clicked</a></td> +<td>Private slot to add an API file from the list of installed API files for the selected lexer language.</td> +</tr> +<tr> +<td><a href="#EditorAPIsPage.on_addPluginApiFileButton_clicked">on_addPluginApiFileButton_clicked</a></td> +<td>Private slot to add an API file from the list of API files installed by plugins for the selected lexer language.</td> +</tr> +<tr> +<td><a href="#EditorAPIsPage.on_apiFilePicker_textChanged">on_apiFilePicker_textChanged</a></td> +<td>Private slot to handle the entering of an API file name.</td> +</tr> +<tr> +<td><a href="#EditorAPIsPage.on_apiLanguageComboBox_activated">on_apiLanguageComboBox_activated</a></td> +<td>Private slot to fill the api listbox of the api page.</td> +</tr> +<tr> +<td><a href="#EditorAPIsPage.on_apiList_itemSelectionChanged">on_apiList_itemSelectionChanged</a></td> +<td>Private slot to react on changes of API selections.</td> +</tr> +<tr> +<td><a href="#EditorAPIsPage.on_deleteApiFileButton_clicked">on_deleteApiFileButton_clicked</a></td> +<td>Private slot to delete the currently selected file of the listbox.</td> +</tr> +<tr> +<td><a href="#EditorAPIsPage.on_prepareApiButton_clicked">on_prepareApiButton_clicked</a></td> +<td>Private slot to prepare the API file for the currently selected language.</td> +</tr> +<tr> +<td><a href="#EditorAPIsPage.on_projectTypeComboBox_activated">on_projectTypeComboBox_activated</a></td> +<td>Private slot to handle the selection of a project type.</td> +</tr> +<tr> +<td><a href="#EditorAPIsPage.save">save</a></td> +<td>Public slot to save the Editor APIs configuration.</td> +</tr> +<tr> +<td><a href="#EditorAPIsPage.saveState">saveState</a></td> +<td>Public method to save the current state of the widget.</td> +</tr> +<tr> +<td><a href="#EditorAPIsPage.setState">setState</a></td> +<td>Public method to set the state of the widget.</td> +</tr> +</table> +<h3>Static Methods</h3> + +<table> +<tr><td>None</td></tr> +</table> + +<a NAME="EditorAPIsPage.__init__" ID="EditorAPIsPage.__init__"></a> +<h4>EditorAPIsPage (Constructor)</h4> +<b>EditorAPIsPage</b>(<i></i>) + +<p> + Constructor +</p> +<a NAME="EditorAPIsPage.__apiKey" ID="EditorAPIsPage.__apiKey"></a> +<h4>EditorAPIsPage.__apiKey</h4> +<b>__apiKey</b>(<i>language, projectType</i>) + +<p> + Private method to generate a key for the apis dictionary. +</p> +<dl> + +<dt><i>language</i> (str)</dt> +<dd> +programming language of the API +</dd> +<dt><i>projectType</i> (str)</dt> +<dd> +project type of the API +</dd> +</dl> +<dl> +<dt>Return:</dt> +<dd> +key to be used +</dd> +</dl> +<dl> +<dt>Return Type:</dt> +<dd> +str +</dd> +</dl> +<a NAME="EditorAPIsPage.__apiPreparationCancelled" ID="EditorAPIsPage.__apiPreparationCancelled"></a> +<h4>EditorAPIsPage.__apiPreparationCancelled</h4> +<b>__apiPreparationCancelled</b>(<i></i>) + +<p> + Private slot called after the API preparation has been cancelled. +</p> +<a NAME="EditorAPIsPage.__apiPreparationFinished" ID="EditorAPIsPage.__apiPreparationFinished"></a> +<h4>EditorAPIsPage.__apiPreparationFinished</h4> +<b>__apiPreparationFinished</b>(<i></i>) + +<p> + Private method called after the API preparation has finished. +</p> +<a NAME="EditorAPIsPage.__apiPreparationStarted" ID="EditorAPIsPage.__apiPreparationStarted"></a> +<h4>EditorAPIsPage.__apiPreparationStarted</h4> +<b>__apiPreparationStarted</b>(<i></i>) + +<p> + Private method called after the API preparation has started. +</p> +<a NAME="EditorAPIsPage.__editorGetApisFromApiList" ID="EditorAPIsPage.__editorGetApisFromApiList"></a> +<h4>EditorAPIsPage.__editorGetApisFromApiList</h4> +<b>__editorGetApisFromApiList</b>(<i></i>) + +<p> + Private slot to retrieve the api filenames from the list. +</p> +<dl> +<dt>Return:</dt> +<dd> +list of api filenames (list of strings) +</dd> +</dl> +<a NAME="EditorAPIsPage.__fillApisList" ID="EditorAPIsPage.__fillApisList"></a> +<h4>EditorAPIsPage.__fillApisList</h4> +<b>__fillApisList</b>(<i></i>) + +<p> + Private slot to fill the list of API files. +</p> +<a NAME="EditorAPIsPage.__fillProjectTypeComboBox" ID="EditorAPIsPage.__fillProjectTypeComboBox"></a> +<h4>EditorAPIsPage.__fillProjectTypeComboBox</h4> +<b>__fillProjectTypeComboBox</b>(<i>language</i>) + +<p> + Private slot to fill the selection of available project types for the + given language. +</p> +<dl> + +<dt><i>language</i> (str)</dt> +<dd> +selected API language +</dd> +</dl> +<a NAME="EditorAPIsPage.on_addApiFileButton_clicked" ID="EditorAPIsPage.on_addApiFileButton_clicked"></a> +<h4>EditorAPIsPage.on_addApiFileButton_clicked</h4> +<b>on_addApiFileButton_clicked</b>(<i></i>) + +<p> + Private slot to add the api file displayed to the listbox. +</p> +<a NAME="EditorAPIsPage.on_addInstalledApiFileButton_clicked" ID="EditorAPIsPage.on_addInstalledApiFileButton_clicked"></a> +<h4>EditorAPIsPage.on_addInstalledApiFileButton_clicked</h4> +<b>on_addInstalledApiFileButton_clicked</b>(<i></i>) + +<p> + Private slot to add an API file from the list of installed API files + for the selected lexer language. +</p> +<a NAME="EditorAPIsPage.on_addPluginApiFileButton_clicked" ID="EditorAPIsPage.on_addPluginApiFileButton_clicked"></a> +<h4>EditorAPIsPage.on_addPluginApiFileButton_clicked</h4> +<b>on_addPluginApiFileButton_clicked</b>(<i></i>) + +<p> + Private slot to add an API file from the list of API files installed + by plugins for the selected lexer language. +</p> +<a NAME="EditorAPIsPage.on_apiFilePicker_textChanged" ID="EditorAPIsPage.on_apiFilePicker_textChanged"></a> +<h4>EditorAPIsPage.on_apiFilePicker_textChanged</h4> +<b>on_apiFilePicker_textChanged</b>(<i>txt</i>) + +<p> + Private slot to handle the entering of an API file name. +</p> +<dl> + +<dt><i>txt</i></dt> +<dd> +text of the line edit (string) +</dd> +</dl> +<a NAME="EditorAPIsPage.on_apiLanguageComboBox_activated" ID="EditorAPIsPage.on_apiLanguageComboBox_activated"></a> +<h4>EditorAPIsPage.on_apiLanguageComboBox_activated</h4> +<b>on_apiLanguageComboBox_activated</b>(<i>index</i>) + +<p> + Private slot to fill the api listbox of the api page. +</p> +<dl> + +<dt><i>index</i> (int)</dt> +<dd> +index of the selected entry +</dd> +</dl> +<a NAME="EditorAPIsPage.on_apiList_itemSelectionChanged" ID="EditorAPIsPage.on_apiList_itemSelectionChanged"></a> +<h4>EditorAPIsPage.on_apiList_itemSelectionChanged</h4> +<b>on_apiList_itemSelectionChanged</b>(<i></i>) + +<p> + Private slot to react on changes of API selections. +</p> +<a NAME="EditorAPIsPage.on_deleteApiFileButton_clicked" ID="EditorAPIsPage.on_deleteApiFileButton_clicked"></a> +<h4>EditorAPIsPage.on_deleteApiFileButton_clicked</h4> +<b>on_deleteApiFileButton_clicked</b>(<i></i>) + +<p> + Private slot to delete the currently selected file of the listbox. +</p> +<a NAME="EditorAPIsPage.on_prepareApiButton_clicked" ID="EditorAPIsPage.on_prepareApiButton_clicked"></a> +<h4>EditorAPIsPage.on_prepareApiButton_clicked</h4> +<b>on_prepareApiButton_clicked</b>(<i></i>) + +<p> + Private slot to prepare the API file for the currently selected + language. +</p> +<a NAME="EditorAPIsPage.on_projectTypeComboBox_activated" ID="EditorAPIsPage.on_projectTypeComboBox_activated"></a> +<h4>EditorAPIsPage.on_projectTypeComboBox_activated</h4> +<b>on_projectTypeComboBox_activated</b>(<i>index</i>) + +<p> + Private slot to handle the selection of a project type. +</p> +<dl> + +<dt><i>index</i> (str)</dt> +<dd> +index of the selected entry +</dd> +</dl> +<a NAME="EditorAPIsPage.save" ID="EditorAPIsPage.save"></a> +<h4>EditorAPIsPage.save</h4> +<b>save</b>(<i></i>) + +<p> + Public slot to save the Editor APIs configuration. +</p> +<a NAME="EditorAPIsPage.saveState" ID="EditorAPIsPage.saveState"></a> +<h4>EditorAPIsPage.saveState</h4> +<b>saveState</b>(<i></i>) + +<p> + Public method to save the current state of the widget. +</p> +<dl> +<dt>Return:</dt> +<dd> +tuple containing the index of the selected lexer language + and the index of the selected project type +</dd> +</dl> +<dl> +<dt>Return Type:</dt> +<dd> +tuple of int and int +</dd> +</dl> +<a NAME="EditorAPIsPage.setState" ID="EditorAPIsPage.setState"></a> +<h4>EditorAPIsPage.setState</h4> +<b>setState</b>(<i>state</i>) + +<p> + Public method to set the state of the widget. +</p> +<dl> + +<dt><i>state</i></dt> +<dd> +state data generated by saveState +</dd> +</dl> +<div align="right"><a href="#top">Up</a></div> +<hr /> +<hr /> +<a NAME="create" ID="create"></a> +<h2>create</h2> +<b>create</b>(<i>dlg</i>) + +<p> + Module function to create the configuration page. +</p> +<dl> + +<dt><i>dlg</i></dt> +<dd> +reference to the configuration dialog +</dd> +</dl> +<dl> +<dt>Return:</dt> +<dd> +reference to the instantiated page (ConfigurationPageBase) +</dd> +</dl> +<div align="right"><a href="#top">Up</a></div> +<hr /> +</body></html> \ No newline at end of file