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/kdeedu@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 117 insertions, 0 deletions

diff --git a/ktouch/src/ktouchlectureeditor.h b/ktouch/src/ktouchlectureeditor.h
new file mode 100644
index 00000000..49850b6b
--- /dev/null
+++ b/ktouch/src/ktouchlectureeditor.h
@@ -0,0 +1,117 @@
+/***************************************************************************
+ *   ktouchlectureeditor.h                                                 *
+ *   ---------------------                                                 *
+ *   Copyright (C) 2000 by Håvard Frøiland, 2003 by Andreas Nicolai        *
+ *   [email protected]                                         *
+ *                                                                         *
+ *   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.                                   *
+ ***************************************************************************/
+
+#ifndef KTOUCHLECTUREEDITOR_H
+#define KTOUCHLECTUREEDITOR_H
+
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+
+#include <qwidget.h>
+#include <qfont.h>
+#include <kurl.h>
+
+#include "ktouchlectureeditor_dlg.h"
+#include "ktouchlecture.h"
+
+/// This is the KTouch lecture editor dialog.
+///
+/// The lecture edit dialog works like a standalone edit tool for editing lectures.
+/// Upon opening of the dialog the 'open lecture' dialog box is shown where
+/// the user can either select a local training lecture or load a lecture file.
+/// Then the user can edit the lecture and save it (if desired under a different
+/// file name).
+/// The use of the editor is simple, just include ktouchlectureeditor.h and do
+/// @code
+///  KTouchLectureEditor dlg;
+///  bool ok = dlg.startEditor(current_lecture);
+///  // current_lecture should be the URL pointing to the current/default 
+///  // lecture or an empty URL
+/// @endcode
+/// @see startEditor() for details on the return value.
+class KTouchLectureEditor : public KTouchLectureEditorDlg {
+    Q_OBJECT
+  public:
+    /// Constructor
+    KTouchLectureEditor(QWidget *parent, const char* name = 0, bool modal = FALSE, WFlags fl = 0);
+    /// Destructor
+    ~KTouchLectureEditor() {}
+    /// Shows and executes the dialog (argument is the url to the default or 
+    /// current lecture file).
+    /// @return Returns 'true' if the dialog was properly executed (thus reloading 
+    ///         of the lecture in KTouch is necessary) or 'false' if user canceled
+    ///         the "Open request" dialog.
+    bool startEditor(const KURL& url);
+
+  private slots:
+    /// Called when the Font button was clicked.
+    void fontBtnClicked();
+    /// Called when the Open button was clicked.
+    void openBtnClicked();
+    /// Called when the Save button was clicked.
+    void saveBtnClicked();
+    /// Called when the Save As button was clicked.
+    void saveAsBtnClicked();
+    /// Called when the editor is closed.
+    void closeQuery() { if (saveModified()) accept(); }
+    /// Called when the editor is rejected (x clicked).
+    void reject()     { closeQuery(); }
+    /// Will be called whenever some changes are made.
+    void setModified() { setModified(true); }
+    /// Will be called whenever another level has been selected.
+    void newSelection(QListViewItem* item);
+    /// Will be called whenever the new chars description is changed.
+    void newCharsChanged(const QString& text);
+    /// Will be called when the "New Level" button has been clicked.
+    void newLevel();
+    /// Will be called when the "Delete Level" button has been clicked.
+    void deleteLevel();
+    /// Will be called when the "Move Level Up" button has been clicked.
+    void moveUp();
+    /// Will be called when the "Move Level Down" button has been clicked.
+    void moveDown();
+
+  private:
+    /// Transfers data from the lecture object to the dialog.
+    void transfer_to_dialog();
+    /// Transfers data from the dialog to the lecture object.
+    void transfer_from_dialog();
+    /// Fills the level user interface with data from the current level (stored in m_level).
+    void showCurrentLevel();
+    /// Copies the content of the user interface into the vector with the level data.
+    void storeCurrentLevel();
+    /// Creates a default level and appends it to the already existing levels.
+    void createNewLevel();
+    /// Setups and opens the 'Open request dialog'. The url 'url' is used in the
+    /// open request dialog for the 'current' url selection. When the open request 
+    /// dialog is closed the function attempts to load the lecture or if that failes
+    /// creates a new lecture. 
+    /// @return The function returns the return code from the open request dialog, so 
+    ///         that one can react on a "cancel" choice.
+    int openLectureFile(const KURL& url);
+    /// Changes the state of the lecture file (flag==true means modified).
+    void setModified(bool flag);
+    /// If the lecture is modified the user is prompted to save it or throw away the changes. 
+    /// If the user accepts the dialog the file is saved. 
+    /// @return The function returns 'false' if the user aborted the save request, otherwise true.
+    bool saveModified();
+    
+    KTouchLecture                   m_lecture;         ///< The currently used lecture.
+    unsigned int                    m_level;           ///< The current level number.
+    QListViewItem                  *m_currentItem;     ///< The currently selected item in the list view.
+    bool                            m_selecting;       ///< Flag to prevent the selection slot from selecting twice.
+    bool                            m_modified;        ///< Flag indicating whether the lecture has been modified.
+    KURL                            m_currentURL;      ///< URL of the current lecture.
+};
+
+#endif