diff -r 1779dc278077 -r 391d6b7b1eff eric6/Documentation/Source/eric6.Plugins.UiExtensionPlugins.Translator.TranslatorWidget.html
--- a/eric6/Documentation/Source/eric6.Plugins.UiExtensionPlugins.Translator.TranslatorWidget.html Wed Sep 25 19:40:31 2019 +0200
+++ b/eric6/Documentation/Source/eric6.Plugins.UiExtensionPlugins.Translator.TranslatorWidget.html Wed Sep 25 19:42:44 2019 +0200
@@ -18,307 +18,413 @@
</style>
</head>
-<body><a NAME="top" ID="top"></a>
+<body>
+<a NAME="top" ID="top"></a>
<h1>eric6.Plugins.UiExtensionPlugins.Translator.TranslatorWidget</h1>
+
<p>
Module implementing the translator widget.
</p>
<h3>Global Attributes</h3>
+
<table>
<tr><td>None</td></tr>
</table>
<h3>Classes</h3>
+
<table>
+
<tr>
<td><a href="#TranslatorWidget">TranslatorWidget</a></td>
<td>Class implementing the translator widget.</td>
</tr>
</table>
<h3>Functions</h3>
+
<table>
<tr><td>None</td></tr>
</table>
-<hr /><hr />
+<hr />
+<hr />
<a NAME="TranslatorWidget" ID="TranslatorWidget"></a>
<h2>TranslatorWidget</h2>
+
<p>
Class implementing the translator widget.
</p>
<h3>Derived from</h3>
QWidget, Ui_TranslatorWidget
<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="#TranslatorWidget.__init__">TranslatorWidget</a></td>
<td>Constructor</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.__availableTranslationsLoaded">__availableTranslationsLoaded</a></td>
<td>Private slot to handle the availability of translations.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.__engineComboBoxCurrentIndexChanged">__engineComboBoxCurrentIndexChanged</a></td>
<td>Private slot to handle the selection of a translation service.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.__ensureTranslationEngineReady">__ensureTranslationEngineReady</a></td>
<td>Private slot to ensure, that the currently selected translation engine is ready.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.__mediaPlayerStateChanged">__mediaPlayerStateChanged</a></td>
<td>Private slot handling changes of the media player state.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.__originalLanguage">__originalLanguage</a></td>
<td>Private method to return the code of the selected original language.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.__pronounce">__pronounce</a></td>
<td>Private method to pronounce the given text.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.__translate">__translate</a></td>
<td>Private method to translate the given text.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.__translationLanguage">__translationLanguage</a></td>
<td>Private method to return the code of the selected translation language.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.__updateClearButton">__updateClearButton</a></td>
<td>Private slot to set the state of the clear button.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.__updateEngines">__updateEngines</a></td>
<td>Private slot to update the engines combo box.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.__updateLanguages">__updateLanguages</a></td>
<td>Private slot to update the language combo boxes.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.__updatePronounceButtons">__updatePronounceButtons</a></td>
<td>Private slot to set the state of the pronounce buttons.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.__updateTranslateButton">__updateTranslateButton</a></td>
<td>Private slot to set the state of the translate button.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.on_clearButton_clicked">on_clearButton_clicked</a></td>
<td>Private slot to clear the text fields.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.on_origEdit_textChanged">on_origEdit_textChanged</a></td>
<td>Private slot to handle changes of the original text.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.on_origLanguageComboBox_currentIndexChanged">on_origLanguageComboBox_currentIndexChanged</a></td>
<td>Private slot to handle the selection of the original language.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.on_preferencesButton_clicked">on_preferencesButton_clicked</a></td>
<td>Private slot to open the Translator configuration page.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.on_pronounceOrigButton_clicked">on_pronounceOrigButton_clicked</a></td>
<td>Private slot to pronounce the original text.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.on_pronounceTransButton_clicked">on_pronounceTransButton_clicked</a></td>
<td>Private slot to pronounce the translated text.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.on_swapButton_clicked">on_swapButton_clicked</a></td>
<td>Private slot to swap the languages.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.on_transEdit_textChanged">on_transEdit_textChanged</a></td>
<td>Private slot to handle changes of the translation text.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.on_transLanguageComboBox_currentIndexChanged">on_transLanguageComboBox_currentIndexChanged</a></td>
<td>Private slot to handle the selection of the translation language.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TranslatorWidget.on_translateButton_clicked">on_translateButton_clicked</a></td>
<td>Private slot to translate the entered text.</td>
</tr>
</table>
<h3>Static Methods</h3>
+
<table>
<tr><td>None</td></tr>
</table>
+
<a NAME="TranslatorWidget.__init__" ID="TranslatorWidget.__init__"></a>
<h4>TranslatorWidget (Constructor)</h4>
<b>TranslatorWidget</b>(<i>plugin, translator, parent=None</i>)
+
<p>
Constructor
-</p><dl>
+</p>
+<dl>
+
<dt><i>plugin</i></dt>
<dd>
reference to the plugin object (TranslatorPlugin)
-</dd><dt><i>translator</i></dt>
+</dd>
+<dt><i>translator</i></dt>
<dd>
reference to the translator object (Translator)
-</dd><dt><i>parent</i></dt>
+</dd>
+<dt><i>parent</i></dt>
<dd>
reference to the parent widget (QWidget)
</dd>
-</dl><a NAME="TranslatorWidget.__availableTranslationsLoaded" ID="TranslatorWidget.__availableTranslationsLoaded"></a>
+</dl>
+<a NAME="TranslatorWidget.__availableTranslationsLoaded" ID="TranslatorWidget.__availableTranslationsLoaded"></a>
<h4>TranslatorWidget.__availableTranslationsLoaded</h4>
<b>__availableTranslationsLoaded</b>(<i></i>)
+
<p>
Private slot to handle the availability of translations.
-</p><a NAME="TranslatorWidget.__engineComboBoxCurrentIndexChanged" ID="TranslatorWidget.__engineComboBoxCurrentIndexChanged"></a>
+</p>
+<a NAME="TranslatorWidget.__engineComboBoxCurrentIndexChanged" ID="TranslatorWidget.__engineComboBoxCurrentIndexChanged"></a>
<h4>TranslatorWidget.__engineComboBoxCurrentIndexChanged</h4>
<b>__engineComboBoxCurrentIndexChanged</b>(<i>index</i>)
+
<p>
Private slot to handle the selection of a translation service.
-</p><dl>
+</p>
+<dl>
+
<dt><i>index</i> (int)</dt>
<dd>
current index
</dd>
-</dl><a NAME="TranslatorWidget.__ensureTranslationEngineReady" ID="TranslatorWidget.__ensureTranslationEngineReady"></a>
+</dl>
+<a NAME="TranslatorWidget.__ensureTranslationEngineReady" ID="TranslatorWidget.__ensureTranslationEngineReady"></a>
<h4>TranslatorWidget.__ensureTranslationEngineReady</h4>
<b>__ensureTranslationEngineReady</b>(<i></i>)
+
<p>
Private slot to ensure, that the currently selected translation engine
is ready.
-</p><a NAME="TranslatorWidget.__mediaPlayerStateChanged" ID="TranslatorWidget.__mediaPlayerStateChanged"></a>
+</p>
+<a NAME="TranslatorWidget.__mediaPlayerStateChanged" ID="TranslatorWidget.__mediaPlayerStateChanged"></a>
<h4>TranslatorWidget.__mediaPlayerStateChanged</h4>
<b>__mediaPlayerStateChanged</b>(<i>state</i>)
+
<p>
Private slot handling changes of the media player state.
-</p><dl>
+</p>
+<dl>
+
<dt><i>state</i></dt>
<dd>
media player state (QAudio.State)
</dd>
-</dl><a NAME="TranslatorWidget.__originalLanguage" ID="TranslatorWidget.__originalLanguage"></a>
+</dl>
+<a NAME="TranslatorWidget.__originalLanguage" ID="TranslatorWidget.__originalLanguage"></a>
<h4>TranslatorWidget.__originalLanguage</h4>
<b>__originalLanguage</b>(<i></i>)
+
<p>
Private method to return the code of the selected original language.
-</p><dl>
+</p>
+<dl>
<dt>Returns:</dt>
<dd>
code of the original language (string)
</dd>
-</dl><a NAME="TranslatorWidget.__pronounce" ID="TranslatorWidget.__pronounce"></a>
+</dl>
+<a NAME="TranslatorWidget.__pronounce" ID="TranslatorWidget.__pronounce"></a>
<h4>TranslatorWidget.__pronounce</h4>
<b>__pronounce</b>(<i>text, language</i>)
+
<p>
Private method to pronounce the given text.
-</p><dl>
+</p>
+<dl>
+
<dt><i>text</i></dt>
<dd>
text to be pronounced (string)
-</dd><dt><i>language</i></dt>
+</dd>
+<dt><i>language</i></dt>
<dd>
language code of the text (string)
</dd>
-</dl><a NAME="TranslatorWidget.__translate" ID="TranslatorWidget.__translate"></a>
+</dl>
+<a NAME="TranslatorWidget.__translate" ID="TranslatorWidget.__translate"></a>
<h4>TranslatorWidget.__translate</h4>
<b>__translate</b>(<i>text, originalLanguage, translationLanguage</i>)
+
<p>
Private method to translate the given text.
-</p><dl>
+</p>
+<dl>
+
<dt><i>text</i></dt>
<dd>
text to be translated (string)
-</dd><dt><i>originalLanguage</i></dt>
+</dd>
+<dt><i>originalLanguage</i></dt>
<dd>
language code of the original (string)
-</dd><dt><i>translationLanguage</i></dt>
+</dd>
+<dt><i>translationLanguage</i></dt>
<dd>
language code of the translation (string)
</dd>
-</dl><dl>
+</dl>
+<dl>
<dt>Returns:</dt>
<dd>
tuple of translated text (string) and flag indicating
success (boolean)
</dd>
-</dl><a NAME="TranslatorWidget.__translationLanguage" ID="TranslatorWidget.__translationLanguage"></a>
+</dl>
+<a NAME="TranslatorWidget.__translationLanguage" ID="TranslatorWidget.__translationLanguage"></a>
<h4>TranslatorWidget.__translationLanguage</h4>
<b>__translationLanguage</b>(<i></i>)
+
<p>
Private method to return the code of the selected translation language.
-</p><dl>
+</p>
+<dl>
<dt>Returns:</dt>
<dd>
code of the translation language (string)
</dd>
-</dl><a NAME="TranslatorWidget.__updateClearButton" ID="TranslatorWidget.__updateClearButton"></a>
+</dl>
+<a NAME="TranslatorWidget.__updateClearButton" ID="TranslatorWidget.__updateClearButton"></a>
<h4>TranslatorWidget.__updateClearButton</h4>
<b>__updateClearButton</b>(<i></i>)
+
<p>
Private slot to set the state of the clear button.
-</p><a NAME="TranslatorWidget.__updateEngines" ID="TranslatorWidget.__updateEngines"></a>
+</p>
+<a NAME="TranslatorWidget.__updateEngines" ID="TranslatorWidget.__updateEngines"></a>
<h4>TranslatorWidget.__updateEngines</h4>
<b>__updateEngines</b>(<i></i>)
+
<p>
Private slot to update the engines combo box.
-</p><a NAME="TranslatorWidget.__updateLanguages" ID="TranslatorWidget.__updateLanguages"></a>
+</p>
+<a NAME="TranslatorWidget.__updateLanguages" ID="TranslatorWidget.__updateLanguages"></a>
<h4>TranslatorWidget.__updateLanguages</h4>
<b>__updateLanguages</b>(<i></i>)
+
<p>
Private slot to update the language combo boxes.
-</p><a NAME="TranslatorWidget.__updatePronounceButtons" ID="TranslatorWidget.__updatePronounceButtons"></a>
+</p>
+<a NAME="TranslatorWidget.__updatePronounceButtons" ID="TranslatorWidget.__updatePronounceButtons"></a>
<h4>TranslatorWidget.__updatePronounceButtons</h4>
<b>__updatePronounceButtons</b>(<i></i>)
+
<p>
Private slot to set the state of the pronounce buttons.
-</p><a NAME="TranslatorWidget.__updateTranslateButton" ID="TranslatorWidget.__updateTranslateButton"></a>
+</p>
+<a NAME="TranslatorWidget.__updateTranslateButton" ID="TranslatorWidget.__updateTranslateButton"></a>
<h4>TranslatorWidget.__updateTranslateButton</h4>
<b>__updateTranslateButton</b>(<i></i>)
+
<p>
Private slot to set the state of the translate button.
-</p><a NAME="TranslatorWidget.on_clearButton_clicked" ID="TranslatorWidget.on_clearButton_clicked"></a>
+</p>
+<a NAME="TranslatorWidget.on_clearButton_clicked" ID="TranslatorWidget.on_clearButton_clicked"></a>
<h4>TranslatorWidget.on_clearButton_clicked</h4>
<b>on_clearButton_clicked</b>(<i></i>)
+
<p>
Private slot to clear the text fields.
-</p><a NAME="TranslatorWidget.on_origEdit_textChanged" ID="TranslatorWidget.on_origEdit_textChanged"></a>
+</p>
+<a NAME="TranslatorWidget.on_origEdit_textChanged" ID="TranslatorWidget.on_origEdit_textChanged"></a>
<h4>TranslatorWidget.on_origEdit_textChanged</h4>
<b>on_origEdit_textChanged</b>(<i></i>)
+
<p>
Private slot to handle changes of the original text.
-</p><a NAME="TranslatorWidget.on_origLanguageComboBox_currentIndexChanged" ID="TranslatorWidget.on_origLanguageComboBox_currentIndexChanged"></a>
+</p>
+<a NAME="TranslatorWidget.on_origLanguageComboBox_currentIndexChanged" ID="TranslatorWidget.on_origLanguageComboBox_currentIndexChanged"></a>
<h4>TranslatorWidget.on_origLanguageComboBox_currentIndexChanged</h4>
<b>on_origLanguageComboBox_currentIndexChanged</b>(<i>index</i>)
+
<p>
Private slot to handle the selection of the original language.
-</p><dl>
+</p>
+<dl>
+
<dt><i>index</i></dt>
<dd>
current index (integer)
</dd>
-</dl><a NAME="TranslatorWidget.on_preferencesButton_clicked" ID="TranslatorWidget.on_preferencesButton_clicked"></a>
+</dl>
+<a NAME="TranslatorWidget.on_preferencesButton_clicked" ID="TranslatorWidget.on_preferencesButton_clicked"></a>
<h4>TranslatorWidget.on_preferencesButton_clicked</h4>
<b>on_preferencesButton_clicked</b>(<i></i>)
+
<p>
Private slot to open the Translator configuration page.
-</p><a NAME="TranslatorWidget.on_pronounceOrigButton_clicked" ID="TranslatorWidget.on_pronounceOrigButton_clicked"></a>
+</p>
+<a NAME="TranslatorWidget.on_pronounceOrigButton_clicked" ID="TranslatorWidget.on_pronounceOrigButton_clicked"></a>
<h4>TranslatorWidget.on_pronounceOrigButton_clicked</h4>
<b>on_pronounceOrigButton_clicked</b>(<i></i>)
+
<p>
Private slot to pronounce the original text.
-</p><a NAME="TranslatorWidget.on_pronounceTransButton_clicked" ID="TranslatorWidget.on_pronounceTransButton_clicked"></a>
+</p>
+<a NAME="TranslatorWidget.on_pronounceTransButton_clicked" ID="TranslatorWidget.on_pronounceTransButton_clicked"></a>
<h4>TranslatorWidget.on_pronounceTransButton_clicked</h4>
<b>on_pronounceTransButton_clicked</b>(<i></i>)
+
<p>
Private slot to pronounce the translated text.
-</p><a NAME="TranslatorWidget.on_swapButton_clicked" ID="TranslatorWidget.on_swapButton_clicked"></a>
+</p>
+<a NAME="TranslatorWidget.on_swapButton_clicked" ID="TranslatorWidget.on_swapButton_clicked"></a>
<h4>TranslatorWidget.on_swapButton_clicked</h4>
<b>on_swapButton_clicked</b>(<i></i>)
+
<p>
Private slot to swap the languages.
-</p><a NAME="TranslatorWidget.on_transEdit_textChanged" ID="TranslatorWidget.on_transEdit_textChanged"></a>
+</p>
+<a NAME="TranslatorWidget.on_transEdit_textChanged" ID="TranslatorWidget.on_transEdit_textChanged"></a>
<h4>TranslatorWidget.on_transEdit_textChanged</h4>
<b>on_transEdit_textChanged</b>(<i></i>)
+
<p>
Private slot to handle changes of the translation text.
-</p><a NAME="TranslatorWidget.on_transLanguageComboBox_currentIndexChanged" ID="TranslatorWidget.on_transLanguageComboBox_currentIndexChanged"></a>
+</p>
+<a NAME="TranslatorWidget.on_transLanguageComboBox_currentIndexChanged" ID="TranslatorWidget.on_transLanguageComboBox_currentIndexChanged"></a>
<h4>TranslatorWidget.on_transLanguageComboBox_currentIndexChanged</h4>
<b>on_transLanguageComboBox_currentIndexChanged</b>(<i>index</i>)
+
<p>
Private slot to handle the selection of the translation language.
-</p><dl>
+</p>
+<dl>
+
<dt><i>index</i></dt>
<dd>
current index (integer)
</dd>
-</dl><a NAME="TranslatorWidget.on_translateButton_clicked" ID="TranslatorWidget.on_translateButton_clicked"></a>
+</dl>
+<a NAME="TranslatorWidget.on_translateButton_clicked" ID="TranslatorWidget.on_translateButton_clicked"></a>
<h4>TranslatorWidget.on_translateButton_clicked</h4>
<b>on_translateButton_clicked</b>(<i></i>)
+
<p>
Private slot to translate the entered text.
</p>
