blob: 49850b6b606b0609658feda8ed298d4977784f02 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
/***************************************************************************
* ktouchlectureeditor.h *
* --------------------- *
* Copyright (C) 2000 by Håvard Frøiland, 2003 by Andreas Nicolai *
* ghorwin@users.sourceforge.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 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
|
