Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdeaccessibility@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 269 insertions, 0 deletions

diff --git a/kttsd/filters/talkerchooser/talkerchooserconf.cpp b/kttsd/filters/talkerchooser/talkerchooserconf.cpp
new file mode 100644
index 0000000..0dbf53f
--- /dev/null
+++ b/kttsd/filters/talkerchooser/talkerchooserconf.cpp
@@ -0,0 +1,269 @@
+/***************************************************** vim:set ts=4 sw=4 sts=4:
+  Generic Talker Chooser Filter Configuration class.
+  -------------------
+  Copyright:
+  (C) 2005 by Gary Cramblitt <garycramblitt@comcast.net>
+  -------------------
+  Original author: Gary Cramblitt <garycramblitt@comcast.net>
+
+  This program is free software; you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation; either version 2 of the License, or
+  (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+ ******************************************************************************/
+
+// Qt includes.
+#include <qstring.h>
+#include <qhbox.h>
+#include <qlayout.h>
+
+// KDE includes.
+#include <klocale.h>
+#include <klineedit.h>
+#include <kdialog.h>
+#include <kdialogbase.h>
+#include <kcombobox.h>
+#include <kpushbutton.h>
+#include <kconfig.h>
+#include <kstandarddirs.h>
+#include <kregexpeditorinterface.h>
+#include <ktrader.h>
+#include <kparts/componentfactory.h>
+#include <kfiledialog.h>
+
+// KTTS includes.
+
+// TalkerChooser includes.
+#include "talkerchooserconf.h"
+#include "talkerchooserconf.moc"
+
+/**
+* Constructor 
+*/
+TalkerChooserConf::TalkerChooserConf( QWidget *parent, const char *name, const QStringList& /*args*/) :
+    KttsFilterConf(parent, name)
+{
+    // kdDebug() << "TalkerChooserConf::TalkerChooserConf: Running" << endl;
+
+    // Create configuration widget.
+    QVBoxLayout *layout = new QVBoxLayout(this, KDialog::marginHint(),
+        KDialog::spacingHint(), "TalkerChooserConfigWidgetLayout");
+    layout->setAlignment (Qt::AlignTop);
+    m_widget = new TalkerChooserConfWidget(this, "TalkerChooserConfigWidget");
+    layout->addWidget(m_widget);
+
+    // Determine if kdeutils Regular Expression Editor is installed.
+    m_reEditorInstalled = !KTrader::self()->query("KRegExpEditor/KRegExpEditor").isEmpty();
+    m_widget->reEditorButton->setEnabled(m_reEditorInstalled);
+
+    connect(m_widget->nameLineEdit, SIGNAL(textChanged(const QString&)),
+            this, SLOT(configChanged()));
+    connect(m_widget->reLineEdit, SIGNAL(textChanged(const QString&)),
+            this, SLOT(configChanged()));
+    connect(m_widget->reEditorButton, SIGNAL(clicked()),
+            this, SLOT(slotReEditorButton_clicked()));
+    connect(m_widget->appIdLineEdit, SIGNAL(textChanged(const QString&)),
+            this, SLOT(configChanged()));
+    connect(m_widget->talkerButton, SIGNAL(clicked()),
+            this, SLOT(slotTalkerButton_clicked()));
+
+    connect(m_widget->loadButton, SIGNAL(clicked()),
+            this, SLOT(slotLoadButton_clicked()));
+    connect(m_widget->saveButton, SIGNAL(clicked()),
+            this, SLOT(slotSaveButton_clicked()));
+    connect(m_widget->clearButton, SIGNAL(clicked()),
+            this, SLOT(slotClearButton_clicked()));
+
+    // Set up defaults.
+    defaults();
+}
+
+/**
+* Destructor.
+*/
+TalkerChooserConf::~TalkerChooserConf(){
+    // kdDebug() << "TalkerChooserConf::~TalkerChooserConf: Running" << endl;
+}
+
+/**
+* This method is invoked whenever the module should read its 
+* configuration (most of the times from a config file) and update the 
+* user interface. This happens when the user clicks the "Reset" button in 
+* the control center, to undo all of his changes and restore the currently 
+* valid settings.  Note that kttsmgr calls this when the plugin is
+* loaded, so it not necessary to call it in your constructor.
+* The plugin should read its configuration from the specified group
+* in the specified config file.
+* @param config      Pointer to a KConfig object.
+* @param configGroup Call config->setGroup with this argument before
+*                    loading your configuration.
+*/
+void TalkerChooserConf::load(KConfig* config, const QString& configGroup){
+    // kdDebug() << "TalkerChooserConf::load: Running" << endl;
+    config->setGroup( configGroup );
+    m_widget->nameLineEdit->setText( config->readEntry( "UserFilterName", m_widget->nameLineEdit->text() ) );
+    m_widget->reLineEdit->setText(
+            config->readEntry("MatchRegExp", m_widget->reLineEdit->text()) );
+    m_widget->appIdLineEdit->setText(
+            config->readEntry("AppIDs", m_widget->appIdLineEdit->text()) );
+
+    m_talkerCode = TalkerCode(config->readEntry("TalkerCode"), false);
+    // Legacy settings.
+    QString s = config->readEntry( "LanguageCode" );
+    if (!s.isEmpty()) m_talkerCode.setFullLanguageCode(s);
+    s = config->readEntry( "SynthInName" );
+    if (!s.isEmpty()) m_talkerCode.setPlugInName(s);
+    s = config->readEntry( "Gender" );
+    if (!s.isEmpty()) m_talkerCode.setGender(s);
+    s = config->readEntry( "Volume" );
+    if (!s.isEmpty()) m_talkerCode.setVolume(s);
+    s = config->readEntry( "Rate" );
+    if (!s.isEmpty()) m_talkerCode.setRate(s);
+
+    m_widget->talkerLineEdit->setText(m_talkerCode.getTranslatedDescription());
+}
+
+/**
+* This function gets called when the user wants to save the settings in 
+* the user interface, updating the config files or wherever the 
+* configuration is stored. The method is called when the user clicks "Apply" 
+* or "Ok". The plugin should save its configuration in the specified
+* group of the specified config file.
+* @param config      Pointer to a KConfig object.
+* @param configGroup Call config->setGroup with this argument before
+*                    saving your configuration.
+*/
+void TalkerChooserConf::save(KConfig* config, const QString& configGroup){
+    // kdDebug() << "TalkerChooserConf::save: Running" << endl;
+    config->setGroup( configGroup );
+    config->writeEntry( "UserFilterName", m_widget->nameLineEdit->text() );
+    config->writeEntry( "MatchRegExp", m_widget->reLineEdit->text() );
+    config->writeEntry( "AppIDs", m_widget->appIdLineEdit->text().replace(" ", "") );
+    config->writeEntry( "TalkerCode", m_talkerCode.getTalkerCode());
+}
+
+/** 
+* This function is called to set the settings in the module to sensible
+* default values. It gets called when hitting the "Default" button. The 
+* default values should probably be the same as the ones the application 
+* uses when started without a config file.  Note that defaults should
+* be applied to the on-screen widgets; not to the config file.
+*/
+void TalkerChooserConf::defaults(){
+    // kdDebug() << "TalkerChooserConf::defaults: Running" << endl;
+    // Default name.
+    m_widget->nameLineEdit->setText( i18n("Talker Chooser") );
+    // Default regular expression is blank.
+    m_widget->reLineEdit->setText( "" );
+    // Default App ID is blank.
+    m_widget->appIdLineEdit->setText( "" );
+    // Default to using default Talker.
+    m_talkerCode = TalkerCode( QString::null, false );
+    m_widget->talkerLineEdit->setText( m_talkerCode.getTranslatedDescription() );
+}
+
+/**
+ * Indicates whether the plugin supports multiple instances.  Return
+ * False if only one instance of the plugin can be configured.
+ * @return            True if multiple instances are possible.
+ */
+bool TalkerChooserConf::supportsMultiInstance() { return true; }
+
+/**
+ * Returns the name of the plugin.  Displayed in Filters tab of KTTSMgr.
+ * If there can be more than one instance of a filter, it should return
+ * a unique name for each instance.  The name should be TalkerCode::translated for
+ * the user if possible.  If the plugin is not correctly configured,
+ * return an empty string.
+ * @return          Filter instance name.
+ */
+QString TalkerChooserConf::userPlugInName()
+{
+    if (m_widget->talkerLineEdit->text().isEmpty()) return QString::null;
+    if (m_widget->appIdLineEdit->text().isEmpty() &&
+        m_widget->reLineEdit->text().isEmpty()) return QString::null;
+    QString instName = m_widget->nameLineEdit->text();
+    if (instName.isEmpty()) return QString::null;
+    return instName;
+}
+
+void TalkerChooserConf::slotReEditorButton_clicked()
+{
+    // Show Regular Expression Editor dialog if it is installed.
+    if ( !m_reEditorInstalled ) return;
+    QDialog *editorDialog = 
+        KParts::ComponentFactory::createInstanceFromQuery<QDialog>( "KRegExpEditor/KRegExpEditor" );
+    if ( editorDialog )
+    {
+        // kdeutils was installed, so the dialog was found.  Fetch the editor interface.
+        KRegExpEditorInterface *reEditor =
+            static_cast<KRegExpEditorInterface *>(editorDialog->qt_cast( "KRegExpEditorInterface" ) );
+        Q_ASSERT( reEditor ); // This should not fail!// now use the editor.
+        reEditor->setRegExp( m_widget->reLineEdit->text() );
+        int dlgResult = editorDialog->exec();
+        if ( dlgResult == QDialog::Accepted )
+        {
+            QString re = reEditor->regExp();
+            m_widget->reLineEdit->setText( re );
+        }
+        delete editorDialog;
+    } else return;
+}
+
+void TalkerChooserConf::slotTalkerButton_clicked()
+{
+    QString talkerCode = m_talkerCode.getTalkerCode();
+    SelectTalkerDlg dlg( m_widget, "selecttalkerdialog", i18n("Select Talker"), talkerCode, true );
+    int dlgResult = dlg.exec();
+    if ( dlgResult != KDialogBase::Accepted ) return;
+    m_talkerCode = TalkerCode( dlg.getSelectedTalkerCode(), false );
+    m_widget->talkerLineEdit->setText( m_talkerCode.getTranslatedDescription() );
+    configChanged();
+}
+
+void TalkerChooserConf::slotLoadButton_clicked()
+{
+    QString dataDir = KGlobal::dirs()->findAllResources("data", "kttsd/talkerchooser/").last();
+    QString filename = KFileDialog::getOpenFileName(
+        dataDir,
+        "*rc|Talker Chooser Config (*rc)",
+        m_widget,
+        "talkerchooser_loadfile");
+    if ( filename.isEmpty() ) return;
+    KConfig* cfg = new KConfig( filename, true, false, 0 );
+    load( cfg, "Filter" );
+    delete cfg;
+    configChanged();
+}
+
+void TalkerChooserConf::slotSaveButton_clicked()
+{
+    QString filename = KFileDialog::getSaveFileName(
+        KGlobal::dirs()->saveLocation( "data" ,"kttsd/talkerchooser/", false ),
+       "*rc|Talker Chooser Config (*rc)",
+        m_widget,
+        "talkerchooser_savefile");
+    if ( filename.isEmpty() ) return;
+    KConfig* cfg = new KConfig( filename, false, false, 0 );
+    save( cfg, "Filter" );
+    delete cfg;
+}
+
+void TalkerChooserConf::slotClearButton_clicked()
+{
+    m_widget->nameLineEdit->setText( QString::null );
+    m_widget->reLineEdit->setText( QString::null );
+    m_widget->appIdLineEdit->setText( QString::null );
+    m_talkerCode = TalkerCode( QString::null, false );
+    m_widget->talkerLineEdit->setText( m_talkerCode.getTranslatedDescription() );
+    configChanged();
+}