summaryrefslogtreecommitdiffstats
path: root/kwordquiz/src/kwordquiz.h
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commitce599e4f9f94b4eb00c1b5edb85bce5431ab3df2 (patch)
treed3bb9f5d25a2dc09ca81adecf39621d871534297 /kwordquiz/src/kwordquiz.h
downloadtdeedu-ce599e4f9f94b4eb00c1b5edb85bce5431ab3df2.tar.gz
tdeedu-ce599e4f9f94b4eb00c1b5edb85bce5431ab3df2.zip
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
Diffstat (limited to 'kwordquiz/src/kwordquiz.h')
-rw-r--r--kwordquiz/src/kwordquiz.h322
1 files changed, 322 insertions, 0 deletions
diff --git a/kwordquiz/src/kwordquiz.h b/kwordquiz/src/kwordquiz.h
new file mode 100644
index 00000000..85c474b2
--- /dev/null
+++ b/kwordquiz/src/kwordquiz.h
@@ -0,0 +1,322 @@
+/***************************************************************************
+ kwordquiz.h - description
+ -------------------
+ begin : Wed Jul 24 20:12:30 PDT 2002
+ copyright : (C) 2002-2005 by Peter Hedlund
+ email : peter.hedlund@kdemail.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. *
+ * *
+ ***************************************************************************/
+
+#ifndef KWORDQUIZ_H
+#define KWORDQUIZ_H
+
+
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+
+// include files for Qt
+#include <qsignalmapper.h>
+
+// include files for KDE
+#include <kapplication.h>
+#include <kmainwindow.h>
+#include <kaction.h>
+#include <kdirwatch.h>
+#include <kurl.h>
+
+// forward declaration of the KWordQuiz classes
+#include "wqquiz.h"
+class KWordQuizDoc;
+class KWordQuizView;
+class KWordQuizPrefs;
+class QAView;
+class MultipleView;
+class FlashView;
+class KWQNewStuff;
+
+/**
+ * The base class for KWordQuiz application windows. It sets up the main
+ * window and reads the config file as well as providing a menubar, toolbar
+ * and statusbar. An instance of KWordQuizView creates your center view, which is connected
+ * to the window's Doc object.
+ * KWordQuizApp reimplements the methods that KMainWindow provides for main window handling and supports
+ * full session management as well as using KActions.
+ * @see KMainWindow
+ * @see KApplication
+ * @see KConfig
+ *
+ * @author Source Framework Automatically Generated by KDevelop, (c) The KDevelop Team.
+ * @version KDevelop version 1.2 code generation
+ */
+class KWordQuizApp : public KMainWindow
+{
+ Q_OBJECT
+
+ friend class KWordQuizView;
+
+ public:
+ /** construtor of KWordQuizApp, calls all init functions to create the application.
+ */
+ KWordQuizApp(QWidget* parent=0, const char* name=0);
+ ~KWordQuizApp();
+ /** opens a file specified by commandline option
+ */
+ void openDocumentFile(const KURL& url=0);
+ /** returns a pointer to the current document connected to the KTMainWindow instance and is used by
+ * the View class to access the document object's methods
+ */
+ KWordQuizDoc *getDocument() const;
+
+ bool saveAsFileName();
+ protected:
+ /** save general Options like all bar positions and status as well as the geometry and the recent file list to the configuration
+ * file
+ */
+ void saveOptions();
+ /** read general Options again and initialize all variables like the recent file list
+ */
+ void readOptions();
+ /** initializes the KActions of the application */
+
+ void initActions();
+ /** sets up the statusbar for the main window by initialzing a statuslabel.
+ */
+ void initStatusBar();
+ /** initializes the document object of the main window that is connected to the view in initView().
+ * @see initView();
+ */
+ void initDocument();
+ /** creates the centerwidget of the KTMainWindow instance and sets it as the view
+ */
+ void initView();
+ /** queryClose is called by KTMainWindow on each closeEvent of a window. Against the
+ * default implementation (only returns true), this calles saveModified() on the document object to ask if the document shall
+ * be saved if Modified; on cancel the closeEvent is rejected.
+ * @see KTMainWindow#queryClose
+ * @see KTMainWindow#closeEvent
+ */
+ virtual bool queryClose();
+ /** queryExit is called by KTMainWindow when the last window of the application is going to be closed during the closeEvent().
+ * Against the default implementation that just returns true, this calls saveOptions() to save the settings of the last window's
+ * properties.
+ * @see KTMainWindow#queryExit
+ * @see KTMainWindow#closeEvent
+ */
+ virtual bool queryExit();
+ /** saves the window properties for each open window during session end to the session config file, including saving the currently
+ * opened file by a temporary filename provided by KApplication.
+ * @see KTMainWindow#saveProperties
+ */
+ virtual void saveProperties(KConfig *_cfg);
+ /** reads the session config file and restores the application's state including the last opened files and documents by reading the
+ * temporary files saved by saveProperties()
+ * @see KTMainWindow#readProperties
+ */
+ virtual void readProperties(KConfig *_cfg);
+
+ signals:
+ void settingsChanged();
+
+ public slots:
+ /** open a new application window by creating a new instance of KWordQuizApp */
+ void slotFileNew();
+ /** open a file and load it into the document*/
+ void slotFileOpen();
+ /** opens a file from the recent files menu */
+ void slotFileOpenRecent(const KURL& url);
+ /** download vocabularies from the Internet */
+ void slotFileGHNS();
+ /** save a document */
+ void slotFileSave();
+ /** save a document by a new filename*/
+ void slotFileSaveAs();
+ /** asks for saving if the file is modified, then closes the actual file and window*/
+ void slotFileClose();
+ /** print the actual file */
+ void slotFilePrint();
+ /** closes all open windows by calling close() on each memberList item until the list is empty, then quits the application.
+ * If queryClose() returns false because the user canceled the saveModified() dialog, the closing breaks.*/
+ void slotFileQuit();
+
+ /** undo the last command */
+ void slotEditUndo();
+ /** put the marked text/object into the clipboard and remove it from the document */
+ void slotEditCut();
+ /** put the marked text/object into the clipboard */
+ void slotEditCopy();
+ /** paste the clipboard into the document */
+ void slotEditPaste();
+ /** clear the grid selection */
+ void slotEditClear();
+ /** insert a new row */
+ void slotEditInsert();
+ /** delete selected row(s) */
+ void slotEditDelete();
+ /** mark word as blank */
+ void slotEditMarkBlank();
+ /** unmark word as blank */
+ void slotEditUnmarkBlank();
+ /** find and replace text */
+ void slotEditFind();
+
+ /** define vocabulary languages */
+ void slotVocabLanguages();
+ /** define vocabulary fonts */
+ void slotVocabFont();
+ /** define keyboard layouts */
+ void slotVocabKeyboard();
+ /** define special characters */
+ void slotVocabChar();
+ /** define row and column properties */
+ void slotVocabRC();
+ /** sort vocabulary */
+ void slotVocabSort();
+ /** shuffle the vocabulary */
+ void slotVocabShuffle();
+
+ void slotMode0();
+ /** mode 1 */
+ void slotMode1();
+ /** mode 2 */
+ void slotMode2();
+ /** mode 3 */
+ void slotMode3();
+ /** mode 4 */
+ void slotMode4();
+ /** mode 5 */
+ void slotMode5();
+
+ /** editor session */
+ void slotQuizEditor();
+ /** flashcard session */
+ void slotQuizFlash();
+ /** multiple choice session */
+ void slotQuizMultiple();
+ /** question and answer session */
+ void slotQuizQA();
+
+ /** configure notifications */
+ void slotConfigureNotifications();
+ /** configure kwordquiz */
+ void slotConfigure();
+
+
+ /** changes the statusbar contents for the standard label permanently, used to indicate current actions.
+ * @param text the text that is displayed in the statusbar */
+ void slotStatusMsg(const QString &text);
+
+ /** applies changes from the preferences dialog */
+ void slotApplyPreferences();
+
+ void slotUndoChange(const QString & text, bool enabled);
+
+ void slotInsertChar(int i);
+
+ void slotActionHighlighted(KAction *, bool);
+
+ void slotContextMenuRequested(int, int, const QPoint &);
+ private:
+
+ WQQuiz::QuizType m_quizType;
+
+ WQQuiz *m_quiz;
+
+ /** view is the main widget which represents your working area. The View
+ * class should handle all events of the view widget. It is kept empty so
+ * you can create your view according to your application's needs by
+ * changing the view class.
+ */
+ KWordQuizView *m_editView;
+ FlashView *m_flashView;
+ MultipleView *m_multipleView;
+ QAView *m_qaView;
+
+ KWordQuizPrefs *m_prefDialog;
+
+ /** doc represents your actual document and is created only once. It keeps
+ * information such as filename and does the serialization of your files.
+ */
+ KWordQuizDoc *doc;
+
+ // KAction pointers to enable/disable actions
+ KAction* fileNew;
+ KAction* fileOpen;
+ KRecentFilesAction* fileOpenRecent;
+ KAction* fileGHNS;
+ KAction* fileSave;
+ KAction* fileSaveAs;
+ KAction* fileClose;
+ KAction* filePrint;
+ KAction* fileQuit;
+
+ KAction* editUndo;
+ KAction* editCut;
+ KAction* editCopy;
+ KAction* editPaste;
+ KAction* editClear;
+ KAction* editInsert;
+ KAction* editDelete;
+ KAction* editMarkBlank;
+ KAction* editUnmarkBlank;
+ //KAction* editFind;
+
+ KAction* vocabLanguages;
+ KAction* vocabFont;
+ //KAction* vocabKeyboard;
+ KAction* vocabRC;
+ KAction* vocabSort;
+ KAction* vocabShuffle;
+
+ KToolBarPopupAction* mode;
+ KToggleAction* mode1;
+ KToggleAction* mode2;
+ KToggleAction* mode3;
+ KToggleAction* mode4;
+ KToggleAction* mode5;
+
+ KAction* quizEditor;
+ KAction* quizFlash;
+ KAction* quizMultiple;
+ KAction* quizQA;
+
+ KAction* quizCheck;
+ KAction* quizRestart;
+ KAction* quizRepeatErrors;
+
+ KAction* flashKnow;
+ KAction* flashDontKnow;
+
+ KAction* qaHint;
+
+ QSignalMapper* charMapper;
+ KAction* specialChar1;
+ KAction* specialChar2;
+ KAction* specialChar3;
+ KAction* specialChar4;
+ KAction* specialChar5;
+ KAction* specialChar6;
+ KAction* specialChar7;
+ KAction* specialChar8;
+ KAction* specialChar9;
+
+ KDirWatch * m_dirWatch;
+ KWQNewStuff * m_newStuff;
+
+ void updateMode(int m);
+ void updateSession(WQQuiz::QuizType qt);
+ void updateActions(WQQuiz::QuizType qt);
+ void updateSpecialCharIcons();
+ QString charIcon(const QChar &);
+ void openURL(const KURL& url);
+};
+
+#endif // KWORDQUIZ_H