=> Главная База Знаний Qt Применение диалоговых окон


Применение диалоговых окон

Применение диалоговых окон

В данном разделе мы рассмотрим способы применения диалоговых окон в Qt: как они создаются и инициализируются и как они реагируют на действия пользователя при работе с ними. Мы будем использовать диалоговые окна Find, Go-to-Cell и Sort (найти, перейти в ячейку и сортировать), которые были созданы нами в главе 2. Мы также создадим простое окно About (справка о программе).

Рис. 3.12. Диалоговое окно Find приложения Электронная таблица.

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

При создании немодальных диалоговых окон они обычно имеют свои сигналы, соединенные со слотами, которые реагируют на действия пользователя:

01 void MainWindow::find()

02 {

03 if (!findDialog) {

04 findDialog = new FindDialog(this);

05 connect(findDialog, SIGNAL (findNext(const QString &,

06 Qt::CaseSensitivity)),

07 spreadsheet, SLOT (findNext(const QString &,

08 Qt::CaseSensitivity)));

09 connect(findDialog, SIGNAL(findPrevious(const QString &,

10 Qt::CaseSensitivity)),

11 spreadsheet, SLOT(findPrevious(const QString &,

12 Qt::CaseSensitivity)));

13 }

14 findDialog->show();

15 findDialog->activateWindow();

16 }

Диалоговое окно Find позволяет пользователю выполнять поиск текста в электронной таблице. Слот find() вызывается при выборе пользователем пункта меню Edit | Find (Правка | Найти) для вывода на экран диалогового окна Find. После этого возможны три сценария развития событий в зависимости от следующих условий:

• диалоговое окно Find вызывается пользователем первый раз;

• диалоговое окно Find уже вызывалось, но пользователь его закрыл;

• диалоговое окно Find уже вызывалось, и оно по-прежнему видимо.

Если нет диалогового окна Find, мы создаем его, а его функции findNext() и findPrevious() подсоединяем к соответствующим слотам электронной таблицы Spreadsheet. Мы могли бы также создать это диалоговое окно в конструкторе MainWindow, но отсрочка его создания ускоряет запуск приложения. Кроме того, если это диалоговое окно никогда не будет использовано, то оно и не будет создаваться, что сэкономит время и память.

Затем мы вызываем функции show() и activateWindow() и тем самым делаем это окно видимым и активным. Чтобы сделать скрытое окно видимым и активным, достаточно вызвать функцию show(), но диалоговое окно Find может вызываться, когда оно уже имеется на экране, и в этом случае функция show() ничего не будет делать и необходимо вызвать activateWindow(), чтобы сделать окно активным. Можно поступить по-другому и написать:

if (findDialog->isHidden()) {

findDialog->show();

} else {

findDialog->activateWindow();

}

что аналогично ситуации, когда вы смотрите в обе стороны при переходе улицы с односторонним движением.

Теперь мы перейдем к созданию диалогового окна Go-to-Cell (перейти на ячейку). Мы хотим, чтобы пользователь мог его вызвать, произвести соответствующие действия с его помощью и затем закрыть его, причем пользователь не должен иметь возможность переходить на любое другое окно приложения. Это означает, что диалоговое окно перехода на ячейку должно быть модальным. Окно называется модальным, если после его вызова работа приложения блокируется и оказывается невозможной работа с другими окнами приложения до закрытия этого окна. Все используемые нами до сих пор файловые диалоговые окна и окна с сообщениями были модальными.

Рис. 3.13. Диалоговое окно Go-to-Cell приложения Электронная таблица.

Диалоговое окно будет немодальным, если оно вызывается с помощью функции show() (если мы не сделали до этого его модальным, воспользовавшись функцией setModal()); оно будет модальным, если вызывается при помощи функции exec().

01 void MainWindow::goToCell()

02 {

03 GoToCellDialog dialog(this);

04 if (dialog.exec()) {

05 QString str = dialog.lineEdit->text().toUpper();

06 spreadsheet->setCurrentCell(str.mid(1).toInt() - 1,

07 str[0].unicode() - 'А');

08 }

09 }

Функция QDialog::exec() возвращает значение true (QDialog::Accepted), если через диалоговое окно подтверждается действие, и значение false (QDialog::Rejected) в противном случае. Напомним, что мы в главе 2 создали диалоговое окно перехода на ячейку при помощи Qt Designer и подсоединили кнопку OK к слоту accept(), а кнопку Cancel — к слоту reject(). Если пользователь нажимает кнопку OK, мы устанавливаем текущую ячейку таблицы на значение, заданное в строке редактирования.

В функции QTableWidget::setCurrentCell() задаются два аргумента: индекс строки и индекс столбца. В приложении Электронная таблица обозначение A1 относится к ячейке (0, 0), а обозначение B27 относится к ячейке (26, 1). Для получения индекса строки из возвращаемого функцией QLineEdit::text() значения типа QString мы выделяем номер строки с помощью функции QString::mid() (которая возвращает подстроку с первой позиции до конца этой строки), преобразуем ее в целое число типа int при помощи функции QString::toInt() и вычитаем единицу. Для получения номера столбца мы вычитаем числовой код буквы «А» из числового кода первой буквы строки, преобразованной в прописную. Мы знаем, что строка будет иметь правильный формат, потому что осуществляемый нами контроль диалога с помощью QRegExpValidator делает кнопку OK активной только в том случае, если за буквой располагается не более трех цифр.

Функция goToCell() отличается от приводимого до сих пор программного кода тем, что она создает виджет (GoToCellDialog) в виде переменной стека. Мы столь же легко могли бы воспользоваться операторами new и delete, что увеличило бы программный код только на одну строку:

01 void MainWindow::goToCell()

02 {

03 GoToCellDialog *dialog = new GoToCellDialog(this);

04 if (dialog->exec()) {

05 QString str = dialog->lineEdit->text().toUpper();

06 spreadsheet->setCurrentCell(str.mid(1).toInt() - 1,

07 str[0].unicode() - 'A');

08 }

09 delete dialog;

10 }

Создание модальных диалоговых окон (и контекстных меню при переопределении QWidget::contextMenuEvent()) является обычной практикой программирования, поскольку такое окно (или меню) будет не нужно после его использования, и оно будет автоматически уничтожено при выходе из области видимости.

Теперь мы перейдем к созданию диалогового окна Sort. Это диалоговое окно является модальным и позволяет пользователю упорядочить текущую выбранную область, задавая в качестве ключей сортировки определенные столбцы. На рис. 3.14 показан пример сортировки, когда в качестве главного ключа сортировки используется столбец В, а в качестве вторичного ключа сортировки используется столбец А (в обоих случаях сортировка выполняется по возрастанию значений).

Рис. 3.14. Сортировка выделенной области электронной таблицы.

01 void MainWindow::sort()

02 {

03 SortDialog dialog(this);

04 QTableWidgetSelectionRange range = spreadsheet->selectedRange();

05 dialog.setColumnRange('A' + range.leftColumn(),

06 'А' + range.rightColumn());

07 if (dialog.exec()) {

08 SpreadsheetCompare compare;

09 compare.keys[0] =

10 dialog.primaryColumnCombo->currentIndex();

11 compare.keys[1] =

12 dialog.secondaryColumnCombo->currentIndex() - 1;

13 compare.keys[2] =

14 dialog.tertiaryColumnCombo->currentIndex() - 1;

15 compare.ascending[0] =

16 (dialog.primaryOrderCombo->currentIndex() == 0);

17 compare.ascending[1] =

18 (dialog.secondaryOrderCombo->currentIndex() == 0);

19 compare.ascending[2] =

20 (dialog.tertiaryOrderCombo->currentIndex() == 0);

21 spreadsheet->sort(compaге);

22 }

23 }

Порядок действий при программировании функции sort() аналогичен порядку действий, применяемому при программировании функции goToCell();

• мы создаем диалоговое окно в стеке и инициализируем его;

• мы вызываем диалоговое окно при помощи функции exec();

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

Вызов setColumnRange() задает столбцы, выбранные для сортировки. Например, при выделении области, показанной на рис. 3.14, функция range.leftColumn() возвратит 0, давая в результате 'A' + 0 = 'A', a range.rightColumn() возвратит 2, давая в результате 'A' + 2 = 'C'.

В объекте compare хранятся первичный, вторичный и третичный ключи, а также порядок сортировки по ним. (Определение класса SpreadsheetCompare мы рассмотрим в следующей главе.) Этот объект используется функцией Spreadsheet::sort() для сортировки строк. В массиве keys содержатся номера столбцов ключей. Например, если выбрана область с C2 по E5, то столбец С будет иметь индекс 0. В массиве ascending в переменных типа bool хранятся значения направления сортировки для каждого ключа. Функция QComboBox::currentIndex() возвращает индекс текущего элемента (начиная с 0). Для вторичного и третичного ключей мы вычитаем единицу из текущего элемента, чтобы учесть значения «None» (отсутствует).

Функция sort() сделает свою работу, но она не совсем надежна. Она предполагает определенный способ реализации диалогового окна, а именно использование выпадающих списков и элементов со значением «None». Это означает, что при изменении дизайна диалогового окна Sort нам, возможно, потребуется изменить также программный код. Такой подход можно использовать для диалогового окна, применяемого только в одном месте; однако это может вызвать серьезные проблемы сопровождения, если это диалоговое окно станет использоваться в различных местах.

Более надежным будет такой подход, когда класс SortDialog делается более «разумным» и может создавать свой собственный объект SpreadsheetCompare, доступный вызывающему его компоненту. Это значительно упрощает функцию MainWindow::sort():

01 void MainWindow::sort()

02 {

03 SortDialog dialog(this);

04 QTableWidgetSelectionRange range = spreadsheet->selectedRange();

05 dialog.setColumnRange('A' + range.leftColumn(),

06 'А' + range.rightColumn());

07 if (dialog.exec())

08 spreadsheet->performSort(dialog.comparisonObject());

09 }

Такой подход приводит к созданию слабо связанных компонентов, и выбор его почти всегда будет правилен для диалоговых окон, которые вызываются из нескольких мест.

Более «радикальный» подход мог бы заключаться в передаче указателя на объект Spreadsheet при инициализации объекта SortDialog и разрешении диалоговому окну работать непосредственно с объектом Spreadsheet. Это значительно снизит универсальность диалогового окна SortDialog, поскольку оно будет работать только с виджетами определенного типа, но это позволит еще больше упростить программу из-за возможности исключения функции SortDialog::setColumnRange(). В этом случае функция MainWindow::sort() примет следующий вид:

01 void MainWindow::sort()

02 {

03 SortDialog dialog(this);

04 dialog.setSpreadsheet(spreadsheet);

05 dialog.exec();

06 }

Этот подход является зеркальным отражением первого: вместо знания вызывающим компонентом характерных особенностей диалогового окна теперь само диалоговое окно должно иметь представление об особенностях структур данных, передаваемых вызывающим компонентом. Этот подход полезно применять, когда диалоговому окну требуется отслеживать изменения. В то время как при первом подходе ненадежен код вызвавшего компонента, третий подход перестает работать при изменении структуры данных.

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

Мы завершим данный раздел созданием диалогового окна About (справка о программе). Мы могли бы создать для представления данных о программе специальное диалоговое окно наподобие созданных нами ранее Find или Go-to-Cell, но поскольку диалоговые окна About сильно стилизованы, в средствах разработки Qt предусмотрено простое решение:

01 void MainWindow::about()

02 {

03 QMessageBox::about(this, tr("About Spreadsheet"),

04 tr("<h2>Spreadsheet 1.1</h2>"

05 "<p>Copyright © 2006 Software Inc."

06 "<p>Spreadsheet is a small application that "

07 "demonstrates QAction, QMainWindow, QMenuBar, "

08 "QStatusBar, QTableWidget, QToolBar, and many other "

09 "Qt classes."));

10 }

Рис. 3.15. Справка о приложении Электронная таблица.

Диалоговое окно About получается путем вызова удобной статической функции QMessageBox::about(). Эта функция очень напоминает функцию QMessageBox::warning(), однако здесь вместо стандартных «предупреждающих» пиктограмм используется пиктограмма родительского окна.

Таким образом, мы уже сумели воспользоваться несколькими удобными статическими функциями, определенными в классах QMessageBox и QFileDialog. Эти функции создают диалоговое окно, инициализируют его и вызывают для него функцию exec(). Кроме того, вполне возможно, хотя и менее удобно, создать виджет QMessageBox или QFileDialog так же, как это делается для любого другого виджета, и явно вызвать для него функцию exec() или даже show().