Documentation/Source/eric6.Plugins.UiExtensionPlugins.Translator.TranslatorWidget.html

Sun, 08 Jul 2018 13:05:23 +0200

author
Detlev Offenbach <detlev@die-offenbachs.de>
date
Sun, 08 Jul 2018 13:05:23 +0200
changeset 6412
d71b094845e7
parent 6411
7fd9b7ecbcfe
child 6577
232f83b6763b
permissions
-rw-r--r--

Translator: improved the translator by making the loading of available translations an asynchroneous operation.

<!DOCTYPE html>
<html><head>
<title>eric6.Plugins.UiExtensionPlugins.Translator.TranslatorWidget</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>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 />
<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>
<td><a href="#TranslatorWidget.__availableTranslationsLoaded">__availableTranslationsLoaded</a></td>
<td>Private slot to handle the availability of translations.</td>
</tr><tr>
<td><a href="#TranslatorWidget.__engineComboBoxCurrentIndexChanged">__engineComboBoxCurrentIndexChanged</a></td>
<td>Private slot to handle the selection of a translation service.</td>
</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>
<td><a href="#TranslatorWidget.__mediaPlayerStateChanged">__mediaPlayerStateChanged</a></td>
<td>Private slot handling changes of the media player state.</td>
</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>
<td><a href="#TranslatorWidget.__pronounce">__pronounce</a></td>
<td>Private method to pronounce the given text.</td>
</tr><tr>
<td><a href="#TranslatorWidget.__translate">__translate</a></td>
<td>Private method to translate the given text.</td>
</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>
<td><a href="#TranslatorWidget.__updateClearButton">__updateClearButton</a></td>
<td>Private slot to set the state of the clear button.</td>
</tr><tr>
<td><a href="#TranslatorWidget.__updateEngines">__updateEngines</a></td>
<td>Private slot to update the engines combo box.</td>
</tr><tr>
<td><a href="#TranslatorWidget.__updateLanguages">__updateLanguages</a></td>
<td>Private slot to update the language combo boxes.</td>
</tr><tr>
<td><a href="#TranslatorWidget.__updatePronounceButtons">__updatePronounceButtons</a></td>
<td>Private slot to set the state of the pronounce buttons.</td>
</tr><tr>
<td><a href="#TranslatorWidget.__updateTranslateButton">__updateTranslateButton</a></td>
<td>Private slot to set the state of the translate button.</td>
</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>
<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>
<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>
<td><a href="#TranslatorWidget.on_pronounceOrigButton_clicked">on_pronounceOrigButton_clicked</a></td>
<td>Private slot to pronounce the original text.</td>
</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>
<td><a href="#TranslatorWidget.on_swapButton_clicked">on_swapButton_clicked</a></td>
<td>Private slot to swap the languages.</td>
</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>
<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>
<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>
<dt><i>plugin</i></dt>
<dd>
reference to the plugin object (TranslatorPlugin)
</dd><dt><i>translator</i></dt>
<dd>
reference to the translator object (Translator)
</dd><dt><i>parent</i></dt>
<dd>
reference to the parent widget (QWidget)
</dd>
</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>
<h4>TranslatorWidget.__engineComboBoxCurrentIndexChanged</h4>
<b>__engineComboBoxCurrentIndexChanged</b>(<i>index</i>)
<p>
        Private slot to handle the selection of a translation service.
</p><dl>
<dt><i>index</i> (int)</dt>
<dd>
current index
</dd>
</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>
<h4>TranslatorWidget.__mediaPlayerStateChanged</h4>
<b>__mediaPlayerStateChanged</b>(<i>state</i>)
<p>
        Private slot handling changes of the media player state.
</p><dl>
<dt><i>state</i></dt>
<dd>
media player state (QAudio.State)
</dd>
</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>
<dt>Returns:</dt>
<dd>
code of the original language (string)
</dd>
</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>
<dt><i>text</i></dt>
<dd>
text to be pronounced (string)
</dd><dt><i>language</i></dt>
<dd>
language code of the text (string)
</dd>
</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>
<dt><i>text</i></dt>
<dd>
text to be translated (string)
</dd><dt><i>originalLanguage</i></dt>
<dd>
language code of the original (string)
</dd><dt><i>translationLanguage</i></dt>
<dd>
language code of the translation (string)
</dd>
</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>
<h4>TranslatorWidget.__translationLanguage</h4>
<b>__translationLanguage</b>(<i></i>)
<p>
        Private method to return the code of the selected translation language.
</p><dl>
<dt>Returns:</dt>
<dd>
code of the translation language (string)
</dd>
</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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<dt><i>index</i></dt>
<dd>
current index (integer)
</dd>
</dl><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>
<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>
<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>
<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>
<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>
<dt><i>index</i></dt>
<dd>
current index (integer)
</dd>
</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>
<div align="right"><a href="#top">Up</a></div>
<hr />
</body></html>

eric ide

mercurial