diff options
author | Timothy Pearson <kb9vqf@pearsoncomputing.net> | 2013-01-26 13:17:21 -0600 |
---|---|---|
committer | Timothy Pearson <kb9vqf@pearsoncomputing.net> | 2013-01-26 13:17:21 -0600 |
commit | dfe289850f068f19ba4a83ab4e7e22a7e09c13c9 (patch) | |
tree | c297348a55df66c571de4525646e0b9762427353 /tdespell2/broker.h | |
parent | b7658a0d5eca24a9d37c6e04f88298ef02389db0 (diff) | |
download | tdelibs-dfe289850f068f19ba4a83ab4e7e22a7e09c13c9.tar.gz tdelibs-dfe289850f068f19ba4a83ab4e7e22a7e09c13c9.zip |
Rename a number of libraries and executables to avoid conflicts with KDE4
Diffstat (limited to 'tdespell2/broker.h')
-rw-r--r-- | tdespell2/broker.h | 136 |
1 files changed, 136 insertions, 0 deletions
diff --git a/tdespell2/broker.h b/tdespell2/broker.h new file mode 100644 index 000000000..26be0e11e --- /dev/null +++ b/tdespell2/broker.h @@ -0,0 +1,136 @@ +// -*- Mode: C++; c-basic-offset: 4; indent-tabs-mode: nil; -*- +/** + * broker.h + * + * Copyright (C) 2003 Zack Rusin <zack@kde.org> + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 2.1 of the License, or (at your option) any later version. + * + * This library 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 + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public + * License along with this library; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA + * 02110-1301 USA + */ +#ifndef KSPELL_BROKER_H +#define KSPELL_BROKER_H + +#include <ksharedptr.h> + +#include <tqobject.h> +#include <tqstringlist.h> +#include <tqstring.h> + +class KSharedConfig; +template <typename T> +class TQPtrDict; + +namespace KSpell2 +{ + class Settings; + class Dictionary; + class DefaultDictionary; + + /** + * @short Class used to deal with dictionaries + * + * This class manages all dictionaries. It's the top level + * KSpell2 class, you can think of it as the kernel or manager + * of the KSpell2 architecture. + */ + class KDE_EXPORT Broker : public TQObject, + public KShared + { + Q_OBJECT + public: + typedef KSharedPtr<Broker> Ptr; + /** + * Constructs the broker. + * + * It's very important that you assign it to Broker::Ptr + * as soon as possible. Broker is reference counted so + * if you don't want to have it deleted under you simply + * have to hold it in a Broker::Ptr for as long as you're + * using it. + * + * @param config is the name of config file which + * broker should use to read default language + * and default client values. If no value will + * be passed Broker will use global tdespellrc file. + */ + static Broker *openBroker( KSharedConfig *config = 0 ); + + public: + ~Broker(); + + /** + * Function returns the so-called DefaultDictionary. It's a + * special form a dictionary which automatically mutates + * according to changes tot the KSpell2::Settings object. + * You also can't delete it like other dictionaries since + * it's owned by the Broker and it will take care of it. + */ + DefaultDictionary *defaultDictionary() const; + + /** + * Returns dictionary for the given language and preferred client. + * + * @param language specifies the language of the dictionary. If an + * empty string will be passed the default language will + * be used. Has to be one of the values returned by + * \ref languages() + * @param client specifies the preferred client. If no client is + * specified a client which supports the given + * language is picked. If a few clients supports + * the same language the one with the biggest + * reliability value is returned. + * + */ + Dictionary *dictionary( + const TQString& language = TQString::null, + const TQString& client = TQString::null ) const; + + /** + * Returns names of all supported clients (e.g. ISpell, ASpell) + */ + TQStringList clients() const; + + /** + * Returns a list of supported languages. + */ + TQStringList languages() const; + + /** + * Returns the Settings object used by the broker. + */ + Settings *settings() const; + signals: + /** + * Signal is emitted whenever the Settings object + * associated with this Broker changes. + */ + void configurationChanged(); + + protected: + friend class Settings; + void changed(); + private: + Broker( KSharedConfig *config ); + void loadPlugins(); + void loadPlugin( const TQString& ); + private: + class Private; + Private *d; + private: + static TQPtrDict<Broker> *s_brokers; + }; +} + +#endif |