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, 191 insertions, 0 deletions

diff --git a/ksayit/src/doctreeviewimpl.h b/ksayit/src/doctreeviewimpl.h
new file mode 100644
index 0000000..4ad0c38
--- /dev/null
+++ b/ksayit/src/doctreeviewimpl.h
@@ -0,0 +1,191 @@
+//
+// C++ Interface: doctreeviewimpl
+//
+// Description:
+//
+//
+// Author: Robert Vogl <voglrobe@lapislazuli>, (C) 2004
+//
+// Copyright: See COPYING file that comes with this distribution
+//
+//
+#ifndef DOCTREEVIEWIMPL_H
+#define DOCTREEVIEWIMPL_H
+
+// Qt includes
+#include <qstring.h>
+
+// KDE includes
+#include <kurl.h>
+#include <klistview.h>
+#include <kpopupmenu.h>
+
+// App specific includes
+#include "Types.h"
+#include "DocTreeView.h"
+
+// forward declarations
+class ParaSaxParser;
+class ContextMenuHandler;
+
+
+/**
+This class implements the TreeView object.\n
+It takes a XML/DocBook file, parses it and builds up a hierarchical
+\p QListView structure corresponding to the structure of the document.
+The objective of this class is to maintain the document and provide
+all required methods to access or manipulate its content.
+@author Robert Vogl
+*/
+class DocTreeViewImpl : public DocTreeView
+{
+public:
+    DocTreeViewImpl(QWidget* parent=0, const char* name=0, WFlags fl=0);
+
+    ~DocTreeViewImpl();
+
+    /**
+     * Tries to open and parse the given file. If the file is not identified as a
+     * valid XML/DocBook file, it will be packed as a \p CDATA block into a \p para element
+     * of a simple DocBook'ish XML file.
+     * \param url The URL of the file.
+     */
+    void openFile(const KURL &url);
+
+    /**
+     * Saves the document to a XML file.
+     */
+    void saveFile();
+
+    /**
+     * Saves the document to a XML file and allows the user to define a name.
+     */
+    void saveFileAs();
+
+    /**
+     * Cleans up the interal document data structures.
+     */
+    void clear();
+
+    /**
+     * Creates an empty XML document that conatins one editable DocBook \p Paragraph.
+     * Usually called after clean() and initial startup.
+     */
+    void createEmptyDocument();
+
+    /**
+     * Stores the given text but does not make the new content
+     * persistent.
+     * \param text The content of the TextEdit view.
+     */
+    void setNodeContent(QString &text);
+
+    /**
+     * Starting from the current selected node it travels recursively
+     * through all childs and collects the content of all corresponding
+     * DOM nodes. After sending the text to the TTS system the speech synthesis
+     * process will be started.
+     */
+    void sayActiveNodeAndChilds();
+
+    /**
+     * Signals a stop-talking-request from the user.
+     */
+    void stop();
+
+    /**
+     * Controls the Edit Mode.
+     * \param mode If true, Edit Mode ON,\n if false, Edit Mode OFF.
+     */
+    void setEditMode(bool mode);
+    
+    /**
+     * Sets the item active designated by the ID.
+     * \param ID The ID (column 3) of the TreeView item.
+     * \returns <tt>QString::null</tt> if the operation was successfull,\n
+     * an error message, if the item was not found.
+     */
+    QString selectItemByID(const QString &ID, const QString title);
+    
+    /**
+     * Enables/disables the contextmenus
+     */
+    void enableContextMenus( bool enabled );
+
+public slots:
+    void slotRenameItem();  // reimplemented from base classes
+    void slotDeleteItem();
+    void slotNewBookInfo();
+    void slotNewChapter();
+    void slotNewKeywordSet();
+    void slotNewKeyword();
+    void slotNewAbstract();
+    void slotNewAuthorGroup();
+    void slotNewAuthor();
+    void slotNewDate();
+    void slotNewReleaseInfo();
+    void slotNewTitle();
+    void slotNewParagraph();
+    void slotNewSection_1();
+    void slotNewSection_2();
+    void slotNewSection_3();
+    void slotNewSection_4();
+    void slotNewSection_5();
+    
+protected slots:
+    /**
+     * Reimplemented from base class.
+     * Called whenever the active node has been changed.\n
+     * Makes the former selected item persistent (maybe it has
+     * been changed).\n
+     * Displays the content of the selected Node either in RTF or
+     * plain text format (depending on the Edit Mode flag, childs
+     * present or not).\n
+     * Informs the BookmarkManager about the new item.
+     *
+     * \param item The new active item of the TreeView.
+     */
+    void slotItemClicked(QListViewItem *item);
+    
+    /**
+     * Reimplemented from base class.
+     * Called when the right button was pressed.
+     * \param item The new active item of the TreeView.
+     */
+    void slotRightButtonPressed(QListViewItem *item, const QPoint &pos, int);
+    
+    /**
+     * Reimplemented from QWidget class.
+     */
+    // void contextMenuEvent(QContextMenuEvent *e);
+
+private: // Methods
+    void recursiveTextCollector(ListViewInterface* item, QTextStream &msg, bool header=true);
+    void recursiveSayNodes(ListViewInterface* item);
+    void recursiveBuildItemIdentifier(ListViewInterface* item, QTextStream &idstring);
+    void makeCurrentNodePersistent();
+    int newIndexFirstChild();
+    int newIndexLastChild();
+    void findHighestIndex(ListViewInterface* item, int &index);
+    QString getItemTitle( ListViewInterface *item);
+    void makeToSingleLine( QString &content );    
+
+        
+private: // Attributes
+    ContextMenuHandler *m_contextmenuhandler;
+    KPopupMenu *m_contextmenu; 
+    ListViewInterface *m_rootItem;
+    ListViewInterface *m_currentItem;
+    QString m_changedContent;
+    int m_idCounter;
+    bool m_stopped;
+    KURL m_url;
+    ParaSaxParser *m_parasaxparser;
+    bool m_editMode;
+};
+
+
+
+
+
+#endif