/* * glossary.h - part of the TDE Help Center * * Copyright (C) 2002 Frerich Raabe (raabe@kde.org) * * 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. */ #ifndef KHC_GLOSSARY_H #define KHC_GLOSSARY_H #include <klistview.h> #include <tqdict.h> #include <tqdom.h> #include <tqstringlist.h> class KConfig; class KProcess; class EntryItem; namespace KHC { class GlossaryEntryXRef { friend TQDataStream &operator>>( TQDataStream &, GlossaryEntryXRef & ); public: typedef TQValueList<GlossaryEntryXRef> List; GlossaryEntryXRef() {} GlossaryEntryXRef( const TQString &term, const TQString &id ) : m_term( term ), m_id( id ) { } TQString term() const { return m_term; } TQString id() const { return m_id; } private: TQString m_term; TQString m_id; }; inline TQDataStream &operator<<( TQDataStream &stream, const GlossaryEntryXRef &e ) { return stream << e.term() << e.id(); } inline TQDataStream &operator>>( TQDataStream &stream, GlossaryEntryXRef &e ) { return stream >> e.m_term >> e.m_id; } class GlossaryEntry { friend TQDataStream &operator>>( TQDataStream &, GlossaryEntry & ); public: GlossaryEntry() {} GlossaryEntry( const TQString &term, const TQString &definition, const GlossaryEntryXRef::List &seeAlso ) : m_term( term ), m_definition( definition ), m_seeAlso( seeAlso ) { } TQString term() const { return m_term; } TQString definition() const { return m_definition; } GlossaryEntryXRef::List seeAlso() const { return m_seeAlso; } private: TQString m_term; TQString m_definition; GlossaryEntryXRef::List m_seeAlso; }; inline TQDataStream &operator<<( TQDataStream &stream, const GlossaryEntry &e ) { return stream << e.term() << e.definition() << e.seeAlso(); } inline TQDataStream &operator>>( TQDataStream &stream, GlossaryEntry &e ) { return stream >> e.m_term >> e.m_definition >> e.m_seeAlso; } class Glossary : public KListView { Q_OBJECT public: Glossary( TQWidget *parent ); virtual ~Glossary(); const GlossaryEntry &entry( const TQString &id ) const; static TQString entryToHtml( const GlossaryEntry &entry ); virtual void show(); public slots: void slotSelectGlossEntry( const TQString &id ); signals: void entrySelected( const GlossaryEntry &entry ); private slots: void meinprocExited( KProcess *meinproc ); void treeItemSelected( TQListViewItem *item ); private: enum CacheStatus { NeedRebuild, CacheOk }; CacheStatus cacheStatus() const; int glossaryCTime() const; void rebuildGlossaryCache(); void buildGlossaryTree(); TQDomElement childElement( const TQDomElement &e, const TQString &name ); KConfig *m_config; TQListViewItem *m_byTopicItem; TQListViewItem *m_alphabItem; TQString m_sourceFile; TQString m_cacheFile; CacheStatus m_status; TQDict<GlossaryEntry> m_glossEntries; TQDict<EntryItem> m_idDict; bool m_initialized; }; } #endif // KHC_GLOSSARY_H // vim:ts=2:sw=2:et