You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
324 lines
10 KiB
324 lines
10 KiB
/***************************************************************************
|
|
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 TQt
|
|
#include <tqsignalmapper.h>
|
|
|
|
// include files for KDE
|
|
#include <tdeapplication.h>
|
|
#include <tdemainwindow.h>
|
|
#include <tdeaction.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 TDEMainWindow provides for main window handling and supports
|
|
* full session management as well as using TDEActions.
|
|
* @see TDEMainWindow
|
|
* @see TDEApplication
|
|
* @see TDEConfig
|
|
*
|
|
* @author Source Framework Automatically Generated by KDevelop, (c) The KDevelop Team.
|
|
* @version KDevelop version 1.2 code generation
|
|
*/
|
|
class KWordQuizApp : public TDEMainWindow
|
|
{
|
|
Q_OBJECT
|
|
|
|
|
|
friend class KWordQuizView;
|
|
|
|
public:
|
|
/** construtor of KWordQuizApp, calls all init functions to create the application.
|
|
*/
|
|
KWordQuizApp(TQWidget* 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 TDEActions 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 TDEApplication.
|
|
* @see KTMainWindow#saveProperties
|
|
*/
|
|
virtual void saveProperties(TDEConfig *_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(TDEConfig *_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 TQString &text);
|
|
|
|
/** applies changes from the preferences dialog */
|
|
void slotApplyPreferences();
|
|
|
|
void slotUndoChange(const TQString & text, bool enabled);
|
|
|
|
void slotInsertChar(int i);
|
|
|
|
void slotActionHighlighted(TDEAction *, bool);
|
|
|
|
void slotContextMenuRequested(int, int, const TQPoint &);
|
|
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;
|
|
|
|
// TDEAction pointers to enable/disable actions
|
|
TDEAction* fileNew;
|
|
TDEAction* fileOpen;
|
|
TDERecentFilesAction* fileOpenRecent;
|
|
TDEAction* fileGHNS;
|
|
TDEAction* fileSave;
|
|
TDEAction* fileSaveAs;
|
|
TDEAction* fileClose;
|
|
TDEAction* filePrint;
|
|
TDEAction* fileQuit;
|
|
|
|
TDEAction* editUndo;
|
|
TDEAction* editCut;
|
|
TDEAction* editCopy;
|
|
TDEAction* editPaste;
|
|
TDEAction* editClear;
|
|
TDEAction* editInsert;
|
|
TDEAction* editDelete;
|
|
TDEAction* editMarkBlank;
|
|
TDEAction* editUnmarkBlank;
|
|
//TDEAction* editFind;
|
|
|
|
TDEAction* vocabLanguages;
|
|
TDEAction* vocabFont;
|
|
//TDEAction* vocabKeyboard;
|
|
TDEAction* vocabRC;
|
|
TDEAction* vocabSort;
|
|
TDEAction* vocabShuffle;
|
|
|
|
TDEToolBarPopupAction* mode;
|
|
TDEToggleAction* mode1;
|
|
TDEToggleAction* mode2;
|
|
TDEToggleAction* mode3;
|
|
TDEToggleAction* mode4;
|
|
TDEToggleAction* mode5;
|
|
|
|
TDEAction* quizEditor;
|
|
TDEAction* quizFlash;
|
|
TDEAction* quizMultiple;
|
|
TDEAction* quizQA;
|
|
|
|
TDEAction* quizCheck;
|
|
TDEAction* quizRestart;
|
|
TDEAction* quizRepeatErrors;
|
|
|
|
TDEAction* flashKnow;
|
|
TDEAction* flashDontKnow;
|
|
|
|
TDEAction* qaHint;
|
|
|
|
TQSignalMapper* charMapper;
|
|
TDEAction* specialChar1;
|
|
TDEAction* specialChar2;
|
|
TDEAction* specialChar3;
|
|
TDEAction* specialChar4;
|
|
TDEAction* specialChar5;
|
|
TDEAction* specialChar6;
|
|
TDEAction* specialChar7;
|
|
TDEAction* specialChar8;
|
|
TDEAction* specialChar9;
|
|
|
|
KDirWatch * m_dirWatch;
|
|
KWQNewStuff * m_newStuff;
|
|
|
|
void updateMode(int m);
|
|
void updateSession(WQQuiz::QuizType qt);
|
|
void updateActions(WQQuiz::QuizType qt);
|
|
void updateSpecialCharIcons();
|
|
TQString charIcon(const TQChar &);
|
|
void openURL(const KURL& url);
|
|
};
|
|
|
|
#endif // KWORDQUIZ_H
|