QT 4: программирование GUI на С++

Саммерфилд Марк

Мы рассмотрим управление сеансом через программный код приложения Tic-Tac-Toe (крестики-нолики), которое работает под управлением менеджера сеансов. Во-первых, давайте рассмотрим функцию main:

01 int main(int argc, char *argv[])

02 {

03 Application app(argc, argv);

04 TicTacToe toe;

05 toe.setObjectName("toe");

06 app.setTicTacToe(&toe);

07 toe.show;

08 return app.exec;

09 }

Мы

создаем объект Application. Класс Application наследует QApplication и переопределяет две функции commitData и saveState для обеспечения управления сеансом.

Затем мы создаем виджет TicTacToe, даем знать об этом объекту Application и отображаем его. Мы дали виджету TicTacToe имя «toe». Мы должны давать уникальные имена виджетам верхнего уровня, если мы хотим, чтобы менеджер сеансов мог восстановить размеры и позиции окон.

Рис. 20.8. Приложение Tic-Tac-Toe.

Ниже приводится определение класса Application:

01 class Application : public QApplication

02 {

03 Q_OBJECT

04 public:

05 Application(int &argc, char *argv[]);

06 void setTicTacToe(TicTacToe *tic);

07 void saveState(QSessionManager &sessionManager);

08 void commitData(QSessionManager &sessionManager);

09 private:

10 TicTacToe *ticTacToe;

11 };

Класс Application сохраняет указатель виджета TicTacToe в закрытой переменной.

01 void Application::saveState(QSessionManager &sessionManager)

02 {

03 QString fileName = ticTacToe->saveState;

04 QStringList discardCommand;

05 discardCommand << "rm" << fileName;

06 sessionManager.setDiscardCommand(discardCommand);

07 }

В системе X11 функция saveState вызывается, когда менеджер сеансов собирается сохранить состояние приложения. Данная функция также имеется на других платформах, но никогда не вызывается. Параметр QSessionManager позволяет нам поддерживать связь с менеджером сеансов.

Мы начинаем с попытки сохранения виджетом TicTacToe своего состояния в некоторый файл. Затем мы задаем команду для выполнения сброса состояния менеджером сеансов. Команда сброса (discard command) — это команда, которую должен выполнять менеджер сеансов для удаления любой сохраненной ранее информации, связанной с текущим состоянием. В этом примере мы задаем ее в виде

rm файл_сеанса

где файл_сеанса —

имя файла, который содержит сохраненное состояние сеанса, a rm — стандартная команда удаления файлов в системе Unix.

Менеджер сеансов имеет также команду рестарта (restart command). Эту команду менеджер сеансов должен выполнять для возобновления работы приложения. По умолчанию Qt обеспечивает следующую команду рестарта:

приложение – session идентификатор_ключ

Первая часть, приложение, извлекается из argv[0]. Идентификатор — это идентификатор сеанса, переданный менеджером сеансов; гарантированно обеспечивается его уникальность для различных приложений и различных сеансов работы одного приложения. Ключ добавляется для однозначной идентификации времени сохранения сеанса. По различным причинам менеджер сеансов может вызывать функцию saveState несколько раз в одном сеансе, и различные состояния должны отличаться.

Из-за ограничений существующих менеджеров сеансов нам необходимо убедиться, что каталог приложения содержится в переменной среды PATH, если мы хотим обеспечить правильный рестарт приложения. В частности, если вы сами собираетесь попробовать пример TicTacToe, вы должны установить его в каталог, например, /usr/bin и вызывать его по команде tictactoe.

Для простых приложений, в том числе и для TicTacToe, мы могли бы для обеспечения команды рестарта сохранять состояние в дополнительном аргументе командной строки. Например:

tictactoe -state 0X-X0-X-0

Это избавило бы нас от сохранения данных в файле и выдачи команды сброса состояния для удаления файла.

01 void Application::commitData(QSessionManager &sessionManager)

02 {

03 if (ticTacToe->gameInProgress

04 && sessionManager.allowsInteraction) {

05 int r = QMessageBox::warning(ticTacToe, tr("Tic-Tac-Toe"),

06 tr("The game hasn't finished.\n"

07 "Do you really want to quit?"),

08 QMessageBox::Yes | QMessageBox::Default,

09 QMessageBox::No | QMessageBox::Escape);

10 if (г == QMessageBox::Yes) {

11 sessionManager.release;

12 } else {

13 sessionManager.cancel;

14 }

15 }

16 }

Функция commitData вызывается, когда пользователь выходит из системы. Мы можем переопределить ее для вывода сообщения, предупреждающего пользователя о потенциальной потере данных. В используемой по умолчанию реализации закрываются все виджеты верхнего уровня, что равносильно ситуации, когда пользователь последовательно закрывает все окна, нажимая кнопку закрытия в заголовках окон. В главе 3 мы показали, как можно переопределять функцию closeEvent, перехватывающую этот момент и выводящую на экран сообщение.