Жасмин Бланшет - QT 4: программирование GUI на С++
Теперь мы закончили наш обзор MainWindow, и поэтому мы можем перейти к реализации класса Editor. Класс Editor представляет одно дочернее окно. Он наследует QTextEdit, который обеспечивает функциональность текстового редактора. Точно так же, как любой виджет, который может использоваться в качестве автономного окна, он может использоваться и в качестве дочернего окна в рабочем пространстве интерфейса MDI.
Ниже приводится определение класса:
01 class Editor : public QTextEdit
02 {
03 Q_OBJECT
04 public:
05 Editor(QWidget *parent = 0);
06 bool openFile(const QString &fileName);
07 bool save();
08 bool saveAs();
09 void newFile();
10 bool open();
11 protected:
12 QSize sizeHint() const;
13 QAction *windowMenuAction() const { return action; }
14 void closeEvent(QCloseEvent *event);
15 private slots:
16 void documentWasModified();
17 private:
18 bool okToContinue();
19 bool saveFile(const QString &fileName);
20 void setCurrentFile(const QString &fileName);
21 bool readFile(const QString &fileName);
22 bool writeFile(const QString &fileName);
23 QString strippedName(const QString &fullFileName);
24 QString curFile;
25 bool isUntitled;
26 QString fileFilters;
27 QAction *action;
28 }
Присутствующие в классе MainWindow приложения Электронная таблица четыре закрытые функции имеются также в классе Editor: okToContinue(), saveFile(), setCurrentFile() и strippedName().
01 Editor::Editor(QWidget *parent)
02 : QTextEdit(parent)
03 {
04 action = new QAction(this);
05 action->setCheckable(true);
06 connect(action, SIGNAL(triggered()), this, SLOT(show()));
07 connect(action, SIGNAL(triggered()), this, SLOT(setFocus()));
08 isUntitled = true;
09 fileFilters = tr("Text files (*.txt)nAll files (*)");
10 connect(document(), SIGNAL(contentsChanged()),
11 this, SLOT(documentWasModified()));
12 setWindowIcon(QPixmap(":/images/document.png"));
13 setAttribute(Qt::WA_DeleteOnClose);
14 }
Сначала мы создаем действие QAction, представляющее редактор в меню приложения Window, и связываем его со слотами show() и setFocus().
Поскольку мы разрешаем пользователям создавать любое количество окон редактора, мы должны предусмотреть соответствующую систему их наименования, чтобы они отличались до первого их сохранения. Один из распространенных методов решения этой проблемы заключается в назначении имен с числами (например, document1.txt). Мы используем переменную isUntitled, чтобы отличить предоставляемые пользователем имена документов и сгенерированные программно.
Мы связываем сигнал текстового документа contentsChanged() c закрытым слотом documentWasModified(). Этот слот просто вызывает setWindowModified(true).
Наконец, мы устанавливаем атрибут Qt::WA_DeleteOnClose для предотвращения утечек памяти при закрытии пользователем окна Editor.
После выпрлнения конструктора мы ожидаем вызова либо функции newFile(), либо функции open().
01 void Editor::newFile()
02 {
03 static int documentNumber = 1;
04 curFile = tr("document%1.txt").arg(documentNumber);
05 setWindowTitle(curFile + "[*]");
06 action->setText(curFile);
07 isUntitled = true;
08 ++documentNumber;
09 }
Функция newFile() генерирует для нового документа имя типа document1.txt. Этот программный код помещен в функцию newFile(), a не в конструктор, поскольку мы не хотим использовать числа при вызове функции open() для открытия существующего документа во вновь созданном редакторе Editor. Поскольку переменная documentNumber объявлена как статическая, она совместно используется всеми экземплярами Editor.
Маркер «[*]» в заголовке окна указывает место, где мы хотим выдавать звездочку при несохраненных изменениях файла для платформ, отличных от Mac OS X. Мы рассматривали этот маркер в главе 3.
01 bool Editor::open()
02 {
03 QString fileName = QFileDialog::getOpenFileName(
04 this, tr("Open"), fileFilters);
05 if(fileName.isEmpty())
06 return false;
07 return openFile(fileName);
08 }
Функция open() пытается открыть сущеcтвующий файл при помощи функции openFile().
01 bool Editor::save()
02 {
03 if (isUntitled) {
04 return saveAs();
05 } else {
06 return saveFile(curFile);
07 }
Функция save() используёт переменную isUntitled для определения вида вызываемой функции saveFile() или saveAs().
01 void Editor::closeEvent(QCloseEvent *event)
02 {
03 if (okToContinue()) {
04 event->accept();
05 } else {
06 event->ignore();
07 }
08 }
Функция closeEvent() переопределяется, чтобы разрешить пользователю сохранить несохраненные изменения. Вся логика содержится в функции okToContinue(), которая выводит сообщение «Do you want to save your changes?» (Сохранить изменения?). Если функция okToContinue() возвращает true, мы обрабатывам событие закрытия; в противном случае мы «игнорируем» его и окно оставляем прежним.
01 void Editor::setCurrentFile(const QString &fileName)
02 {
03 curFile = fileName;
04 isUntitled = false;
05 action->setText(strippedName(curFile));
06 document()->setModified(false);
07 setWindowTitle(strippedName(curFile) + "[*]");
08 setWindowModified(false);
09 }
Функция setCurrentFile() вызывается из openFile() и saveFile() для обновления переменных curFile и isUntitled, установки текста заголовка окна и пункта меню, а также для установки значения флажка модификации документа на false. Всякий раз, когда пользователь изменяет текст в редакторе, объект базового класса QTextDocument генерирует сигнал contentsChanged() и устанавливает свой внутренний флажок модификации на значение true.
01 QSize Editor::sizeHint() const
02 {
03 return QSize(72 * fontMetrics().width('x'),
04 25 * fontMetrics().lineSpacing());
05 }
Функция sizeHint() возвращает размер, рассчитанный на основе ширины буквы «x» и высоты строки текста. QWorkspace использует идеальный размер в качестве начального размера окна.
Ниже приводится файл main.cpp MDI—приложения Editor:
01 #include <QApplication>
02 #include "mainwindow.h"
03 int main(int argc, char *argv[])
04 {
05 QApplication app(argc, argv);
06 QStringList args = app.arguments();
07 MainWindow mainWin;
08 if (args.count() > 1) {
09 for (int i = 1; i < args.count(); ++i)
10 mainWin.openFile(args[i]);
11 } else {
12 mainWin.newFile();
13 }
14 mainWin.show();
15 return app.exec();
16 }
Еслй пользователь задает в командной строке какие-нибудь файлы, мы пытаемся их загрузить, в противном случае мы начинаем работу с пустым документом. Такие характерные для Qt опции командной строки, как —style и —font (стиль и шрифт), автоматически убираются из списка аргументов конструктором QApplication. Поэтому, если мы напишем в командной строке
mdieditor -style motif readme.txt
QApplication::arguments() возвратит QStringList с двумя элементами («mdieditor» и «readme.txt»), а МDI—приложение Editor запустится с документом readme.txt.
Интерфейс MDI представляет собой один из способов работы одновременно со многими документами. В системе MacOS Х более предпочтителен подход, связанный с применением нескольких окон верхнего уровня. Этот подход рассматривается в разделе «Работа со многими документами» главы З.
Глава 7. Обработка событий
События генерируются оконной системой или Qt в ответ на различные действия. Когда пользователь нажимает или отпускает клавишу или кнопку мышки, генерируется событие клавиши клавиатуры или кнопки мышки; когда окно впервые выводится на экран, генерируется событие рисования, указывая появившемуся окну на необходимость его прорисовки. Большинство событий генерируются в ответ на действия пользователя, но некоторые события, например, события таймера, генерируются самой системой и не зависят от действий пользователя.
При программировании в Qt нам редко приходится думать о событиях, поскольку виджеты Qt сами генерируют сигналы в ответ на любое существенное событие. События становятся полезными при создании нами своих сооственных виджетов, или когда мы хотим модифицировать поведение существующих виджетов Qt.
