Книга: Основы программирования в Linux

QDialog

QDialog

QDialog — базовый класс диалоговых окон в Qt, предоставляющий методы exec и show для обработки модальных и немодальных диалоговых окон, у него есть встроенный класс QLayout, который можно использовать, и несколько сигналов и слотов, полезных для формирования откликов на нажатие кнопки.

Обычно вы будете создавать для своих диалоговых окон класс-потомок QDialog и вставлять в него виджеты для создания интерфейса диалогового окна:

#include <qdialog.h>
MyDialog::MyDialog(QWidget *parent, const char *name) : QDialog(parent, name) {
 QHBoxLayout *hbox = new QHBoxLayout(this);
 hbox->addWidget(new Qlabel("Enter your name"));
 hbox->addWidget(new QLineEdit());
 hbox->addWidget(ok_pushbutton);
 hbox->addWidget(cancel_pushbutton);
 connect(ok_pushbutton, SIGNAL(clicked()), this, SLOT(accept()));
 connect(cancel_pushbutton, SIGNAL(clicked()), this, SLOT(reject()));
}

В отличие от виджета типа QMainWindow вы можете задать объект MyDialog как родительский для своего объекта QLayout без создания пустого QWidget в качестве родительского.

У объекта QDialog есть два слота — accept и reject, которые применяются для обозначения результата, полученного в диалоговом окне. Этот результат возвращается методом exec. Как правило, вы будете связывать кнопки OK и Cancel со слотами, как в MyDialog.

Для применения диалогового окна как модального вы вызываете метод exec, который открывает диалоговое окно и возвращает QDialog::Accepted или QDialog::Rejected в зависимости от того, какой слот был активизирован:

MyDialog* dialog = new MyDialog(this, "mydialog");
if (dialog->exec() == QDialog::Accepted) {
 // Пользователь щелкнул мышью кнопку OK
 doSomething();
} else {
 // Пользователь щелкнул мышью кнопку Cancel или
 // диалоговое окно уничтожено
 doSomethingElse();
}
delete dialog;

Когда метод exec возвращает управление приложению, диалоговое окно автоматически скрывается, но вы все равно удаляете объект из памяти.

Учтите, что когда вызывается exec, вся обработка прекращается, поэтому, если в вашем приложении есть важный с точки зрения затраченного времени программный код, больше подойдут немодальное или полумодальное диалоговые окна.

Немодальные диалоговые окна слегка отличаются от обычных основных окон прежде всего тем, что располагаются поверх своего родительского окна, совместно используют их элемент на панели задач и автоматически скрываются, когда вызван слот accept или reject.

Для отображения немодального диалогового окна вызывайте метод show, как вы сделали бы для окна QMainWindow:

MyDialog *dialog = new MyDialog(this, "mydialog");
dialog->show();

Функция show выводит диалоговое окно на экран и немедленно возвращается в приложение для продолжения цикла выполнения. Для обработки нажатой кнопки вы должны написать слоты и установить с ними связь:

MyDialog::MyDialog(QWidget *parent, const char *name) :
 QDialog(parent, name) {
 ...
 connect(ok_pushbutton, SIGNAL(clicked()), this, SLOT(OkClicked()));
 connect(cancel_pushbutton, SIGNAL(clicked()), this, SLOT(CancelClicked()));
}
MyDialog::OkClicked() {
 // Выполните что-либо
}
MyDialog::CancelClicked() {
 // Выполните что-либо другое
}

Как и в случае модального окна, диалоговое окно автоматически скрывается при нажатии кнопки.

Для создания полумодального диалогового окна вы должны задать флаг модального режима в конструкторе QDialog и применить метод show:

QDialog(QWidget *parent=0, const char *name=0, bool modal=FALSE, WFlags f=0);

Вы не задаете в модальном диалоговом окне флаг модального режима равным TRUE, потому что вызов exec заставляет диалоговое окно перейти в модальный режим независимо от значения этого флага.

Конструктор вашего диалогового окна будет выглядеть примерно следующим образом:

MySMDialog::MySMDialog(QWidget *parent, const char *name):
 QDialog(parent, name, TRUE) {
 ...
}

После того как вы определили ваше диалоговое окно, вызовите функцию show как обычно и затем продолжите свою обработку, периодически вызывая QApplication::processEvents для обновления вашего диалогового окна:

MySMDialog *dialog = MySMDialog(this, "semimodal");
dialog->show();
while (processing) {
 doSomeProcessing();
 app->processEvents();
 if (dialog->wasCancelled()) break;
}

Перед продолжением выполнения проверьте, не уничтожено ли диалоговое окно. Имейте в виду, что функция wasCancelled не является частью класса QDialog — вы должны написать ее самостоятельно.

Комплект Qt предоставляет готовые подклассы класса QDialog, предназначенные для конкретных задач, таких как выбор файлов, ввод текста, индикация процесса выполнения и вывод окна сообщения. Применение этих виджетов в любых приложениях убережет вас от множества неприятностей и проблем.

Оглавление книги