До сих пор в представленных примерах мы полагались на поддержку QMimeData распространенных типов MIME. Так, мы вызывали QMimeData::setText() для создания объекта переноса текста и использовали QMimeData:urls() для получения содержимого объекта переноса типа text/uri-list. Если мы хотим перетаскивать обычный текст, текст в формате HTML, изображения, адреса URL или цвета, мы можем спокойно использовать класс QMimeData. Но если мы хотим перетаскивать пользовательские данные, необходимо сделать выбор между следующими альтернативами:
1. Мы можем обеспечить произвольные данные в виде массива QByteArray, используя функцию QMimeData::setData(), и извлекать их позже, используя функцию QMimeData::data().
2. Мы можем создать подкласс QMimeData и переопределить функции formats() и retrieveData() для обработки наших пользовательских типов данных.
3. Для выполнения операций механизма «drag-and-drop» в рамках одного приложения мы можем создать подкласс QMimeData и хранить данные в любых структурах данных.
Первый подход не требует никаких подклассов, но имеет некоторые недостатки: нам необходимо преобразбвать наши структуры данных в тип QByteArray, даже если переносимый объект не принимается, а если требуется обеспечить несколько MIME—типов, чтобы можно было хорошо взаимодействовать с самыми разными приложениями, нам придется сохранять несколько копий данных (по одной на каждый тип MIME). Если данные имеют большой размер, это может излишне замедлять работу приложения. При использовании второго и третьего подходов можно избежать или свести к минимуму эти проблемы. В этом случае мы получаем полное управление и можем использовать эти два подхода совместно.
Для демонстрации этих подходов мы покажем, как можно добавить возможности технологии «drag-and-drop» в виджет QTableWidget. Будет поддерживаться перенос следующих типов MIME: text/plain, text/html и text/csv. При применении первого подхода инициирование переноса выглядит следующим образом:
01 void MyTableWidget::mouseMoveEvent(QMouseEvent *event)
04 int distance = (event->pos() - startPos).manhattanLength();
05 if(distance >= QApplication::startDragDistance())
18 mimeData->setData("text/csv", toCsv(plainText).toUtf8());
21 if (drag->start(Qt::CopyAction | Qt::MoveAction) == Qt::MoveAction)
Закрытая функция startDrag() вызывается из mouseMoveEvent() для инициирования переноса выделенной прямоугольной области. Мы устанавливаем типы MIME text/plain и text/html, используя функции setText() и setHtml(), а тип text/csv мы устанавливаем функцией setData(), которая принимает произвольный тип MIME и массив QByteArray. Программный код для функции selectionAsString() более или менее совпадает с кодом функции Spreadsheet::copy(), рассмотренной в
01 QString MyTableWidget::toCsv(const QString &plainText)
12 QString MyTableWidget::toHtml(const QString &plainText)
| ");
17 result.prepend(" \n| ");
18 result.append("\n | ");
19 return result;
20 }
Функции toCsv() и toHtml() преобразуют строку со знаками табуляции и конца строки в формат CSV (comma—separated values — значения, разделенные запятыми) и HTML соответственно. Например, данные
Red Green Blue
Cyan Yellow Magenta
преобразуются в
"Red", "Green", "Blue"
"Cyan", "Yellow", "Magenta"
или в
| Red | Green | Blue
| | Cyan | Yellow | Magenta
|
Преобразование выполняется самым простым из возможных способов с применением функции QString::replace(). Для удаления специальных символов формата HTML мы используем функцию Qt::escape().
01 void MyTableWidget::dropEvent(QDropEvent *event)
02 {
03 if (event->mimeData()->hasFormat("text/csv")) {
04 QByteArray csvData = event->mimeData()->data("text/csv");
05 QString csvText = QString::fromUtf8(csvData);
06 …
07 event->acceptProposedAction();
08 } else if (event->mimeData()->hasFormat("text/plain")) {
09 QString plainText = event->mimeData()->text();
10 …
11 event->acceptProposedAction();
12 }
13 }
Хотя мы предоставляем данные в трех разных форматах, мы принимаем в dropEvent() только два из них. Если подьзователь переносит ячейки из таблицы QTableWidget в редактор HTML, нам нужно, чтобы ячейки были преобразованы в таблицу HTML. Но если пользователь переносит произвольный текст HTML в таблицу QTableWidget, мы не станем его принимать.
Для того чтобы этот пример заработал, нам потребуется также вызвать setAcceptDrops(true) и setSelectionMode(ContiguousSelection) в конструкторе MyTableWidget.
Теперь мы переделаем этот пример, но на этот раз мы создадим подкласс QMimeData, чтобы отложить или избежать (потенциально затратных) преобразований между элементами QTableWidgetltem и массивом QByteArray. Ниже приводится определение нашего подкласса:
01 class TableMimeData : public QMimeData
02 {
03 Q_OBJECT
04 public:
05 TableMimeData(const QTableWidget *tableWidget,
06 const QTableWidgetSelectionRange &range);
07 const QTableWidget *tableWidget() const
08 { return myTableWidget; }
09 QTableWidgetSelectionRange range() const { return myRange; }
10 QStringList formats() const;
11 protected:
12 QVariant retrieveData(const QString &format,
13 QVariant::Type preferredType) const;
14 private:
15 static QString toHtml(const QString &plainText);
16 static QString toCsv(const QString &plainText);
17 QString text(int row, int column) const;
18 QString rangeAsPlainText() const;
19 const QTableWidget *myTableWidget;
20 QTableWidgetSelectionRange myRange;
21 QStringList myFormats;
22 };
Вместо реальных данных мы храним объект QTableWidgetSelectionRange, который определяет область переносимых ячеек и сохраняет указатель на QTableWidget. Функции formats() и retrieveData() класса QMimeData переопределяются.
01 TableMimeData::TableMimeData(const QTableWidget *tableWidget,
02 const QTableWidgetSelectionRange &range)
03 {
04 myTableWidget = tableWidget;
05 myRange = range;
06 myFormats << "text/csv" << "text/html" << "text/plain";
07 }
В конструкторе мы инициализируем закрытые переменные.
01 QStringList TableMimeData::formats() const
02 {
03 return myFormats;
04 }
Функция formats() возвращает список MIME—типов, находящихся в объекте MIME—данных. Последовательность форматов обычно несущественна, однако на практике желательно первыми указывать «лучшие» форматы. Приложения, поддерживающие несколько форматов, иногда будут использовать первый подходящий.
01 QVariant TableMimeData::retrieveData(const QString &format,
02 QVariant::Type preferredType) const
03 {
04 if (format == "text/plain") {
05 return rangeAsPlainText();
06 } else if (format =="text/csv") {
07 return toCsv(rangeAsPlainText()); }
08 else if (format == "text/html") {
09 return toHtml(rangeAsPlainText());
10 } else {
11 return QMimeData::retrieveData(format, preferredType);
12 }
13 }
Функция retrieveData() возвращает данные для заданного MIME—типа в виде объекта QVariant. Параметр format обычно содержит одну из строк, возвращенных функцией formats(), однако нам не следует на это рассчитывать, поскольку не все приложения проверяют MIME—тип на соответствие форматам функции formats(). Предусмотренные в классе QMimeData функции получения данных text(), html(), urls(), imageData(), colorData() и data() реализуются с помощью функции retrieveData().
Параметр preferredType определяет тип, который следует поместить в объект QVariant. Здесь мы его игнорируем и рассчитываем на то, что QMimeData преобразует при необходимости возвращенное значение в требуемый тип.
01 void MyTableWidget::dropEvent(QDropEvent *event)
02 {
03 const TableMimeData *tableData =
04 qobject_cast(event->mimeData());
05 if (tableData) {
06 const QTableWidget *otherTable = tableData->tableWidget();
07 QTableWidgetSelectionRange otherRange = tableData->range();
08 …
09 event->acceptProposedAction();
10 } else if (event->mimeData()->hasFormat("text/csv")) {
11 QByteArray csvData = event->mimeData()->data("text/csv");
12 QString csvText = QString::fromUtf8(csVData);
13 …
14 event->acceptProposedAction();
15 } else if (event->mimeData()->hasFormat("text/plain")) {
16 QString plainText = event->mimeData()->text();
17 …
18 event->acceptProposedAction();
19 }
20 QTableWidget::mouseMoveEvent(event);
21 }
Функция dropEvent() аналогична функции с тем же названием, которую мы рассматривали ранее в данном разделе, но на этот раз мы ее оптимизируем, делая вначале проверку возможности приведения типа QMimeData в тип TableMimeData. Если qobject_cast() срабатывает, это значит, что перенос был инициирован виджетом MyTableWidget, расположенным в том же самом приложении, и мы можем получить непосредственный доступ к данным таблицы вместо того, чтобы пробираться сквозь программный интерфейс класса QMimeData. Если приведение типов оказывается неудачным, мы извлекаем данные стандартным способом.
В этом примере мы кодировали CSV—текст, используя кодировку UTF-8. Если бы мы хотели быть уверенными в применении правильной кодировки, мы могли бы использовать параметр charset в MIME—типе text/plain для явного задания типа кодировки. Ниже приводится несколько примеров:
text/plain; charset=US-ASCII
text/plain; charset=ISO-8859-1
text/plain; charset=Shift_JIS
text/plain; charset=UTF-8
Работа с буфером обмена
Большинство приложений тем или иным образом используют встроенные в Qt средства работы с буфером обмена. Например, класс QTextEdit обеспечивает поддержку слотов cut(), copy() и paste(), а также клавиш быстрого вызова команд, и поэтому дополнительное программирование почти (или совсем) не требуется.
При создании нами собственных классов мы можем осуществлять доступ к буферу обмена с помощью функции QApplication::clipboard(), которая возвращает указатель на объект приложения QClipboard. Обработка системного буфера обмена выполняется просто: вызывайте функции setText(), setImage() или setPixmap() для помещения данных в буфер обмена, и функции text(), image() или pixmap() для считывания данных из буфера обмена. Мы уже приводили примеры работы с буфером обмена в приложении Электронная таблица из .
Для некоторых приложений может оказаться недостаточно встроенных функциональных возможностей. Например, нам могут потребоваться данные, которые не являются просто текстом или изображением, или мы захотим обеспечить работу с многими различными форматами данных с целью достижения максимальной совместимости с другими приложениями. Эта проблема очень напоминает ту, с которой мы столкнулись при обеспечении механизма «drag-and-drop», и решение также будет аналогичным: мы можем создать подкласс QMimeData и переопределить несколько виртуальных функций.
Если наше приложение поддерживает механизм «drag-and-drop» через пользовательский подкласс QMimeData, мы можем просто повторно использовать пользовательский подкласс QMimeData и помещать его в буфер обмена, используя функцию setMimeData(). Для получения данных мы можем вызвать функцию mimeData() для буфера обмена.
В системе X11, как правило, можно вставлять выделенные объекты нажатием средней кнопки мышки, которая имеет три кнопки. Это делается путем применения отдельной «выделенной области» буфера обмена. Если вам нужно,чтобы ваш виджет поддерживал такую операцию буфера обмена вместе со стандартными операциями, вы должны передавать QClipboard::Selection в качестве дополнительного аргумента в различных вызовах операций буфера обмена. Например, ниже приводится возможная реализация функции mouseReleaseEvent() текстового редактора, поддерживающего вставку по нажатии средней кнопки мышки.
01 void MyTextEditor::mouseReleaseEvent(QMouseEvent *event)
02 {
03 QClipboard *clipboard = QApplication::clipboard();
04 if (event->button() == Qt::MidButton
05 && clipboard->supportsSelection()) {
06 QString text = clipboard->text(QClipboard::Selection);
07 pasteText(text);
08 }
09 }
В системе X11 функция supportsSelection() возвращает true. На других платформах она возврашает false.
Если мы хотим получать уведомления о каждом изменении содержимого буфера обмена, мы можем соединить сигнал QClipboard::dataChanged() с пользовательским слотом.
Глава 10. Классы отображения элементов
Многие приложения позволяют пользователям выполнять поиск, просмотр и редактирование отдельных элементов, принадлежащих набору данных. Эти данные могут храниться в файлах, в базе данных или на сетевом сервере. Обычно работа с подобными наборами данных осуществляется в Qt с использованием классов отображения элементов.
В ранних версиях Qt виджеты отображения элементов заполнялись содержимым всего набора данных; пользователи обычно выполняли необходимые операции по поиску и редактированию данных, находящихся в виджете, в какой-то момент сделанные изменения записывались обратно в источник данных. Хотя этот метод вполне понятен и прост в применении, он не совсем подходит для очень больших наборов данных и для ситуаций, когда требуется отображать одни и те же данные в двух или более разных виджетах.
В языке Smalltalk получил популярность гибкий подход к визуальному отображению больших наборов данных: модель—представление—контроллер (model—view—controller — MVC). В подходе MVC модель представляет набор данных и отвечает за обеспечение отображаемых данных и за запись всех изменений в источник данных. Каждый тип набора данных имеет свою собственную модель, однако предоставляемый моделью программный интерфейс отображения элементов одинаков для наборов данных любого типа. Представление отвечает за то, как данные отображаются для пользователя. При использовании любого большого набора данных только ограниченная область данных будет видима в любой момент времени, поэтому только эти данные будут запрашиваться представлением. Контроллер — это посредник между пользователем и представлением; он преобразует действия пользователя в запросы по просмотру или редактированию данных, которые представление по мере необходимости передает в модель.
Рис. 10.1. Архитектура модель/представление в Qt.
В Qt используется вдохновленная подходом MVC архитектура модель/представление. Здесь модель имеет такие же функции, как и в классическом методе MVC. Но вместо контроллера в Qt используется немного другое понятие: делегат (delegate). Делегат обеспечивает более тонкое управление воспроизведением и редактированием элементов. Для каждого типа представления в Qt предусмотрен делегат по умолчанию. Для большинства приложений вполне достаточно пользоваться таким делегатом, поэтому обычно нам не приходится заботиться о нем.
Применяя архитектуру Qt модель/представление, мы можем использовать модели, которые представляют только те данные, которые действительно необходимы для отображения в представлении. Это значительно повышает скорость обработки очень больших наборов данных и уменьшает потребности в памяти по сравнению с подходом, требующим считывания всех данных. Связывая одну модель с двумя или более представлениями, мы можем предоставить пользователю возможность за счет незначительных дополнительных издержек просматривать данные и взаимодействовать с ними различными способами. Qt автоматически синхронизирует множественные представления данных — изменения в одном из представлений отражаются во всех других. Дополнительное преимущество архитектуры модель/представление проявляется в том, что если мы решаем изменить способ хранения исходных данных, нам просто потребуется изменить модель; представления по-прежнему будут работать правильно.
Во многих случаях пользователю необходимо работать только с относительно небольшим количеством элементов. В такой ситуации, как правило, мы можем использовать удобные классы Qt по отображению элементов (QListWidget, QTableWidget и QTreeWidget), непосредственно заполняя все элементы значениями. Эти классы работают подобно классам отображения элементов в предыдущих версиях Qt. Они хранят свои данные в «элементах» (например, QTableWidget содержит элементы QTableWidgetltem). При реализации этих удобных классов используются пользовательские модели, обеспечивающие появление требуемых элементов в представлениях.
Рис. 10.2. Одна модель может обслуживать несколько представлений.
При использовании больших наборов данных часто оказывается недопустимым дублирование данных. В этих случаях мы можем применять классы Qt по отображению элементов (QListView, QTableView и QTreeView) в сочетании с моделью данных, которой может быть как пользовательская модель, так и одна из заранее определенных в Qt моделей. Например, если набор данных хранится в базе данных, мы можем использовать QTableView в сочетании с QSqlTableModel.
Применение удобных классов отображения элементов
Удобные Qt—подклассы отображения элементов обычно использовать проще, чем определять пользовательскую модель, и они особенно удобны, когда разделение модели и представления нам не дает преимущества. Мы использовали этот подход в , когда создавали подклассы QTableWidget и QTableWidgetItem для реализации функциональности электронной таблицы.
В данном разделе мы покажем, как можно применять удобные классы отображения элементов для вывода на экран элементов. В первом примере приводится используемый только для чтения виджет QListWidget, во втором примере — редактируемый QTableWidget и в третьем примере — используемый только для чтения QTreeWidget.
Мы начинаем с простого диалогового окна, которое позволяет пользователю выбрать из списка символ, используемый в блок-схемах программ. Каждый элемент состоит из пиктограммы, текста и уникального идентификатора.
Сначала покажем фрагмент заголовочного файла диалогового окна:
01 class FlowChartSymbolPicker : public QDialog {
02 Q_OBJECT
03 public:
04 FlowChartSymbolPicker(const QMap &symbolMap,
05 QWidget *parent = 0);
06 int selectedId() const { return id; }
07 void done(int result);
08 …
09 }
Рис. 10.3. Приложение Выбор символа блок—схемы (Flowchart Symbol Picker).
При создании диалогового окна мы должны передать его конструктору ассоциативный массив QMap, и после выполнения конструктора мы можем получить идентификатор выбранного элемента (или —1, если пользователь ничего не выбрал), вызывая selectedId().
01 FlowChartSymbolPicker::FlowChartSymbolPicker(
02 const QMap &symbolMap, QWidget *parent)
03 : QDialog(parent)
04 {
05 id = -1;
06 listWidget = new QListWidget;
07 listWidget->setIconSize(QSize(60, 60));
08 QMapIterator i(symbolMap);
09 while (i.hasNext()) {
10 i.next();
11 QListWidgetItem *item = new QListWidgetItem(i.value(),
12 listWidget);
13 item->setIcon(iconForSymbol(i.value()));
14 item->setData(Qt::UserRole, i.key());
15 …
16 }
17 }
Мы инициализируем id (идентификатор последнего выбранного элемента) значением —1. Затем мы конструируем QListWidget — удобный виджет отображения элементов. Мы проходим в цикле по всем элементам ассоциативного массива символов блок—схемы symbolMap и для каждого создаем объект QListWidgetItem. Конструктор QListWidgetItem принимает выводимую на экран строку QString и родительский виджет QListWidget.
Затем задаем пиктограмму элемента и вызываем setData() для сохранения в QListWidgetItem идентификатора элемента. Закрытая функция iconForSymbol() возвращает QIcon для заданного имени символа.
QListWidgetItem может выступать в разных ролях, каждой из которых соответствует определенный объект QVariant. Самыми распространенными ролями являются Qt::DisplayRole, Qt::EditRole и Qt::IconRole, и для них предусмотрены удобные функции по установке и получению их значений (setText(), setIcon()), но имеется также несколько других ролей. Кроме того, мы можем определить пользовательские роли, задавая числовое значение, равное или большее, чем Qt::UserRole. В нашем примере мы используем Qt::UserRole при сохранении идентификатора каждого элемента.
В непоказанной части конструктора создаются кнопки, выполняется компоновка виджетов и задается заголовок окна.
01 void FlowChartSymbolPicker::done(int result)
02 {
03 id = -1;
04 if (result == QDialog::Accepted) {
05 QListWidgetItem *item = listWidget->currentItem();
06 if (item)
07 id = item->data(Qt::UserRole).toInt();
08 }
09 QDialog::done(result);
10 }
Функция done() класса QDialog переопределяется. Она вызывается при нажатии пользователем кнопок ОК или Cancel. Если пользователь нажимает кнопку OK, мы получаем доступ к соответствующему элементу и извлекаем идентификатор, используя функцию data(). Если бы нас интересовал текст элемента, мы могли бы его получить с помощью вызова item->data(Qt::DisplayRole).toString() или более простого вызова item->text().
По умолчанию QListWidget используется только для чтения. Если бы мы хотели разрешить пользователю редактировать элементы, мы могли бы соответствующим образом установить переключатели редактирования представления, используя QAbstractItemView::setEditTriggers(), например QAbstractItemView::AnyKeyPressed означает, что пользователь может инициировать редактирование элемента, просто начав вводить символы с клавиатуры. Можно было бы поступить по-другому и предусмотреть кнопку редактирования Edit (и, возможно, кнопки добавления и удаления Add и Delete) и связать их со слотами, чтобы можно было программно управлять операциями редактирования.
Теперь, когда мы увидели, как можно использовать удобный класс отображения элементов для просмотра и выбора данных, мы рассмотрим пример, в котором можно редактировать данные. Мы снова используем диалоговое окно, представляющее на этот раз набор точек с координатами (x, у), которые может редактировать пользователь.
Рис. 10.4. Приложение Редактор координат.
Как и в предыдущем примере, мы основное внимание уделим программному коду, относящемуся к представлению элементов, и начнем с конструктора.
01 CoordinateSetter::CoordinateSetter(QList *coords,
02 QWidget *parent)
03 : QDialog(parent)
04 {
05 coordinates = coords;
06 tableWidget = new QTableWidget(0, 2);
07 tableWidget->setHorizontalHeaderLabels(
08 QStringList() << tr("X") << tr("Y"));
09 for (int row = 0; row < coordinates->count(); ++row) {
10 QPointF point = coordinates->at(row);
11 addRow();
12 tableWidget->item(row, 0)->setText(
13 QString::number(point.x()));
14 tableWidget->item(row, 1)->setText(
15 QString::number(point.y()));
16 }
17 …
18 }
Конструктор QTableWidget принимает начальное число строк и столбцов таблицы, выводимой на экран. Каждый элемент в QTableWidget представлен объектом QTableWidgetltem, включая элементы заголовков строк и столбцов. Функция setHorizontalHeaderLabels() задает заголовки всем столбцам, используя соответствующий текст из переданного списка строк. По умолчанию QTableWidget обеспечивает заголовки строк числовыми метками, начиная с 1; именно это нам и нужно, поэтому нам не приходится задавать вручную заголовки строк.
После создания и центровки заголовков столбцов мы в цикле просматриваем все переданные нам данные с координатами. Для каждой пары (x, у) мы создаем два элемента QTableWidgetItem, соответствующие координатам x и у. Эти элементы добавляются в таблицу, используя функцию QTableWidget::setItem(), в аргументах которой кроме самого элемента задаются его строка и столбец.
По умолчанию виджет QTableWidget разрешает редактирование. Пользователь может редактировать любую ячейку таблицы, установив на нее курсор и нажав F2 или просто вводя текст с клавиатуры. Все сделанные пользователем изменения автоматически сохранятся в элементах QTableWidgetltem. Запретить редактирование мы можем с помощью вызова setEditTriggers(QAbstractItemView::NoEditTriggers).
01 void CoordinateSetter::addRow()
02 {
03 int row = tableWidget->rowCount();
04 tableWidget->insertRow(row);
05 QTableWidgetltem *item0 = new QTableWidgetltem;
06 item0->setTextAlignment(Qt::AlignRight | Qt::AlignVCenter);
07 tableWidget->setItem(row, 0, item0);
08 QTableWidgetltem *item1 = new QTableWidgetltem;
09 item1->setTextAlignment(Qt::AlignRight | Qt::AlignVCenter);
10 tableWidget->setItem(row, 1, item1);
11 tableWidget->setCurrentItem(item0);
12 }
Слот addRow() вызывается, когда пользователь щелкает по кнопке Add Row (добавить строку). Мы добавляем в конец таблицы новую строку, используя insertRow(). Если пользователь попытается отредактировать какую-нибудь ячейку новой строки, QTableWidget автоматически создаст новый объект QTableWidgetItem.
01 void CoordinateSetter::done(int result)
02 {
03 if (result == QDialog::Accepted) {
04 coordinates->clear();
05 for (int row = 0; row < tableWidget->rowCount(); ++row) {
06 double x = tableWidget->item(row, 0)->text().toDouble();
07 double у = tableWidget->item(row, 1)->text().toDouble();
08 coordinates->append(QPointF(x, y));
09 }
10 }
11 QDialog::done(result);
12 }
Наконец, когда пользователь нажимает кнопку OK, мы очищаем координаты, переданные ранее в диалоговое окно, и создаем новый набор на основе координат в элементах виджета QTableWidget.
В качестве нашего третьего и последнего примера применения в Qt удобных виджетов отображения элементов мы рассмотрим некоторые фрагменты приложения, которое показывает параметры настройки Qt—приложения, используя QTreeWidget. Данный виджет по умолчанию используется только для чтения.
Рис. 10.5. Приложение Просмотр параметров настройки (Settings Viewer).
Ниже приводится фрагмент конструктора:
01 SettingsViewer::SettingsViewer(QWidget *parent)
02 : QDialog(parent)
03 {
04 organization = "Trolltech";
05 application = "Designer";
06 treeWidget = new QTreeWidget;
08 treeWidget->setColumnCount(2);
09 treeWidget->setHeaderLabels(
10 QStringList() << tr("Key") << tr("Value"));
11 treeWidget->header()->setResizeMode(0, QHeaderView::Stretch);
12 treeWidget->header()->setResizeMode(1, QHeaderView::Stretch);
13 …
14 setWindowTitle(tr("Settings Viewer"));
15 readSettings();
16 }
Для получения доступа к параметрам настройки приложения необходимо создать объект QSettings с указанием в параметрах названия организации и имени приложения. Мы устанавливаем значения по умолчанию (приложение «Designer» компании «Trolltech») и затем создаем новый объект QTreeWidget. В конце мы вызываем фyнкцию readSettings().
01 void SettingsViewer::readSettings()
02 {
03 QSettings settings(organization, application);
04 treeWidget->clear();
05 addChildSettings(settings, 0, "");
06 treeWidget->sortByColurnn(0);
07 treeWidget->setFocus();
08 setWindowTitle(tr("Settings Viewer - %1 by %2")
09 .arg(application).arg(organization));
10 }
Параметры настройки приложения хранятся в виде набора ключей и значений, имеющих иерархическую структуру. Закрытая функция addChildSettings() принимает объект параметров настройки, родительский элемент QTreeWidgetItem и текущую «группу». Группа в QSettings аналогична каталогу файловой системы. Функция addChildSettings() может вызывать себя рекурсивно для прохода по произвольной структуре типа дерева. При первом ее вызове из функции readSettings() передается 0, задавая корень в качестве родительского объекта.
01 void SettingsViewer::addChildSettings(QSettings &settings,
02 QTreeWidgetItem *parent, const QString &group)
03 {
04 QTreeWidgetItem *item;
05 settings.beginGroup(group);
06 foreach (QString key, settings.childKeys()) {
07 if (parent) {
08 item = new QTreeWidgetItem(parent);
09 } else {
10 item = new QTreeWidgetItem(treeWidget);
11 }
12 item->setText(0, key);
13 item->setText(1, settings.value(key).toString());
14 }
15 foreach (QString group, settings.childGroups()) {
16 if (parent) {
17 item = new QTreeWidgetItem(parent);
18 } else {
19 item = new QTreeWidgetItem(treeWidget);
20 }
21 item->setText(0, group);
21 addChildSettings(settings, item, group);
22 }
23 settings.endGroup();
24 }
Функция addChildSettings() используется для создания всех элементов QTreeWidgetItem. Она проходит по всем ключам текущего уровня в иерархии параметров настройки и для каждого ключа создает один объект QTableWidgetItem. Если в качестве родительского элемента задан 0, мы создаем дочерний элемент собственно виджета QTreeWidget (т.е. создается элемент верхнего уровня); в противном случае мы создаем дочерний элемент для объекта parent. В первый столбец записывается имя ключа, а во второй столбец — соответствующее ему значение.
Затем эта функция выполняется для каждой группы текущего уровня. Для каждой группы создается новый объект QTreeWidgetItem, причем в первый столбец записывается имя группы. Затем эта функция рекурсивно вызывает саму себя с указанием группового элемента в качестве родительского для заполнения виджета QTreeWidget дочерними элементами группы.
Показанные в данном разделе виджеты отображения элементов позволяют нам использовать стиль программирования, который очень похож на тот, который применялся в ранних версиях Qt: чтение всего набора данных в виджет отображения элементов с использованием объектов, представляющих отдельные элементы данных, и (если элементы допускают редактирование) их запись обратно в источник данных. В последующих разделах мы выйдем за рамки этого простого подхода и воспользуемся всеми преимуществами, которые дает архитектура Qt модель/представление.
Применение заранее определенных моделей
В Qt заранее определено несколько моделей, предназначенных для использования с классами представлений:
• QStringListModel — хранит список строк;
• QStandardltemModel — хранит данные произвольной иерархической структуры;
• QDirModel — формирует структуру локальной файловой системы;
• QSqlQueryModel — формирует набор результата SQL—запроса;
• QSqlTableModel — формирует SQL—таблицу;
• QSqlRelationalTableModel — формирует SQL—таблицу с внешними ключами (foreign keys);
• QSortFilterProxyModel — сортирует и/или пропускает через фильтр другую модель.
В данном разделе мы рассмотрим способы применения моделей QStringListModel, QDirModel и QSortFilterProxyModel. SQL—модели рассматриваются в .
Давайте начнем с простого диалогового окна, которое может применяться для добавления, удаления и редактирования списка строк QStringList, где каждая строка представляет лидера команды.
Ниже приводится соответствующий фрагмент конструктора:
01 TeamLeadersDialog::TeamLeadersDialog(const QStringList &leaders,
02 QWidget *parent)
03 : QDialog(parent)
04 {
05 model = new QStringListModel(this);
06 model->setStringList(leaders);
07 listView = new QListView;
08 listView->setModel(model);
09 listView->setEditTriggers(QAbstractItemView::AnyKeyPressed
10 | QAbstractItemView::DoubleClicked);
11 …
12 }
Рис. 10.6. Приложение Лидеры команд (Team Leaders).
Мы начнем с создания и заполнения модели QStringListModel. Затем создадим представление QListView и свяжем его с только что созданной моделью. Установим также некоторые переключатели редактирования, чтобы позволить пользователю редактировать строку, просто вводя символ или делая двойной щелчок. По умолчанию все переключатели редактирования сброшены для QListView, фактически делая это представление пригодным только для чтения.
01 void TeamLeadersDialog::insert()
02 {
03 int row = listView->currentIndex().row();
04 model->insertRows(row, 1);
05 QModelIndex index = model->index(row);
07 listView->setCurrentIndex(index);
08 listView->edit(index);
09 }
Когда пользователь нажимает на кнопку Insert (вставка), вызывается слот insert(). Этот слот начинает с получения номера строки текущего элемента в списке. Каждый элемент данных модели имеет соответствующий «индекс модели», представленный объектом QModelIndex. Мы подробно рассмотрим индексы модели в следующем разделе, а в данный момент нам достаточно знать, что индекс имеет три основных компонента: строку, столбец и указатель на модель, к которой он принадлежит. В модели одномерного списка столбец всегда равен 0.
Имея номер строки, мы вставляем одну новую строку в данную позицию. Вставка выполняется в модели, и модель автоматически обновляет списковое представление. Затем мы устанавливаем текущий индекс спискового представления на пустую строку, которую мы только что вставили. Наконец, мы устанавливаем в списковом представлении режим редактирования для новой строки, как будто пользователь нажал какую-нибудь клавишу клавиатуры или дважды щелкнул, чтобы начать редактирование.
01 void TeamLeadersDialog::del()
02 {
03 model->removeRows(listView->currentIndex().row(), 1);
04 }
В конструкторе сигнал clicked() кнопки Delete (удалить) связывается со слотом del(). Поскольку мы только что удалили текущую строку, мы можем вызвать removeRows() для текущей позиции индекса и для значения 1 счетчика строк. Как и при выполнении вставки, мы полагаемся на то, что модель должным образом обновит представление.
01 QStringList TeamLeadersDialog::leaders() const
02 {
03 return model->stringList();
04 }
Наконец, функция leaders() позволяет считывать отредактированные строки, когда диалоговое окно закрыто.
Создать TeamLeadersDialog можно было бы на основе универсального диалогового окна редактирования списка строк, просто параметризируя заголовок этого окна. Другое часто используемое пользователями универсальное диалоговое окно отображает список файлов или каталогов. В следующем примере применяется класс QDirModel, который моделирует файловую систему компьютера и позволяет показывать (или скрывать) различные атрибуты файлов. Эта модель может применять фильтр для ограничения типов элементов файловой системы при их выводе на экран и упорядочивать элементы различными способами.
Рис. 10.7. Приложение Просмотр каталога.
Мы начнем с создания и настройки модели и представления в конструкторе диалогового окна Просмотр каталога (Directory Viewer).
01 DirectoryViewer::DirectoryViewer(QWidget *parent)
02 : QDialog(parent)
03 {
04 model = new QDirModel;
05 model->setReadOnly(false);
06 model->setSorting(QDir::DirsFirst | QDir::IgnoreCase | QDir::Name);
07 treeView = new QTreeView;
08 treeView->setModel(model);
09 treeView->header()->setStretchLastSection(true);
10 treeView->header()->setSortIndicator(0, Qt::AscendingOrder);
11 treeView->header()->setSortIndicatorShown(true);
12 treeView->header()->setClickable(true);
13 QModelIndex index = model->index(QDir::currentPath());
14 treeView->expand(index);
15 treeView->scrollTo(index);
16 treeView->resizeColumnToContents(0);
17 …
18 }
После создания модели мы обеспечиваем возможность ее редактирования и устанавливаем различные начальные атрибуты упорядочивания. Затем мы создаем объект QTreeView для отображения на экране данных модели. Заголовок QTreeView может использоваться пользователем для управления сортировкой. Делая заголовок восприимчивым к щелчкам мышки, пользователь может сортирбвать данные по выбранному им в заголовке столбцу, причем повторные щелчки переключают направление сортировки, т.е сортировку по возрастанию на сортировку по убыванию и наоборот. После настройки заголовков представления данных в виде дерева мы получаем индекс модели текущего каталога и обеспечиваем просмотр содержимого этого каталога, раскрывая при необходимости его подкаталоги, используя expand(), и устанавливая изображение на его начало, используя scrollTo(). Затем мы обеспечиваем ширину первого столбца, достаточную для размещения всех элементов без вывода многоточия (…).
Во фрагменте конструктора, который здесь не показан, мы связываем кнопки Create Directory (создать каталог) и Remove (удалить) со слотами, выполняющими соответствующие действия. Нам не нужно иметь кнопку Rename (переименовать), поскольку пользователи могут переименовывать элементы каталога по месту, нажимая клавишу F2 и осуществляя ввод символов с клавиатуры.
01 voidDirectoryViewer::createDirectory()
02 {
03 QModelIndex index;
04 if (!index.isValid())
05 return;
06 QString dirName = QInputDialog::getText(this,
07 tr("Create Directory"), tr("Directory name"));
08 if (!dirName.isEmpty()) {
09 if (!model->mkdir(index,dirName).isValid())
10 QMessageBox::information(this,
11 tr("Create Directory"),
12 tr("Failed to create the directory"));
13 }
14 }
Если пользователь вводит имя каталога в диалоговом окне ввода, мы пытаемся создать в текущем каталоге подкаталог с этим именем. Функция QDirModel::mkdir() принимает индекс родительского каталога и имя нового каталога; она возвращает индекс модели созданного каталога. Если операция завершается неудачей, возвращается недействительный индекс модели.
Последний пример в этом разделе показывает, как следует применять модель QSortFilterProxyModel. В отличие от других заранее определенных моделей, эта модель использует какую-нибудь существующую модель и управляет данными, которые проходят между базовой моделью и представлением. В нашем примере базовой является модель QStringListModel, которая проинициализирована списком названий цветов, распознаваемых Qt (полученных функцией QColor::colorNames()). Пользователь может ввести строку фильтра в строке редактирования QLineEdit и указать ее тип (регулярное выражение, шаблон или фиксированная строка), используя поле с выпадающим списком.
Рис. 10.8. Приложение Названия цветов (ColorNames).
Ниже приводится фрагмент конструктора ColorNamesDialog:
01 ColorNamesDialog::ColorNamesDialog(QWidget *parent)
02 : QDialog(parent)
03 {
04 sourceModel = new QStringListModel(this);
05 sourceModel->setStringList(QColor::colorNames());
06 proxyModel = new QSortFilterProxyModel(this);
07 proxyModel->setSourceModel(sourceModel);
08 proxyModel->setFilterKeyColumn(0);
09 listView = new QListView;
10 listView->setModel(proxyModel);
11 syntaxComboBox = new QComboBox;
12 syntaxComboBox->addItem(tr("Regular expression"), QRegExp::RegExp);
13 syntaxComboBox->addItem(tr("Wildcard"), QRegExp::Wildcard);
14 syntaxComboBox->addItem(tr("Fixed string"), QRegExp::FixedString);
15 …
16 }
Модель QStringListModel создается и пополняется обычным образом. После этого создается модель QSortFilterProxyModel. Мы передаем базовую модель, используя функцию setSourceModel(), и указываем прокси на необходимость фильтрации по столбцу 0 базовой модеди. Функция QComboBox::addItem() принимает необязательный аргумент дополнительных данных типа QVariant; мы используем его для хранения значения QRegExp::PatternSyntax c текстом, определяющим тип фильтра данного элемента.
01 void ColorNamesDialog::reapplyFilter()
02 {
03 QRegExp::PatternSyntax syntax =
04 QRegExp::PatternSyntax(syntaxComboBox->itemData(
05 syntaxComboBox->currentIndex()).toInt());
06 QRegExp regExp(filterLineEdit->text(), Qt::CaseInsensitive, syntax);
07 proxyModel->setFilterRegExp(regExp);
08 }
Слот reapplyFilter() вызывается при всяком изменении пользователем строки фильтра или типа шаблона фильтрации в поле с выпадающим списком. Мы создаем объект QRegExp, используя текст в строке редактирования. Затем устанавливаем тип шаблона фильтрации на тот, который имеется в данных текущего элемента и отображается в соответствующем поле с выпадающим списком. Когда мы вызываем setFilterRegExp(), новый фильтр становится активным и автоматически обновляется представление данных.
Реализация пользовательских моделей
Заранее определенные в Qt модели предлагают удобные средства обработки и просмотра данных. Однако некоторые источники данных не могут эффективно использоваться для этих моделей, и в этих случаях необходимо создавать пользовательские модели, оптимизированные на применение таких источников данных.
Прежде чем перейти к созданию пользовательских моделей, давайте рассмотрим ключевые концепции архитектуры Qt модель/представление. В модели каждый элемент имеет индекс модели и набор атрибутов, называемых ролями, которые могут принимать произвольные значения. Ранее в данной главе мы видели, что наиболее распространенными ролями являются Qt::DisplayRole и Qt::EditRole. Другие роли используются для вспомогательных данных (например, Qt::ToolTipRole, Qt::StatusTipRole и Qt::WhatsThisRole) или для управления основными атрибутами отображения (например, Qt::FontRole, Qt::TextAlignmentRole, Qt::TextColorRole и Qt::BackgroundColorRole).
Рис. 10.9. Схематическое представление моделей Qt.
В модели списка можно пользоваться только одним индексным компонентом — номером строки, получить доступ к которому можно с помощью функции QModelIndex::row(). В модели таблицы используется два индексных компонента — номер строки и номер столбца, получить доступ к которым можно с помощью функции QModelIndex::row() и QModelIndex::column(). В моделях списка и таблицы родительский элемент всех остальных элементов является корневым элементом, который представдяется недействительным индексом модели QModelIndex. Представленные в данном разделе первые два примера показывают, как можно реализовать пользовательские модели таблиц.
Модель дерева подобна модели таблицы при следующих отличиях. Как и в модели таблицы, родительский элемент элементов верхнего уровня является корневым (имеет недействительный QModelIndex), однако родительский элемент любого другого элемента занимает другое место в иерархии элементов. Доступ к родительским элементам можно получить при помощи функции QModelIndex::parent(). Каждый элемент имеет свои ролевые данные и может иметь или не иметь дочерние элементы, каждый из которых является таким же элементом. Поскольку любой элемент может иметь дочерние элементы, такую структуру данных можно определить рекурсивно (в виде дерева), что будет продемонстрировано в последнем примере данного раздела.
В первом примере этого раздела представлена модель таблицы, используемой только для чтения; она показывает курсы различных валют относительно друг друга.
Рис. 10.10. Приложение Курсы валют (Currencies).
Это приложение можно было бы реализовать при помощи простой таблицы, но мы хотим использовать пользовательскую модель, чтобы можно было воспользоваться определенными свойствами данных для обеспечения минимального расхода памяти. Если бы мы хранили в таблице 162 валюты, действующие в настоящее время, нам бы потребовалось хранить 162 × 162 = 26 244 значения; в представленной ниже пользовательской модели необходимо хранить только 162 значения (значение каждой валюты относительно доллара США).
Класс CurrencyModel будет использоваться совместно со стандартным табличным представлением QTableView. Модель CurrencyModel пополняется элементами QMap; ключ каждого элемента представляет собой код валюты, а значение — курс валюты в долларах США. Ниже приводится фрагмент программного кода, показывающий, как пополняется ассоциативный массив QMap и как используется модель:
QMap currencyMap;
currencyMap.insert("AUD", 1.3259);
currencyMap.insert("CHF", 1.2970);
…
currencyMap.insert("SGD", 1.6901);
currencyMap.insert("USD", 1.0000);
CurrencyModel currencyModel;
currencyModel.setCurrencyMap(currencyMap);
QTableView tableView;
tableView.setModel(¤cyModel);
tableView.setAlternatingRowColors(true);
Теперь мы можем перейти к реализации модели, начиная с ее заголовка:
01 class CurrencyModel : public QAbstractTableModel
02 {
03 public:
04 CurrencyModel(QObject *parent = 0);
05 void setCurrencyMap(const QMap &map);
06 int rowCount(const QModelIndex &parent) const;
07 int columnCount(const QModelIndex &parent) const;
08 QVariant data(const QModelIndex &index, int role) const;
09 QVariant headerData(int section, Qt::Orientation orientation,
10 int role) const;
11 private:
12 QString currencyAt(int offset) const;
13 QMap currencyMap;
14 };
Для нашей модели мы использовали подкласс QAbstractTableModel, поскольку он лучше всего подходит к нашему источнику данных. Qt содержит несколько базовых классов моделей, включая QAbstractListModel, QAbstractTableModel и QAbstractItemModel. Класс QAbstractItemModel используется для поддержки разнообразных моделей, в том числе тех, которые построены на рекурсивных структурах данных, а классы QAbstractListModel и QAbstractTableModel удобно применять для одномерных и двумерных наборов данных.
Рис. 10.11. Дерево наследования для абстрактных классов моделей.
Для модели таблицы, используемой только для чтения, мы должны переопределить три функции: rowCount(), columnCount() и data(). В данном случае мы также переопределили функцию headerData() и обеспечили функцию инициализации данных (setCurrencyMap()).
01 CurrencyModel::CurrencyModel(QObject*parent)
02 : QAbstractTableModel(parent)
03 {
04 }
В конструкторе нам ничего не надо делать, кроме передачи базовому классу parent в качестве параметра.
01 int CurrencyModel::rowCount(const QModelIndex &
02 /* родительский элемент */) const
03 {
04 return currencyMap.count();
05 }
06 int CurrencyModel::columnCount(const QModelIndex &
07 /* родительский элемент */) const
08 {
09 return currencyMap.count();
10 }
В этой табличной модели счетчики строк и столбцов представляют собой номера валют в ассоциативном массиве валют. Параметр parent не имеет смысла в модели таблицы; он здесь указан, потому что rowCount() и columnCount() наследуются от более обобщенного базового класса QAbstractItemModel, поддерживающего иерархические структуры.
01 QVariant CurrencyModel::data(const QModelIndex &index, int role) const
02 {
03 if (!index.IsValid())
04 return QVariant();
05 if (role == Qt::TextAlignmentRole) {
06 return int(Qt::AlignRight | Qt::AlignVCenter);
07 } else if (role == Qt::DisplayRole) {
08 QString rowCurrency = currencyAt(index.row());
09 QString columnCurrency = currencyAt(index.column());
10 if (currencyMap.value(rowCurrency) == 0.0)
11 return "####";
12 double amount = currencyMap.value(columnCurrency)
13 / currencyMap.value(rowCurrency);
14 return QString("%1").arg(amount, 0, 'f', 4);
15 }
16 return QVariant();
17 }
Функция data() возвращает значение любой одной роли элемента. Элемент определяется индексом QModelIndex. В модели таблицы представляют интерес такие компоненты QModelIndex, как номер строки и номер столбца, получить доступ к которым можно с помощью функций row() и column().
Если используется роль Qt::TextAlignmentRole, мы возвращаем значение, подходящее для выравнивания чисел. Если используется роль Qt::DisplayRole, мы находим значение каждой валюты и вычисляем курс обмена.
Мы могли бы возвращать рассчитанное значение типа double, но тогда нам пришлось бы контролировать количество позиций после десятичной точки при отображении числа (если мы не используем пользовательский делегат). Вместо этого мы возвращаем значение в виде строки, отформатированной нужным нам образом.
01 QVariant CurrencyModel::headerData(int section,
02 Qt::Orientation /* ориентация */, int role) const
03 {
04 if (role != Qt::DisplayRole)
05 return QVariant();
06 return currencyAt(section);
07 }
Функция headerData() вызывается представлением для пополнения своих горизонтальных и вертикальных заголовков. Параметр section содержит номер строки или столбца (в зависимости от ориентации). Поскольку строки и столбцы содержат одинаковые коды валют, нам не надо заботиться об ориентации, а просто вернуть код валюты для заданного значения section.
01 void CurrencyModel::setCurrencyMap(const QMap &map)
02 {
03 currencyMap = map;
04 reset();
05 }
Вызывающая программа может изменить набор валют, используя функцию setCurrencyMap(). Вызов QAbstractItemModel::reset() указывает любому представлению, что все данные в используемой модели недействительны; это вынуждает их запросить свежие данные для тех элементов, которые видны на экране.
01 QString CurrencyModel::currencyAt(int offset) const
02 {
03 return (currencyMap.begin() + offset).key();
04 }
Функция currencyAt() возвращает ключ (код валюты), который находится по указанному смещению в ассоциативном массиве валют. Мы используем итератор в стиле STL для поиска элемента и вызываем для него функцию key().
Как мы только что могли убедиться, нетрудно создавать модели, используемые только для чтения, и при определенном характере исходных данных в хорошо спроектированной модели в принципе можно сэкономить память и увеличить быстродействие. В следующем примере приложения Города (Cities) также используется табличная модель, но на этот раз все данные вводятся пользователем.
Это приложение используется для хранения расстояний между любыми двумя городами. Как и в предыдущем примере, мы могли бы просто использовать табличный виджет QTableWidget и хранить один элемент для каждой пары городов. Однако пользовательская модель могла бы быть более эффективной, потому что расстояние от любого города А до любого другого города В не зависит от того, будем ли мы путешествовать от А до В или от В до А, поэтому элементы с одной стороны от главной диагонали получаются путем зеркального отражения другой.
Для сравнения пользовательской модели с простой таблицей предположим, что у нас имеется три города: А, В и С. Для обеспечения всех сочетаний нам пришлось бы хранить девять значений. В аккуратно спроектированной модели потребовалось бы только три элемента: (А, В), (A, С) и (В, С).
Рис. 10.12. Приложение Города.
Ниже показано, как мы настраиваем и используем модель:
QStringList cities;
cities << "Arvika" << "Boden" << "Eskilstuna" << "Falun"
<< "Filipstad" << "Halmstad" << "Helsingborg" << "Karlstad"
<< "Kiruna" << "Kramfors" << "Motala" << "Sandviken"
<< "Skara" << "Stockholm" << "Sundsvall" << "Trelleborg";
CityModel CityModel;
cityModel.setCities(cities);
QTableView tableView;
tableView.setModel(&cityModel);
tableView.setAlternatingRowColors(true);
Мы должны переопределить те же самые функции, которые мы переопределяли в предыдущем примере. Кроме того, для обеспечения возможности редактирования модели мы должны переопределить setData() и flags(). Ниже приводится определение класса:
01 class CityModel : public QAbstractTableModel
02 {
03 Q_OBJECT
04 public:
05 CityModel(QObject *parent = 0);
06 void setCities(const QStringList &cityNames);
07 int rowCount(const QModelIndex &parent) const;
08 int columnCount(const QModelIndex &parent) const;
09 QVariant data(const QModelIndex &index, int role) const;
10 bool setData(const QModelIndex &index, const QVariant &value,
11 int role);
12 QVariant headerData(int section, Qt::Orientation orientation,
13 int role) const;
14 Qt::ItemFlags flags(const QModelIndex &index) const;
15 private:
16 int offsetOf(int row, int column) const;
17 QStringList cities;
18 QVector distanсes;
19 };
В этой модели мы используем две структуры данных: cities типа QStringList для хранения названий городов, и distances типа QVector для хранения расстояний между городами каждой уникальной пары.
01 CityModel::CityModel(QObject *parent)
02 : QAbstractTableModel(parent)
03 {
04 }
Конструктор передает параметр parent базовому классу и больше ничего не делает.
01 int CityModel::rowCount(const QModelIndex &
02 /* родительский элемент */) const
03 {
04 return cities.count();
05 }
06 int CityModel::columnCount(const QModelIndex &
07 /* родительский элемент */) const
08 {
09 return cities.count();
10 }
Поскольку мы имеем квадратную матрицу городов, количество строк и столбцов равно количеству городов в нашем списке.
01 QVariant CityModel::data(const QModelIndex &index, int role) const
02 {
03 if (!index.isValid())
04 return QVariant();
05 if (role == Qt::TextAlignmentRole) {
06 return int(Qt::AlignRight | Qt::AlignVCenter);
07 } else if (role == Qt::DisplayRole) {
08 if (index.row() == index.column())
09 return 0;
10 int offset = offsetOf(index.row(), index.column());
11 return distances[offset];
12 }
13 return QVariant();
14 }
Функция data() аналогична той же функции в нашей модели CurrencyModel. Она возвращает 0, если строка и столбец имеют одинаковый номер, потому что в этом случае два города одинаковы; в противном случае она находит в векторе distances элемент для заданной строки и заданного столбца, возвращая расстояние для этой конкретной пары городов.
01 QVariant CityModel::headerData(int section,
02 Qt::Orientation /* ориентация */,
03 int role) const
04 {
05 if (role == Qt::DisplayRole)
06 return cities[section];
07 return QVariant();
08 }
Функция headerData() имеет простой вид, потому что наша таблица является квадратной матрицей, в которой строки и столбцы имеют идентичные заголовки. Мы просто возвращаем название города, расположенное с заданным смещением в списке строк cities.
01 bool CityModel::setData(const QModelIndex &index,
02 const QVariant &value, int role)
03 {
04 if (index.isValid() && index.row() != index.column()
05 && role == Qt::EditRole) {
06 int offset = offsetOf(index.row(), index.column());
07 distances[offset] = value.toInt();
08 QModelIndex transposedIndex = createIndex(
09 index.column(), index.row());
10 emit dataChanged(index, index);
11 emit dataChanged(transposedIndex, transposedIndex);
12 return true;
13 }
14 return false;
15 }
Функция setData() вызывается при редактировании элемента пользователем. Если индекс модели действителен, два города различны и модифицируемый элемент данных имеет ролевой атрибут Qt::EditRole, эта функция сохраняет введенное пользователем значение в векторе distances.
Функция createIndex() используется для формирования индекса модели. Она нужна для получения индекса модели элемента, который расположен по другую сторону от главной диагонали и который соответствует элементу с установленным значением, поскольку оба элемента должны показывать одинаковые данные. Функция createIndex() принимает сначала строку и затем столбец; здесь мы передаем параметры в обратном порядке, чтобы получить индекс модели элемента, расположенного по другую строну диагонали напротив элемента, определенного индексом index.
Мы генерируем сигнал dataChanged() с указанием индекса модели элемента, который изменился. Эта функция принимает два индекса модели, поскольку возможна ситуация, когда изменения относятся к некоторой прямоугольной области, охватывающей несколько строк и столбцов, поэтому передаются индекс верхнего левого угла и индекс нижнего правого угла этой области. Генерируем также сигнал dataChanged() для индекса противоположного элемента, чтобы представление обновило его отображение на экране. Наконец, мы возвращаем true или false, указывая на успешность или неуспешность редактирования.
01 Qt::ItemFiags CityModel::flags(const QModelIndex &index) const
02 {
03 Qt::ItemFlags flags = QAbstractItemModel::flags(index);
04 if (index.row() != index.column())
05 flags |= Qt::ItemIsEditable;
06 return flags;
07 }
Функция flags() используется моделью для того, чтобы можно было сообщить о допустимых действиях с элементом (например, допускает ли он редактирование). По умолчанию эта функция для модели QAbstractTableModel возвращает Qt::ItemIsSelectable | Qt::ItemIsEnabled. Мы добавляем флажок Qt::ItemIsEditable для всех элементов, кроме расположенных по диагонали (которые всегда равны 0).
01 void CityModel::setCities(const QStringList &cityNames)
02 {
03 cities = cityNames;
04 distances.resize(cities.count() * (cities.count() - 1) / 2);
05 distances.fill(0);
06 reset();
07 }
Если задан новый список городов, мы устанавливаем закрытую переменную типа QStringList на новый список, изменяем размеры и очищаем вектор расстояний, а затем вызываем функцию QAbstractItemModel::reset(), чтобы уведомить все представления о необходимости обновления всех видимых элементов.
01 int CityModel::offsetOf(int row, int column) const
02 {
03 if (row < column)
04 qSwap(row, column);
05 return (row * (row - 1) / 2) + column;
06 }
Закрытая функция offsetOf() вычисляет индекс заданной пары городов для вектора расстояний distances. Например, предположим, что мы имеем города А, В, С и D, и пользователь обновляет элемент со строкой 3 и столбцом 1, т. е. (B, D). Тогда индекс вектора расстояний будет равен 3 × (3 — 1) / 2 + 1 = 4. Если бы пользователь вместо этого изменил элемент со строкой 1 и столбцом 3, т.е. (D, В), благодаря применению функции qSwap(), выполнялись бы точно такие же вычисления и возвращалось бы то же самое значение.
Рис. 10.13. Структуры данных cities и distances и табличная модель.
Последний пример в данном разделе представляет собой модель, которая показывает дерево грамматического разбора заданного регулярного выражения. Регулярное выражение состоит из одного или нескольких термов, разделяемых символами '|'. Так, регулярное выражение «alpha|bravo|charlie» содержит три терма. Каждый терм представляет собой последовательность из одного или нескольких факторов: например, терм «bravo» состоит из пяти факторов (каждая буква является фактором). Факторы могут состоять из атома и необязательного квантификатора (quantifier), например '*', '+' и '?'. Поскольку регулярные выражения могут иметь подвыражения, заключенные в скобки, они могут быть представлены рекурсивными деревьями грамматического разбора.
Регулярное выражение, показанное на рис. 10.14, «ab|(cd)?e» означает, что за 'a' следует 'b' или допускается два варианта: за 'c' идет 'd' и затем 'e' или просто имеется 'e'. Поэтому подойдут строки «ab» и «cde», но не подойдут строки «bc» или «cd».
Рис. 10.14. Приложение Парсер регулярных выражений.
Приложение Парсер регулярных выражений (Regexp Parser) состоит из четырех классов:
• RegExpWindow — окно, которое позволяет пользователю вводить регулярное выражение и показывает соответствующее дерево грамматического разбора;
• RegExpParser формирует дерево грамматического разбора для заданного регулярного выражения;
• RegExpModel — модель дерева, используемая деревом грамматического разбора;
• Node (вершина) представляет один элемент в дереве грамматического разбора.
Давайте начнем с класса Node:
01 class Node {
02 public:
03 enum Type { RegExp, Expression, Term, Factor, Atom, Terminal };
04 Node(Type type, const QString &str = "");
05 ~Node();
06 Type type;
07 QString str;
08 Node *parent;
09 QList children;
10 };
Каждая вершина имеет тип, строку (которая может быть пустой), ссылку на родительский элемент (которая может быть нулевой) и список дочерних вершин (который может быть пустым).
01 Node::Node(Type type, const QString &str)
02 {
03 this->type = type;
04 this->str = str;
05 parent = 0;
06 }
Конструктор просто инициализирует тип и строку вершины. Поскольку все данные открыты, в программном коде, использующим Node, можно непосредственно манипулировать типом, строкой, родительским элементом и дочерними элементами.
01 Node::~Node()
02 {
03 qDeleteAll(children);
04 }
Функция qDeleteAll() проходит no всем указателям контейнера и вызывает оператор delete для каждого из них. Она не устанавливает указатели в 0, поэтому, если она используется вне деструктора, обычно за ней следует вызов функции clear() для контейнера, содержащего указатели.
Теперь, когда мы определили элементы наших данных (представленные вершиной Node), мы готовы создать модель:
01 class RegExpModel : public QAbstractItemModel
02 {
03 public:
04 RegExpModel(QObject *parent = 0);
05 ~RegExpModel();
06 void setRootNode(Node *node);
07 QModelIndex index(int row, int column,
08 const QModelIndex &parent) const;
09 QModelIndex parent(const QModelIndex &child) const;
10 int rowCount(const QModelIndex &parent) const;
11 int columnCount(const QModelIndex &parent) const;
12 QVariant data(const QModelIndex &index, int role) const;
13 QVariant headerData(int section,
14 Qt::Orientation Orientation, int role) const;
15 private:
16 Node *nodeFromIndex(const QModelIndex &index) const;
17 Node *rootNode;
18 };
На этот раз мы построили подкласс на основе класса QAbstractItemModel, а не на основе его удобного подкласса QAbstractTableModel, потому что мы хотим создать иерархическую модель. Нам необходимо переопределить те же самые функции и, кроме того, требуется реализовать функции index() и parent(). Для установки данных модели предусмотрена функция setRootNode(), при вызове которой должна задаваться корневая вершина дерева грамматического разбора.
01 RegExpModel::RegExpModel(QObject *parent)
02 : QAbstractItemModel(parent)
03 {
04 rootNode = 0;
05 }
В конструкторе модели нам надо просто задать корневой вершине безопасное нулевое значение и передать указатель parent базовому классу.
01 RegExpModel::~RegExpModel()
02 {
03 delete rootNode;
04 }
В деструкторе мы удаляем корневую вершину. Если корневая вершина имеет дочерние вершины, то каждая из них удаляется и эта процедура повторяется рекурсивно деструктором Node.
01 void RegExpModel::setRootNode(Node *node)
02 {
03 delete rootNode;
04 rootNode = node;
05 reset();
06 }
При установке новой корневой вершины мы начинаем с удаления предыдущей корневой вершины (и всех ее дочерних вершин). Затем мы устанавливаем новое значение для корневой вершины и вызываем функцию reset() для уведомления всех представлений о необходимости обновления отображаемых данных всеми видимыми элементами.
01 QModelIndex RegExpModel::index(int row, int column,
02 const QModelIndex &parent) const
03 {
04 if (!rootNode)
05 return QModelIndex();
06 Node *parentNode = nodeFromIndex(parent);
07 return createIndex(row, column, parentNode->children[row]);
08 }
Функция index() класса QAbstractItemModel переопределяется. Она всегда вызывается, когда в модели или в представлении требуется создать индекс QModelIndex для конкретного дочернего элемента (или для элемента самого верхнего уровня, если parent имеет недействительное значение QModelIndex). В табличных и списковых моделях нам не требуется переопределять эту функцию, потому что обычно оказываются достаточным реализации по умолчанию моделей QAbstractListModel и QАЬstractTableModel.
В нашей реализации index(), если не задано дерево грамматического разбора, мы возвращаем недействительный индекс QModelIndex. В противном случае мы создаем QModelIndex с заданными строкой, столбцом и Node * для запрошенного дочернего элемента. В иерархических моделях знание строки и столбца элемента относительно своего родителя оказывается недостаточным для уникальной идентификации элемента; мы должны также знать, кто является его родителем. Для этого можно хранить в QModelIndex указатель на внутреннюю вершину. В объекте QModelIndex кроме номеров строк и столбцов допускается хранение указателя void * или значения типа int.
Указатель Node * на дочерний элемент можно получить из списка дочерних элементов children родительской вершины. Указатель на родительскую вершину извлекается из индекса модели parent, используя закрытую функцию nodeFromIndex():
01 Node *RegExpModel::nodeFromIndex(
02 const QModelIndex &index) const
03 {
04 if (index.isValid()) {
05 return static_cast(index.internalPointer());
06 } else {
07 return rootNode;
07 }
Функция nodeFromIndex() приводит тип void * заданного индекса в тип Node * или возвращает указатель на корневую вершину, если индекс недостоверен, поскольку недостоверный индекс модели используется для представления корня модели.
01 int RegExpModel::rowCount(const QModelIndex
02 &parent) const
03 {
04 Node *parentNode = nodeFromlndex(parent);
05 if (!parentNode)
06 return 0;
07 return parentNode->children.count();
08 }
Число строк для заданного элемента определяется просто количеством дочерних элементов.
01 int RegExpModel::columnCount(const QModelIndex &
02 /* родительский элемент */) const
03 {
04 return 2;
05 }
Число столбцов фиксировано и равно 2. Первый столбец содержит типы вершин; второй столбец содержит значения вершин.
01 QModelIndex RegExpModel::parent(const QModelIndex
02 &child) const
03 {
04 Node*node = nodeFromIndex(child);
05 if (!node)
06 return QModelIndex();
07 Node *parentNode = node->parent;
08 if (!parentNode)
09 return QModelIndex();
10 Node *grandparentNode = parentNode->parent;
11 if (!grandparentNode)
12 return QModelIndex();
13 int row = grandparentNode->children.indexOf(parentNode);
14 return createIndex(row, child.column(), parentNode);
15 }
Получить QModelIndex родительского элемента из дочернего немного сложнее, чем найти дочерний элемент родителя. Можно легко получить родительскую вершину, применяя сначала функцию nodeFromIndex() и поднимаясь затем вверх с помощью указателя на родительский элемент, но для получения номера строки (позиции родительской верщины в соответствующем списке дочерних вершин) мы должны перейти к родителю родительского элемента и найти в его списке дочерних элементов значение индекса первого родителя (родителя исходной дочерней вершины).
01 QVariant RegExpModel::data(const QModelIndex
02 &index, int role) const
03 {
04 if (role != Qt::DisplayRole)
05 return QVariant();
06 Node *node = nodeFromIndex(index);
07 if (!node)
08 return QVariant();
09 if (index.column() == 0) {
10 switch (node->type) {
11 case Node::RegExp:
12 return tr("RegExp");
13 case Node::Expression:
14 return tr("Expression");
15 case Node::Term:
16 return tr("Term");
17 case Node::Factor:
18 return tr("Factor");
19 case Node::Atom:
20 return tr("Atom");
21 case Node::Terminal:
22 return tr("Terminal");
23 default:
24 return tr("Unknown");
25 }
26 } else if (index.column() == 1) {
27 return node->str;
28 }
29 return QVariant();
30 }
В функции data() получаем для запрошенного элемента указатель Node * и используем его для получения доступа к данным соответствующей вершины. Если вызывающая программа запрашивает какую-нибудь роль, отличную от Qt::DisplayRole, или если не удается получить вершину Node для заданного индекса модели, мы возвращаем недействительное значение типа QVariant. Если столбец равен 0, возвращаем название типа вершины; если столбец равен 1, вбзвращаем значение вершины (ее строку).
01 QVariant RegExpModel::headerData(int section,
02 Qt::Orientation orientation, int role) const
03 {
04 if (orientation == Qt::Horizontal && role == Qt::DisplayRole) {
05 if (section == 0) {
06 return tr("Node");
07 else if (section == 1) {
08 return tr("Value");
09 }
10 }
11 return QVariant();
12 }
При переопределении функции headerData() мы возвращаем соответствующие метки горизонтального заголовка. Класс QTreeView, который используется для визуального представления иерархических моделей, не имеет заголовков строк, поэтому мы их игнорируем.
Теперь, когда рассмотрены классы Node и RegExpModel, давайте посмотрим, как создается корневая вершина, когда пользователь изменяет текст в строке редактирования.
01 void RegExpWindow::regExpChanged(const QString®Exp)
02 {
03 RegExpParser parser;
04 Node *rootNode = parser.parse(regExp);
05 regExpModel->setRootNode(rootNode);
06 }
При изменении пользователем текста в строке редактирования вызывается слот главного окна regExpChanged(). В этом слоте выполняется синтаксический анализ введенного пользователем текста, и парсер возвращает указатель на корневую вершину дерева грамматического разбора.
Мы не показываем класс RegExpParser, потому что он не имеет отношения к графическому интерфейсу или программированию модели/представления. Полный исходный код для этого примера находится на компакт-диске.
В данном разделе мы увидели, как можно создавать три различные пользовательские модели. Многие модели значительно проще приведенных выше и обеспечивают соответствие один к одному между элементами и индексами модели. В самой системе Qt находятся дополнительные примеры применения архитектуры модель/представление вместе с подробной документацией.
Реализация пользовательских делегатов
Воспроизведение и редактирование в представлениях отдельных элементов выполняются с помощью делегатов. В большинстве случаев возможности делегата, предоставляемого представлением по умолчанию, оказываются достаточными. Если нам требуется более тонкое управление воспроизведением элементов, мы сможем этого добиться, просто используя пользовательскую модель: при переопределении функции data() можем предусмотреть обработку ролей Qt::FontRole, Qt::TextAlignmentRole, Qt::TextColorRole и Qt::BackgroundColorRole, а также тех, которые используются делегатом по умолчанию. Например, в приведенных выше приложениях Города и Курсы валют мы применяли Qt::TextAlignmentRole для выравнивания чисел вправо.
Если нам требуется еще больший контроль, можем создать наш собственный класс делегата и связать его с нужными нам представлениями. В показанном ниже диалоговом окне Редактор фонограмм (Track Editor) используется пользовательский делегат. В этом окне отображаются названия музыкальных фонограмм и их длительность. Данные в модели будут представлены просто строками QString (названия) и значениями типа int (секунды), однако длительность будет разбита на минуты и секунды, а ее редактирование будет выполняться, используя QTimeEdit.
Рис. 10.15. Приложение Редактор фонограмм.
Диалоговое окно Редактор фонограмм использует QTableWidget — удобный подкласс отображения элементов, который работает с объектами QTableWidgetltem. Данные представлены в виде списка фонограмм Track:
01 class Track
02 {
03 public:
04 Track(const QString &title = "", int duration = 0);
05 QString title;
06 int duration;
07 };
Ниже приводится фрагмент конструктора, показывающий, как создается и пополняется табличный виджет:
01 TrackEditor::TrackEditor(QList
02 : QDialog(parent)
03 {
04 this->tracks = tracks;
05 tableWidget = new QTableWidget(tracks->count(), 2);
06 tableWidget->setItemDelegate(new TrackDelegate(1));
07 tableWidget->setHorizontalHeaderLabels(
08 QStringList() << tr("Track") << tr("Duration"));
09 for (int row = 0; row < tracks->count(); ++row) {
10 Track track = tracks->at(row);
11 QTableWidgetltem *item0 = new QTableWidgetItem(track.titie);
12 tableWidget->setItem(row, 0, item0);
13 QTableWidgetltem *item1 = new QTableWidgetItem(
14 QString::number(track.duration));
15 item1->setTextAlignment(Qt::AlignRight);
16 tableWidget->setItem(row, 1, item1);
17 }
18 …
19 }
Конструктор создает табличный виджет и, вместо того чтобы просто использовать делегата по умолчанию, связывает виджет с нашим пользовательским делегатом TrackDelegate, передавая ему номер столбца, содержащего временные данные. Мы начинаем с установки заголовков столбцов и затем проходим в цикле по всем данным, устанавливая для каждой строки название фонограммы и ее длительность.
В остальной части конструктора и диалогового окна TrackEditor нет ничего необычного, поэтому теперь рассмотрим класс trackDelegate, который обеспечивает воспроизведение и редактирование данных фонограммы.
01 class TrackDelegate : public QItemDelegate
02 {
03 Q_OBJECT
04 public:
05 TrackDelegate(int durationColumn, QObject *parent = 0);
06 void paint(QPainter *painter, const
07 QStyleOptionViewItem &option,
08 const QModelIndex &index) const;
09 QWidget *createEditor(QWidget *parent,
10 const QStyleOptionViewItem &option,
11 const QModelIndex &index) const;
12 void setEditorData(QWidget *editor,
13 const QModelIndex &index) const;
14 void setModelData(QWidget *editor,
15 QAbstractItemModel *model,
16 const QModelIndex &index) const;
17 private slots:
18 void commitAndCloseEditor();
19 private:
20 int durationColumn;
21 };
Мы используем QItemDelegate в качестве нашего базового класса, чтобы можно было воспользоваться возможностями делегата по умолчанию. Так же мы могли бы использовать QAbstractItemDelegate, если бы хотели начать с чистого листа. Для обеспечения в делегате возможности редактирования данных мы должны реализовать функции createEditor(), setEditorData() и setModelData(). Кроме того, реализуем функцию paint() для изменения отображения столбца длительностей.
01 TrackDelegate::TrackDelegate(int durationColumn, QObject *parent)
02 : QItemDelegate(parent)
03 {
04 this->durationColumn = durationColumn;
05 }
Параметр конструктора durationColumn указывает делегату, какой номер столбца содержит длительность фонограммы.
01 void TrackDelegate::paint(QPainter *painter,
02 const QStyleOptionViewItem &option,
03 const QModelIndex &index) const
04 {
05 if (index.column() == durationColumn) {
06 int secs = index.model()->data(index, Qt::DisplayRole).toInt();
07 QString text= QString("%1:%2")
08 .arg(secs/60, 2, 10, QChar('0'))
09 .arg(secs % 60, 2, 10, QChar('0'));
10 QStyleOptionViewItem myOption = option;
11 myOption.displayAlignment = Qt::AlignRight | Qt::AlignVCenter;
12 drawDisplay(painter, myOption, myOption.rect, text);
13 drawFocus(painter, myOption, myOption.rect);
14 } else {
15 QItemDelegate::paint(painter, option, index);
16 }
17 }
Поскольку мы собираемся отображать длительность в виде «минуты : секунды», мы переопределили функцию paint(). Вызов arg() принимает целое число, выводимое в виде строки, допустимое количество символов в строке, основание целого числа (10 для десятичного числа) и символ—заполнитель.
Для выравнивания текста вправо копируем текущие опции стиля и заменяем установленное по умолчанию выравнивание. После этого вызываем QItemDelegate::drawDisplay() для вывода текста, затем вызываем QItemDelegate::drawFocus() для прорисовки фокусного прямоугольника в том случае, если данный элемент получил фокус, и ничего не делая в противном случае. Функцией drawDisplay() очень удобно пользоваться, особенно совместно с нашими собственными опциями стиля. Мы могли бы также рисовать, используя рисовальщик непосредственно.
01 QWidget *TrackDelegate::createEditor(QWidget *parent,
02 const QStyleOptionViewItem &option,
03 const QModelIndex &index) const
04 {
05 if (index.column() == durationColumn) {
06 QTimeEdit *timeEdit = new QTimeEdit(parent);
07 timeEdit->setDisplayFormat("mm:ss");
08 connect(timeEdit, SIGNAL(editingFinished()),
09 this, SLOT(commitAndCloseEditor()));
10 return timeEdit;
11 } else {
12 return QItemDelegate::createEditor(parent, option, index);
13 }
14 }
Мы собираемся управлять редактированием только длительностей фонограмм, предоставляя делегату по умолчанию управление редактированием названий фонограмм. Это обеспечивается проверкой столбца, для которого запрашивается редактирование. Если это столбец длительности, создаем объект QTimeEdit, устанавливаем соответствующий формат отображения и соединяем его сигнал editingFinished() с нашим слотом commitAndCloseEditor(). Для других столбцов передаем управление редактированием делегату по умолчанию.
01 void TrackDelegate::commitAndCloseEditor()
02 {
03 QTimeEdit *editor = qobject_cast(sender());
04 emit commitData(editor);
05 emit closeEditor(editor);
06 }
Если пользователь нажимает клавишу Enter или убирает фокус из QTimeEdit (но не путем нажатия клавиши Esc), генерируется сигнал editingFinished() и вызывается слот commitAndCloseEditor(). Этот слот генерирует сигнал commitData() для уведомления представления о том, что имеются новые данные для замены существующих. Он также генерирует сигнал closeEditor() для уведомления представления о том, что редактор больше не нужен, и модель его удалит. Получить доступ к редактоpy можно с помощью функции QObject::sender(), которая возвращает объект, выдавший сигнал, запустивший данный слот. Если пользователь отказывается от работы с редактором (нажимая клавишу Esc), представление просто удалит этот редактор.
01 void TrackDeIegate::setEditorData(QWidget *editor,
02 const QModelindex &index) const
03 {
04 if (index.column() == durationColumn) {
05 int secs = index.model()->data(index, Qt::DisplayRole).toInt();
06 QTimeEdit *timeEdit = qobject_cast(editor);
07 timeEdit->setTime(QTime(0, secs / 60, secs % 60));
08 } else {
09 QItemDelegate::setEditorData(editor, index);
10 }
11 }
Когда пользователь инициирует редактирование, представление вызывает createEditor() для создания редактора и затем setEditorData() для инициализации редактора текущими данными элемента. Если редактор вызывается для столбца длительности, получаем из данных элемента длительность фонограммы в секундах и устанавливаем значение QTimeEdit на соответствующее количество минут и секунд; в противном случае мы позволяем делегату по умолчанию выполнить инициализацию.
01 void TrackDelegate::setModelData(QWidget *editor,
02 QAbstractItemModel *model, const QModelIndex &index) const
03 {
04 if (index.column() == durationColumn) {
05 QTimeEdit *timeEdit = qobject_cast(editor);
06 QTime time = timeEdit->time();
07 int secs = (time.minute() * 60) + time.second();
08 model->setData(index, secs);
09 } else {
10 QItemDelegate::setModelData(editor, model, index);
11 }
12 }
Если пользователь прекращает редактирование (например, щелкнув левой кнопкой мышки за пределами виджета редактора или нажав клавишу Enter или Tab), а не отменяет его, модель должна быть обновлена данными редактора. Если редактировалась длительность, извлекаем минуты и секунды из QTimeEdit и устанавливаем поле данных на соответствующее значение секунд.
Мы вполне можем (хотя в данном случае это делать необязательно) создать пользовательский делегат, который обеспечит более тонкое управление редактированием и воспроизведением любого элемента модели. В нашем случае пользовательский делегат управляет только конкретным столбцом, но поскольку QModelIndex передается всем функциям класса QItemDelegate, которые нами переопределяются, мы можем контролировать любой столбец, строку, прямоугольную область, родительский элемент или любое их сочетание вплоть до управления при необходимости на уровне отдельных элементов.
В данной главе мы представили достаточно подробный обзор архитектуры Qt модель/представление. Мы показали, как можно использовать удобные подклассы отображения элементов, как применять заранее определенные в Qt модели и как создавать пользовательские модели и пользовательские делегаты. Однако архитектура модель/представление настолько богата, что мы не смогли раскрыть все ее возможности из-за ограниченности объема книги. Например, мы могли бы создать пользовательское представление, которое отображает свои элементы не в виде списка, таблицы или дерева. Это делается в примере Диаграмма (Chart), который находится в каталоге Qt examples/itemviews/chart; этот пример содержит пользовательское представление, которое воспроизводит модель данных в виде круговой диаграммы.
Кррме того, для одной модели можно использовать несколько представлений, и это не потребует особых усилий. Любое редактирование одного представления автоматически и немедленно отразится на других представлениях. Такие возможности особенно полезны при просмотре больших наборов данных, когда пользователь может захотеть увидеть блоки данных, расположенные далеко друг от друга. Эта архитектура поддерживает также выделения областей: когда два или более представления используются одной моделью, каждому представлению может быть предоставлена возможность иметь свою собственную независимую выделенную область или такие области могут совместно использоваться разными представлениями.
В онлайновой документации Qt всесторонне рассматриваются вопросы программирования классов по отображению элементов. См. , где приводится список всех таких классов, и , где даются дополнительная информация и ссылки на соответствующие примеры, включенные в Qt.
Глава 11. Классы—контейнеры
Классы—контейнеры являются обычными шаблонными классами (template classes), которые предназначены для хранения в памяти элементов заданного типа. С++ уже предлагает много контейнеров в составе стандартной библиотеки шаблонов (STL — Standard Template Library), которая входит в стандартную библиотеку С++.
Qt обеспечивает свои собственные классы—контейнеры, поэтому в Qt—программах мы можем использовать как контейнеры Qt, так и контейнеры STL. Главное преимущество Qt—контейнеров — одинаковое поведение на всех платформах и неявное совместное использование данных. Неявное совместное использование или «копирование при записи» — это оптимизация, позволяющая передавать контейнеры целиком без существенного ухудшения производительности. Qt—контейнеры также снабжены простыми в применении классами итераторов в стиле Java; используя QDataStream, они могут быть оформлены в виде потоков данных и обычно приводят к меньшему объему программного кода в исполняемых модулях, чем при применении соответствующих STL—контейнеров. Наконец, для некоторого оборудования, на котором может работать Qtopia Core (версия Qt для мобильных устройств), единственно доступными являются Qt—контейнеры.
Qt предлагает как последовательные контейнеры, например QVector, QLinkedList и QList, так и ассоциативные контейнеры, например QMap и QHash. Концептуально последовательные контейнеры отличаются тем, что элементы в них хранятся один за другим, в то время как в ассоциативных контейнерах хранятся пары ключ—значение.
Qt также содержит обобщенные алгоритмы, которые могут выполняться над произвольными контейнерами. Например, алгоритм qSort() сортирует последовательный контейнер, a qBinaryFind() выполняет двоичный поиск в упорядоченном последовательном контейнере. Эти алгоритмы аналогичны тем, которые предлагаются STL.
Если вы знакомы с контейнерами STL и библиотека STL уже установлена на платформах, на которых вы работаете, можете их использовать вместо контейнеров Qt или как дополнение к ним. Для получения более подробной информации относительно функций и классов STL достаточно неплохо начать с веб-сайта STL компании «SGI»: .
В данной главе мы также рассмотрим классы QString, QByteArray и QVariant, поскольку они имеют много общего с контейнерами. QString представляет собой 16-битовую строку символов в коде Unicode, которая широко используется в программном интерфейсе Qt. QByteArray является массивом 8-битовых символов типа char, которым удобно пользоваться для хранения произвольных двоичных данных. QVariant может хранить значения большинства типов С++ и Qt.
Последовательные контейнеры
Вектор QVector представляет собой структуру данных, в которой элементы содержатся в соседних участках оперативной памяти. Вектор отличается от обычного массива С++ тем, что знает свой собственный размер и этот размер может быть изменен. Добавление элементов в конец вектора выполняется достаточно эффективно, но добавление элементов в начало вектора или вставка в его середину могут быть неэффективны.
Рис. 11.1. Вектор чисел двойной точности.
Если нам заранее известно необходимое количество его элементов, мы можем задать начальный размер при его определении и использовать оператор [ ] для заполнения его элементами; в противном случае мы должны либо затем изменить его размер, либо добавлять элементы в конец вектора. В приведенном ниже примере мы указываем начальный размер вектора:
QVector vect(3);
vect[0] = 1.0;
vect[1] = 0.540302;
vect[2] = -0.416147;
Ниже та же самая задача решается путем объявления пустого вектора и применения функции append(), которая добавляет элементы в конец вектора:
QVector vect;
vect.append(1.0);
vect.append(0.540302);
vect.append(-0.416147);
Вместо append() можно использовать оператор <<:
vect << 1.0 << 0.540302 << -0.416147;
Организовать цикл просмотра элементов вектора можно при помощи оператора [ ] и функции count():
double sum = 0.0;
for (int i = 0; i < vect.count(); ++i)
sum += vect[i];
Элементы вектора, которым не было присвоено какое-нибудь значение явным образом, инициализируются при помощи стандартного конструктора класса элемента. Основные типы и указатели инициализируются нулевым значением.
Вставка элементов в начало или в середину вектора QVector, а также удаление элементов из этих позиций могут быть неэффективны для больших векторов. По этой причине Qt предлагает связанный список QLinkedList — структуру данных, элементы которой располагаются не в соседних участках памяти. В отличие от векторов, связанные списки не поддерживают произвольный доступ к элементам, но обеспечивают «константное время» выполнения операций вставки и удаления.
Рис. 11.2. Связанный список значений типа double.
Связанные списки не обеспечивают оператор [ ], поэтому необходимо использовать итераторы для прохода по всем элементам. Итераторы также используются для указания позиции элементов. Например, в следующем фрагменте программного кода выполняется вставка строки «Tote Hosen» между «Clash» и «Ramones»:
QLinkedList list;
list.append("Clash");
list.append("Ramones");
QLinkedList::iterator i = list.find("Ramones");
list.insert(i, "Tote Hosen");
Более подробно итераторы будут рассмотрены позже в данном разделе.
Последовательный контейнер QList является «массивом—списком», который сочетает в одном классе наиболее важные преимущества QVector и QLinkedList. Он поддерживает произвольный доступ, и его интерфейс основан на индексировании подобно применяемому векторами QVector. Вставка в конец или удаление последнего элемента списка QList выполняется очень быстро, а вставка в середину выполняется быстро для списков, содержащих до одной тысячи элементов. Если не требуется вставлять элементы в середину больших списков и не нужно, чтобы элементы списка занимали последовательные адреса памяти, то QList обычно будет наиболее подходящим контейнером общего назначения.
Класс QStringList является подклассом QList, который широко используется в программном интерфейсе Qt. Кроме наследуемых от базового класса функций он имеет несколько дополнительных функций, увеличивающих возможности класса по обработке строк. Класс QStringList будет обсуждаться в последнем разделе этой главы.
QStack и QQueue — еще два примера удобных подклассов: QStack — это вектор, для работы с которым предусмотрены функции push(), pop() и top(). QQueue — это список, для работы с которым предусмотрены функции enqueue(), dequeue() и head().
Во всех до сих пор рассмотренных контейнерах тип элемента T может являться базовым типом (например, int или double), указателем или классом, который имеет стандартный конструктор (т.е. конструктор без аргументов), конструктор копирования и оператор присваивания. К таким классам относятся QByteArray, QDateTime, QRegExp, QString и QVariant. Этим свойством не обладают классы Qt, которые наследуют QObject, поскольку последний не имеет конструктора копирования и оператора присваивания. На практике это не составляет проблему, потому что мы можем просто хранить в контейнере указатели на такие типы данных, а не сами объекты QObject.
Тип T также может быть контейнером; в этом случае следует иметь в виду, что необходимо разделять рядом стоящие угловые скобки пробелами, в противном случае компилятор будет сбит с толку, воспринимая >> как оператор. Например:
QList > list;
Кроме только что упомянутых типов в качестве типа элементов контейнера может задаваться любой пользовательский класс, отвечающий описанным ранее критериям. Ниже дается пример такого класса:
01 class Movie
02 {
03 public:
04 Movie(const QString &title = "", int duration = 0);
05 void setTitle(const QString &title) { myTitle = title; }
06 QString title() const { return myTitle; }
07 void setDuration(int duration) { myDuration = duration; }
08 QString duration() const { return myDuration; }
09 private:
10 QString myTitle;
11 int myDuration;
12 };
Этот класс имеет конструктор, для которого необязательно указывать аргументы (хотя он может иметь до двух аргументов). Он также имеет конструктор копирования и оператор присваивания, которые обеспечиваются С++ по умолчанию. В этом классе достаточно обеспечить копирование между его членами, поэтому нам нет необходимости реализовывать свои собственные конструктор копирования и оператор присваивания.
Qt имеет две категории итераторов, используемых для прохода по элементам контейнера: итераторы в стиле Java и итераторы в стиле STL. Итераторами в стиле Java легче пользоваться, в то время как итераторы в стиле STL более мощные и могут использоваться совместно с алгоритмами Qt и STL.
С каждым классом—контейнером могут использоваться два типа итераторов в стиле Java: итератор, используемый только для чтения, и итератор, используемый как для чтения, так и для записи. Классами итераторов первого типа являются QVectorIterator, QLinkedListIterator и QListIterator. Соответствующие итераторы чтения—записи имеют слово Mutable (изменчивый) в их названии (например, QMutableVectorIterator). В дальнейшем мы основное внимание будем уделять итераторам списка QList; итераторы связанных списков и векторов имеют тот же самый программный интерфейс.
Рис. 11.3. Допустимые позиции итераторов в стиле Java.
Прежде всего следует иметь в виду, что итераторы в стиле Java не ссылаются непосредственно на элементы. Вместо этого они могут указывать на позицию перед первым элементом, после последнего элемента или между двумя элементами. Обычно организованный с их помощью цикл выглядит следующим образом:
QList list;
…
QListIterator i(list);
while (i.hasNext()) {
do_something(i.next());
}
Итератор инициализируется контейнером, для прохода по которому он будет использован. В этот момент итератор располагается непосредственно перед первым элементом. Вызов функции hasNext() возвращает true, если имеется элемент справа от итератора. Функция next() возвращает элемент, расположенный справа от итератора, и перемещает итератор в следующую допустимую позицию.
Проход в обратном направлении выполняется аналогично, с тем отличием, что сначала вызывается функция toBack() для размещения итератора после последнего элемента.
QListIterator i(list);
i.toBack();
while (i.hasPrevious()) {
do_something(i.previous());
}
Функция hasPrevious() возвращает true, если имеется элемент слева от итератора; функция previous() возвращает элемент, расположенный слева от итератора, и перемещает итератор назад на одну позицию. Возможен другой взгляд на функции next() и previous(): они возвращают тот элемент, через который только что прошел итератор.
Рис. 11.4. Влияние функций previous() и next() на итераторы в стиле Java.
Допускающие запись итераторы (mutable iterators) имеют функции для вставки, модификации и удаления элементов в ходе просмотра контейнеров. В показанном ниже цикле из списка удаляются отрицательные числа:
QMutableListIterator i(list);
while (i.hasNext()) {
if (i.next() < 0.0)
i.remove();
}
Функция remove() всегда работает с последним пройденным элементом. Она так же ведет себя при проходе элементов в обратном направлении:
QMutableListIterator i(list);
i.toBack();
while (i.hasPrevious()) {
if (i.previous() < 0.0)
i.remove();
}
Аналогично допускающие запись итераторы в стиле Java имеют функцию setValue(), которая модифицирует последний пройденный элемент. Ниже показано, как можно заменить отрицательные числа их абсолютным значением:
QMutableListIterator i(list);
while (i.hasNext()) {
int val = i.next();
if (val < 0.0)
i.setValue(-val);
}
Кроме того, можно вставлять элемент в текущую позицию итератора с помощью функции insert(). После этого итератор перемещается в позицию между новым элементом и следующим за ним.
Кроме итераторов в стиле Java каждый класс последовательных контейнеров C имеет итераторы в стиле STL двух типов: С<Т>::iterator и C::const_iterator. Они отличаются тем, что итератор const_iterator не позволяет модифицировать данные.
Функция контейнера begin() возвращает итератор в стиле STL, ссылающийся на первый элемент контейнера (например, list[0]), в то время как функция контейнера end() возвращает итератор, ссылающийся на элемент «после последнего элемента» (например, list[5] для списка размером 5). Если контейнер пустой, функции begin() и end() возвращают одинаковое значение. Это может использоваться для проверки наличия хотя бы одного элемента в контейнере, хотя для этой цели более удобно пользоваться функцией isEmpty().
Рис. 11.5. Допустимые позиции итераторов в стиле STL.
Синтаксис применения итераторов в стиле STL моделирует синтаксис применения указателей С++. Мы можем использовать операторы ++ и —— для перехода на следующий или предыдущий элемент, а также унарный оператор * для извлечения значения элемента из позиции текущего итератора. Для вектора vector типы итераторов iterator и const_iterator определяются просто как typedef для Т * и const T *. (Так можно делать, поскольку QVector хранит свои элементы в последовательных адресах памяти.)
В показанном ниже примере каждое значение в списке QList заменяется своим абсолютным значением:
QList::iterator i = list.begin();
while (i ! = list.end()) {
*i = qAbs(*i);
++i;
}
Несколько функций Qt возвращают контейнер. Если мы хотим в цикле обработать такое возвращенное значение функции, используя итератор в стиле STL, мы должны сделать копию контейнера и в цикле обрабатывать эту копию. Например, приводимый ниже программный код показывает, как правильно следует обрабатывать в цикле список типа QList, возвращенный функцией QSplitter::sizes():
QList list = splitter->sizes();
QList::const_iterator i = list.begin();
while (i != list.end()) {
do_something(*i);
++i;
}
Ниже дается пример неправильного программного кода:
// Неправильный программный код
QList::const_iterator i = splitter->sizes().begin();
while (i != splitter->sizes().end()) {
do_something(*i);
++i;
}
Это происходит из-за того, что функция QSplitter::sizes() возвращает новый список QList по значению при каждом новом своем вызове. Если мы не сохраняем возвращенное функцией значение, С++ автоматически удалит его еще до начала итерации, оставляя нам «повисший» итератор. Дело еще усугубляется тем, что на каждом новом шаге цикла функция QSplitter::sizes() должна генерировать новую копию списка из-за вызова функции splitter->sizes().end(). Поэтому используйте общее правило: когда применяются итераторы в стиле STL, всегда следует обрабатывать в цикле копию экземпляра контейнера, возвращаемого по значению.
При использовании итераторов в стиле Java, предназначенных только для чтения, нам не надо создавать копию. Итератор обеспечит копию незаметно для нас, гарантируя всегда просмотр в цикле данных, только что возвращенных функцией. Например:
QListIterator i(splitter->sizes());
while (i.hasNext()) {
do_something(i.next());
}
Подобное копирование контейнера может показаться неэффективным, но это не так из-за оптимизации посредством так называемого неявного совместного использования даннъис (implicit sharing). Это означает, что операция копирования Qt—контейнера выполняется почти так же быстро, как копирование одного указателя. Только если скопированная строка изменяется, тогда данные действительно копируются — и все это делается автоматически и незаметно для пользователя. Поэтому неявное совместное использование иногда называют «копированием при записи» (copy on write).
Привлекательность неявного совместного использования данных заключается в том, что эта оптимизация выполняется так, что мы можем не думать о ней; она просто работает сама по себе и не требует от нас какого-то дополнительного программного кода. В то же время неявное совместное использование данных способствует тому, что программист следует четкому стилю, возвращая все объекты по значению. Рассмотрим следующую функцию:
01 QVector sineTable()
02 {
03 QVector vect(360);
04 for (int i = 0; i <360; ++i)
05 vect[i] = sin(i / (2 * M_PI));
06 return vect;
07 }
Вызов этой функции выглядит следующим образом:
QVector table = sineTable();
В отличие от этого подхода, STL склоняет нас к передаче вектора в виде неконстантной ссылки, чтобы избежать копирования, происходящего из-за возвращения функцией значения, хранимого в переменной:
01 using namespace std;
02 void sineTable(vector &vect)
03 {
04 vect.resize(360);
05 for (int i = 0; i < 360; ++i)
06 vect[i] = sin(i / (2 * M_PI));
07 }
В результате вызов будет не столь простым и менее понятным:
vector table;
sineTable(table);
В Qt применяется неявное совместное использование данных во всех ее контейнерах и во многих других классах, включая QByteArray, QBrush, QFont, QImage, QPixmap и QString. Это делает применение этих классов очень эффективным при передаче по значению, как аргументов функции, так и возвращаемых функциями значений.
Неявное совместное использование данных в Qt гарантирует, что данные не будут копироваться, если мы их не модифицируем. Чтобы получить максимальные выгоды от применения этой технологии, необходимо выработать в себе две новые привычки при программировании. Одна связана с использованием функции at() вместо оператора [ ] при доступе только для чтения к (неконстантному) вектору или списку. Поскольку при применении Qt—контейнеров нельзя сказать, оказывается ли [ ] с левой стороны оператора присваивания или нет, предполагается самое худшее и принудительно выполняется действительное копирование (deep сору), в то время как at() не допускается в левой части оператора присваивания.
Подобная проблема возникает при прохождении контейнера с помощью итераторов в стиле STL. Когда вызываются функции begin() или end() для неконстантного контейнера, Qt всегда принудительно выполняет действительное копирование при совместном использовании данных. Решение, позволяющее избавиться от этой неэффективности, состоит в применении по мере возможности const_iterator, constBegin() и constEnd().
В Qt предусмотрен еще один, последний метод прохода по элементам последовательного контейнера — оператор цикла foreach. Он выглядит следующим образом:
QLinkedList list;
…
foreach (Movie movie, list) {
if (movie.title() == "Citizen Kane") {
cout << "Found Citizen Kane" << endl;
break;
}
}
Псевдоключевое слово foreach реализуется с помощью стандартного цикла for. На каждом шаге цикла переменная цикла (movie) устанавливается на новый элемент, начиная с первого элемента контейнера и затем двигаясь вперед. Цикл foreach автоматически использует копию контейнера при входе в цикл, и по этой причине модификации контейнера в ходе цикла не влияют на сам цикл.
Поддерживаются операторы цикла break и continue. Если тело цикла состоит из одного оператора, необязательно указывать скобки. Как и для оператора for, переменная цикла может определяться вне цикла, например:
QLinkedList list;
Movie movie;
…
foreach (movie, list) {
if (movie.title() == "Citizen Kane") {
cout << "Found Citizen Kane" << endl;
break;
}
}
Определение переменной цикла вне цикла — единственная возможность для контейнеров, содержащих типы данных с запятой (например, QPair).
Как работает неявное совместное использование данных
Неявное совместное использование данных работает автоматически и незаметно для пользователя, поэтому нам не надо в программном коде предусматривать специальные операторы для обеспечения этой оптимизации. Но поскольку хочется знать, как это работает, мы рассмотрим пример и увидим, что скрывается от нашего внимания. В этом примере используются строки типа QString — одного из многих неявно совместно используемых Qt—классов:
QString str1 = "Humpty";
QString str2 = str1;
Мы присваиваем переменной str1 значение «Humpty» (Humpty-Dumpty — Шалтай—Болтай) и переменную str2 приравниваем к переменной str1. К этому моменту оба объекта QString ссылаются на одну и ту же внутреннюю структуру данных в памяти. Кроме символьных данных эта структура данных имеет счетчик ссылок, показывающий, сколько строк QString ссылается на одну структуру данных. Поскольку обе переменные ссылаются на одни данные, счетчик ссылок будет иметь значение 2.
str2[0] = 'D';
Когда мы модифицируем переменную str2, выполняется действительное копирование данных, чтобы переменные str1 и str2 ссылались на разные структуры данных и их изменение приводило к изменению их собственных копий данных. Счетчик ссылок данных переменной str1 («Humpty») принимает значение 1, и счетчик ссылок данных переменной str2 («Dumpty») тоже принимает значение 1. Значение 1 счетчика ссылок означает, что данные не используются совместно.
str2.truncate(4);
Если мы снова модифицируем переменную str2, никакого копирования не будет происходить, поскольку счетчик ссылок данных переменной str2 имеет значение 1. Функция truncate() непосредственно обрабатывает значение переменной str2, возвращая в результате строку «Dump». Счетчик ссылок по-прежнему имеет значение 1.
str1 = str2;
Когда мы присваиваем строку str2 строке str1, счетчик ссылок для данных str1 снижается до 0 и приводит к тому, что теперь никакая строка типа QString не содержит значения «Humpty». Память освобождается. Обе строки QStrings теперь ссылаются на значение «Dump», счетчик ссылок которого теперь имеет значение 2.
Часто не пользуются возможностью совместного использования данных в многопоточных программах из-за условий гонок при доступе к счетчикам ссылок. В Qt этой проблемы не возникает. Классы—контейнеры используют инструкции ассемблера при реализации атомарных операций со счетчиками. Эта технология доступна пользователям Qt через применение классов QSharedData и QSharedDataPointer.
Ассоциативные контейнеры
Ассоциативный контейнер содержит произвольное количество элементов одинакового типа, индексируемых некоторым ключом. Qt содержит два основных класса ассоциативных контейнеров: QМар<К, T> и QHash.
QMap — это структура данных, которая содержит пары ключ—значение, упорядоченные по возрастанию ключей. Такая организация данных обеспечивает хорошую производительность операций поиска и вставки, а также при проходе данных в порядке их сортировки. Внутренне QMap реализуется как слоеный список (skip—list).
Рис. 11.6. Ассоциативный массив, связывающий QString с int.
Простой способ вставки элементов в ассоциативный массив состоит в использовании функции insert():
QMap map;
map.insert("eins", 1);
map.insert("sieben", 7);
map.insert("dreiundzwanzig", 23);
Можно поступить по-другому — просто присвоить значение заданному ключу:
map["eins"] = 1;
map["sieben"] = 7;
map["dreiundzwanzig"] = 23;
Оператор [ ] может использоваться как для вставки, так и для поиска. Но если этот оператор используется для поиска значения, для которого не существует ключа, будет создан новый элемент с данным ключом и пустым значением. Чтобы не создавать случайно пустые элементы, вместо оператора [ ] можно использовать функцию value():
int val = map.value("dreiundzwanzig");
Если ключ отсутствует в ассоциативном массиве, возвращается значение по умолчанию, создаваемое стандартным конструктором данного типа значений. Для базовых типов и указателей возвращается нуль. Мы можем определить другое значение, используемое по умолчанию, с помощью второго аргумента функции value(), например:
int seconds = map.value("delay", 30);
Это эквивалентно следующим операторам:
int seconds = 30;
if (map.contains("delay"))
seconds = map.value("delay");
Типы данных К и T в ассоциативном массиве QMap могут быть базовыми типами (например, int и double), указатели и классы, которые имеют стандартный конструктор, конструктор копирования и оператор присваивания. Кроме того, тип К должен обеспечивать оператор operator < (), поскольку QMap применяет его для хранения элементов в порядке возрастания значений ключей.
Класс QMap имеет две удобные функции, keys() и values(), которые особенно полезны при работе с небольшими наборами данных. Они возвращают списки типа QList ключей и значений ассоциативного массива.
Обычно ассоциативные массивы имеют одно значение для каждого ключа: если новое значение присваивается существующему ключу, старое значение заменяется новым, чтобы не было элементов с одинаковыми ключами. Можно иметь несколько пар ключ—значение с одинаковым ключом, если использовать функцию insertMulti() или удобный подкласс QMultiMap. QMap имеет перегруженную функцию values(const К &), которая возвращает список QList со всеми значениями заданного ключа. Например:
QMultiMap multiMap;
multiMap.insert(1, "one"); multiMap.insert(1, "eins");
multiMap.insert(1, "uno");
QList vals = multiMap.values(1);
QHash — это структура данных, которая хранит пары ключ—значение в хэш—таблице. Ее интерфейс почти совпадает с интерфейсом QMap, однако здесь предъявляются другие требования к шаблонному типу К и операции поиска обычно выполняются значительно быстрее, чем в QMap. Еще одним отличием является неупорядоченность значений в QHash.
Кроме стандартных требований, которым должен удовлетворять любой тип значений, хранимых в контейнере, для типа К в QHash должен быть предусмотрен оператор operator == () и должна быть обеспечена глобальная функция qHash(), возвращающая хэш—код для ключа. Qt уже имеет перегрузки функции qHash() для целых типов, указателей, QChar, QString и QByteArray.
QHash автоматически выделяет некий первичный объем памяти для своей внутренней хэш—таблицы и изменяет его, когда элементы вставляются или удаляются. Кроме того, можно обеспечить более тонкое управление производительностью с помощью функции reserve(), которая устанавливает ожидаемое количество элементов в хэш—таблице, и функции squeeze(), которая сжимает хэш—таблицу, учитывая текущее количество элементов. Обычно действуют так: вызывают reserve(), обеспечивая максимальное ожидаемое количество элементов, затем добавляют данные и, наконец, вызывают squeeze() для сведения к минимуму расхода памяти, если элементов оказалось меньше, чем ожидалось.
Хэш-таблицы обычно имеют одно значение на каждый ключ, однако одному ключу можно присвоить несколько значений, используя функцию insertMulti() или удобный подкласс QMultiHash.
Кроме QHash в Qt имеется также класс QCache, который может использоваться для создания кэша объектов, связанных с ключом, и контейнер QSet, который хранит только ключи. Оба класса реализуются на основе QHash и предъявляют к типу К такие же требования, как и QHash.
Для прохода по всем парам ключ—значение, находящимся в ассоциативном контейнере, проще всего использовать итератор в стиле Java. Поскольку итераторы должны обеспечивать доступ и к ключу, и к значению, итераторы в стиле Java работают с ассоциативными контейнерами немного иначе, чем с последовательными контейнерами. Основное отличие проявляется в том, что функции next() и previous() возвращают пару ключ—значение, а не просто одно значение. Компоненты ключа и значения можно извлечь из объекта пары с помощью функций key() и value(). Например:
QMap map;
…
int sum = 0;
QMapIterator i(map);
while (i.hasNext())
sum += i.next().value();
Если требуется получить доступ как к ключу, так и к значению, мы можем просто игнорировать значение, возвращаемое функциями next() и previous(), и использовать функции итератора key() и value(), которые работают с последним пройденным элементом.
QMapIterator i(map);
while (i.hasNext()) {
i.next();
if (i.value() > largestValue) {
largestKey = i.key();
largestValue = i.value();
}
}
Допускающие запись итераторы имеют функцию setValue(), которая модифицирует значение, содержащееся в текущем элементе:
QMutableMapIterator i(map);
while (i.hasNext()) {
i.next();
if (i.value()< 0.0)
i.setValue(-i.value());
}
Итераторы в стиле STL также имеют функции key() и value(). Для неконстантных типов итераторов value() возвращает неконстантную ссылку, позволяя нам изменять значение в ходе просмотра контейнера. Следует отметить, что хотя эти итераторы называются итераторами «в стиле STL», они существенно отличаются от итераторов STL контейнера map, которые ссылаются на pair.
Оператор цикла foreach также работает с ассоциативными контейнерами, но только с компонентом значение пар ключ—значение. Если нужны как ключи, так и значение, мы можем вызвать функции keys() и values(const К &) во внутреннем цикле foreach:
QMultiMap map;
…
foreach (QString key, map.keys()) {
foreach (int value, map.values(key)) {
do_something(key, value);
}
}
Обобщенные алгоритмы
В заголовочном файле объявляются глобальные шаблонные функции, которые реализуют основные алгоритмы для контейнеров. Большинство этих функций работают с итераторами в стиле STL.
Заголовочный файл STL содержит более полный набор обобщенных алгоритмов. Эти алгоритмы могут использоваться не только с STL-контейнерами, но и с Qt—контейнерами. Если STL доступен на всех ваших платформах, вероятно, нет причин не использовать STL—алгоритмы, когда в Qt отсутствует эквивалентный алгоритм. Далее мы кратко рассмотрим наиболее важные Qt—алгоритмы.
Алгоритм qFind() выполняет поиск конкретного значения в контейнере. Он принимает «начальный» и «конечный» итераторы и возвращает итератор, ссылающийся на первый подходящий элемент, или «конечный» итератор, если нет подходящих элементов. В представленном ниже примере i устанавливается на list.begin() + 1, a j устанавливается на list.end().
QStringList list;
list << "Emma" << "Karl" << "James" << "Mariette";
QStringList::iterator i = qFind(list.begin(), list.end(), "Karl");
QStringList::iterator j = qFind(list.begin(), list.end(), "Petra");
Алгоритм qBinaryFind() выполняет поиск подобно алгоритму qFind(), за исключением того, что он предполагает упорядоченность элементов в возрастающем порядке и использует двоичный поиск в отличие от линейного поиска в qFind().
Алгоритм qFill() заполняет контейнер конкретным значением:
QLinkedList list(10);
qFill(list.begin(), list.end(), 1009);
Как и другие алгоритмы, основанные на применении итераторов, qFill() может выполняться для части контейнера, если соответствующим образом установить аргументы. В следующем фрагменте программного кода первые пять элементов вектора инициализируются значением 1009, а последние пять элементов — значением 2013:
QVector vect(10);
qFill(vect.begin(), vect.begin() + 5, 1009);
qFill(vect.end() - 5, vect.end(), 2013);
Алгоритм qCopy() копирует значения одного контейнера в другой.
QVector vect(list.count());
qCopy(list.begin(), list.end(), vect.begin());
Алгоритм qCopy() может также использоваться для копирования элементов в рамках одного контейнера, если исходный диапазон и целевой диапазон не перекрываются. В следующем фрагменте программного кода мы заменяем последние два элемента списка первыми двумя элементами:
qCopy(list.begin(), list.begin() + 2, list.end() - 2);
Алгоритм qSort() сортирует элементы контейнера в порядке их возрастания.
qSort(list.begin(), list.end());
По умолчанию qSort() использует оператор < для сравнения элементов. Для сортировки элементов по убыванию передайте qGreater() в качестве третьего аргумента (здесь T — тип элемента контейнера):
qSort(list.begin(), list.end(), qGreater());
Мы можем использовать третий параметр для определения пользовательского критерия сортировки. Например, ниже приводится функция сравнения «меньше, чем», которая выполняет сравнение строк QString без учета регистра:
bool insensitiveLessThan(const QString &str1, const QString &str2)
{
return str1.toLower() < str2.toLower();
}
Тогда вызов qSort() будет таким:
QStringList list;
qSort(list.begin(), list.end(), insensitiveLessThan);
Алгоритм qStableSort() аналогичен qSort(), за исключением того, что он гарантирует сохранение порядка следования одинаковых элементов. Этот алгоритм стоит применять в тех случаях, когда критерий сортировки учитывает только часть значения элемента и пользователь видит результат сортировки. Мы использовали qStableSort() в для реализации сортировки в приложении Электронная таблица.
Алгоритм qDeleteAll() вызывает оператор delete для каждого указателя, хранимого в контейнере. Он имеет смысл только для контейнеров, в качестве элементов которых используются указатели. После вызова этого алгоритма элементы по-прежнему присутствуют в контейнере, и для их удаления используется функция clear(). Например:
qDeleteAll(list);
list.clear();
Алгоритм qSwap() выполняет обмен значений двух переменных. Например:
int x1 = line.x1();
int x2 = line.x2();
if (x1 > x2)
qSwap(x1, x2);
Наконец, заголовочный файл , который включается в любой другой заголовочный файл Qt, содержит несколько полезных определений, в том числе функцию qAbs(), которая возвращает абсолютное значение аргумента, и функции qMin() и qMax(), которые возвращают максимальное или минимальное значение двух значений.
Строки, массивы байтов и объекты произвольного типа
QString, QByteArray и QVariant — три класса, которые имеют много общего с контейнерами и могут использоваться в некоторых контекстах как альтернатива контейнерам. Кроме того, как и контейнеры, эти классы используют неявное совмещение данных для уменьшения расхода памяти и повышения быстродействия.
Мы начнем с рассмотрения типа QString. Строковые данные применяются в любой программе с графическим пользовательским интерфейсом и не только непосредственно для пользовательского интерфейса, но часто и в качестве структур данных. В стандартном составе С++ содержится два типа строк: традиционные символьные массивы языка С с завершающим символом «\0» и класс std::string. Класс QString содержит 16-битовые значения в коде Unicode. Unicode содержит в качестве подмножеств коды ASCII и Latin-1 с их обычным числовым представлением. Но поскольку QString имеет 16-битовые значения, он может представлять тысячи других символов, используемых для записи букв большинства мировых языков. Дополнительную информацию по кодировке Unicode вы найдете в .
При использовании QString не стоит беспокоиться о таких не очень понятных вещах, как выделение достаточного объема памяти или гарантирование завершения данных символом '\0'. Концептуально строки QString можно рассматривать как вектор символов QChar. Внутри QString могут быть символы '\0'. Функция length() возвращает размер строки, включая символы '\0'.
Класс QString содержит бинарный оператор +, обеспечивающий конкатенацию двух строк, и оператор += для добавления одной строки в конец другой. Поскольку QString заранее автоматически добавляет память в конец данных строки, построение строки путем повторения операций добавления символов в конец строки выполняется очень быстро. Ниже приводится пример обоих операторов:
QString str = "User: ";
str += userName + "\n";
Существует также функция QString::append(), которая делает то же самое, что и оператор +=:
str = "User: ";
str.append(userName);
str.append("\n");
Совершенно другой способ объединения строк заключается в использовании функции sprintf() класса QString:
str.sprintf("%s %.1f%%", "perfect competition", 100.0);
Данная функция поддерживает спецификаторы формата, используемые функцией библиотеки С++ sprintf(). В приведенном выше примере переменной str присваивается значение «perfect competition 100.0%» (абсолютно безупречное соревнование).
Имеется еще один способ составления строк из других строк или чисел, и он заключается в использовании функции arg():
str = QString("%1 %2 (%3s-%4s)")
.arg("реrmissive").arg("society").arg(1950).arg(1970);
В этом примере «%1» заменяется словом «permissive» (либеральное), «%2» заменяется словом «society» (общество), «%3» заменяется на «1950» и «%4» заменяется на «1970». В результате получаем «permissive society (1950s — 1970s)» (либеральное общество в 1950—70 годах). Функция arg() перегружается для обработки различных типов данных. В некоторых случаях используются дополнительные параметры для управления шириной поля, базой числа или точностью числа с плавающей точкой. В целом гораздо лучше использовать arg(), а не sprintf(), поскольку эта функция сохраняет тип, полностью поддерживает Unicode и позволяет трансляторам изменять порядок параметров «%1».
QString может преобразовывать числа в строки, используя статическую функцию QString::number():
str = QString::number(59.6);
Или это можно сделать при помощи функции setNum():
str.setNum(59.6);
Обратное преобразование строки в число осуществляется при помощи функций toInt(), toLongLong(), toDouble() и так далее. Например:
bool ok;
double d = str.toDouble(&ok);
Этим функциям передается необязательный параметр—ссылка на переменную типа bool, которая устанавливается на значение true или false в зависимости от успешности преобразования. Если преобразование завершается неудачей, эти функции возвращают 0.
Имея некоторую строку, нам часто приходится выделять какую-то ее часть. Функция mid() возвращает подстроку заданной длины (второй аргумент), начиная с указанной позиции (первый аргумент). Например, следующий программный код выводит на консоль слово «pays»:
QString str = "polluter pays principle";
qDebug() << str.mid(9, 4);
Существуют также функции left() и right(), которые выполняют аналогичную работу. Обеим функциям передается количество символов n, и они возвращают первые и последние n символов строки. Например, следующий программный код выдает на консоль слова «polluter principle»:
QString str = "polluter pays principle";
qDebug() << str.left(8) << " " << str.right(9);
Если требуется определить, содержится ли в строке конкретный символ, подстрока или соответствует ли строка регулярному выражению, мы можем использовать один из вариантов функции indexOf() класса QString:
QString str = "the middle bit";
int i = str.indexOf("middle");
В результате i становится равным 4. Функция indexOf() возвращает -1 при неудачном поиске и принимает в качестве необязательных аргументов начальную позицию и флажок учета регистра.
Если мы просто хотим проверить начальные или конечные символы строки, мы можем использовать функции startsWith () и endsWith():
if (url.startsWith("http:") && url.endsWith(".png"))
Это проще и быстрее, чем:
if (url.left(5) == "http:" && url.right(4) == ".png")
Оператор сравнения строк == зависит от регистра. Если сравниваются строки, которые пользователь видит на экране, обычно правильным решением будет использование функции localeAwareCompare(), а если необходимо сделать сравнение не зависимым от регистра, мы можем использовать функции toUpper() или toLower(). Например:
if (fileName.toLower() == "readme.txt")
Если мы хотим заменить определенную часть строки другой подстрокой, мы можем использовать функцию replace():
QString str= "a cloudy day";
str.replace(2, 6, "sunny");
Результатом является «sunny day» (солнечный день). Этот программный код может быть переписан с применением функций remove() и insert():
str.remove(2, 6);
str.insert(2, "sunny");
Во-первых, мы удаляем шесть символов, начиная с позиции 2, и в результате получаем строку «а_ _day» (с двумя пробелами), затем мы вставляем слово «sunny» в позицию 2.
Существуют перегруженные версии функции replace(), которые заменяют все подстроки, совпадающие со значением первого аргумента, вторым аргументом. Например, ниже показано, как можно заменить все символы «&» в строке на «&»:
str.replace("&", "&");
Часто требуется удалять из строки пробельные символы (пробелы, символы табуляции и перехода на новую строку). QString имеет функцию, которая удаляет эти символы с обоих концов строки:
QString str = " ВОВ \t THE \nDOG \n";
qDebug() << str.trimmed();
Строку str можно представить в виде
_ _ _ВОВ_\t_THE_ _\nDOG_\n
Строка, возвращаемая функцией trimmed(), имеет вид
ВОВ_\t_THE_ _\nDOG
При обработке введенных пользователем данных нам часто необходимо, кроме удаления пробельных символов с обоих концов строки, заменить каждую последовательность таких символов одним пробелом. Именно это выполняет функция simplified():
QString str = " ВОВ \t THE \nDOG \n";
qDebug() << str.simplified();
Строка, возвращаемая функцией simplified(), имеет вид
ВОВ_THE_DOG
Строку можно разбить на подстроки типа QStringList при помощи функции QList::split():
QString str = "polluter pays principle";
QStringList words = str.split(" ");
В приведенном выше примере мы разбиваем строку «polluter pays principle» на три подстроки: «polluter», «pays» и «principle». Функция split() имеет необязательный третий аргумент, показывающий, надо ли оставлять пустые подстроки (режим по умолчанию) или нет.
Элементы списка QStringList могут объединяться в одну строку при помощи функции join(). Передаваемый функции join() аргумент вставляется между каждой парой объединяемых строк. Например, ниже показано, как создавать одну строку из всех строк списка QStringList, расположенных в алфавитном порядке и разделенных символом перехода на новую строку:
words.sort();
str = words.join("\n");
При обработке строк нам часто приходится определять, пустая строка или нет. Это делается при помощи вызова функции isEmpty() или проверкой равенства нулю возвращаемого функцией length() значения.
Преобразование строк const char * в QString в большинстве случаев выполняется автоматически, например:
str += " (1870)";
Здесь мы добавляем строку const char * в конец строки QString без выполнения явного преобразования. Для явного преобразования const char * в QString выполните приведение типа в QString или вызовите функцию fromAscii() или fromLatin1(). (Работа с литеральными строками в других кодировках рассматривается в .)
Для преобразования QString в const char * используйте функцию toAscii() или toLatin1(). Эти функции возвращают QByteArray, который может быть преобразован в const char *, используя QByteArray::data() или QByteArray::constData(). Например:
printf("User: %s\n", str.toAscii().data());
Для удобства в Qt предусмотрен макрос qPrintable(), который эквивалентен последовательности функций toAscii().constData():
printf("User: %s\n", qPrintable(str));
Когда мы вызываем функции data() или constData() для объектов типа QByteArray, владельцем возвращаемой строки будет этот объект. Это означает, что нам не надо беспокоиться о возможных утечках памяти — Qt вернет нам память. С другой стороны, мы должны проявлять осторожность и не использовать указатель слишком долго. Если объект QByteArray не хранится в переменной, он будет автоматически удален в конце выполнения оператора.
Программный интерфейс класса QByteArray очень похож на программный интерфейс класса QString. Такие функции, как left(), right(), mid(), toLower(), toUpper(), trimmed() и simplified(), существуют в QByteArray и имеют такую же семантику, как и соответствующие функции в QString. QByteArray полезно использовать для хранения неформатированных двоичных данных и строк с 8-битовой кодировкой текста. В целом мы рекомендуем использовать QString для хранения текста, а не QByteArray, потому что QString поддерживает кодировку Unicode.
Для удобства QByteArray всегда автоматически обеспечивает наличие символа '\0' после последнего байта, облегчая передачу объекта QByteArray функции, принимающей const char *. QByteArray также может содержать внутри себя символы '\0', что позволяет использовать этот тип для хранения произвольных двоичных данных.
В некоторых ситуациях требуется в одной переменной хранить данные различных типов. Один из таких методов заключается в представлении этих данных в виде QByteArray или QString. Например, в виде строки можно хранить как текстовое значение, так и числовое значение. Эти подходы обеспечивают максимальную гибкость, но лишают некоторых преимуществ С++, в частности связанных с безопасностью типов и высокой эффективностью. Qt обеспечивает значительно более удобный способ для хранения данных различного типа: QVariant.
Класс QVariant может содержать значения многих типов Qt, включая QBrush, QColor, QCursor, QDateTime, QFont, QKeySequence, QPalette, QPen, QPixmap, QPoint, QRect, QRegion, QSize и QString, а также такие основные числовые типы С++, как double и int. Класс QVariant может, кроме того, содержать контейнеры QMap, QStringList и QList.
Широкое распространение получило применение этого типа в классах отображения элементов, в модуле баз данных и в классе QSettings, позволяя считывать и записывать данные элементов, данные базы данных и пользовательские настройки в виде любого значения, допускаемого типом QVariant. Пример этого мы уже видели в , когда объекты QRect, QStringList и пара булевых значений передавались функции QSettings::setValue() и затем считывались как объекты QVariant.
Можно создавать произвольно сложные структуры данных, используя тип QVariant для обеспечения вложенных структур контейнеров:
QMap pearMap;
pearMap["Standard"] = 1.95;
pearMap["Organic"] = 2.25;
QMap fruitMap;
fruitMap["Orange"] = 2.10;
fruitMap["Pineapple"] = 3.85;
fruitMap["Pear"] = pearMap;
Здесь мы создали отображение со строковыми ключами (названия продукции) и значениями, которыми могут быть либо числа с плавающей точкой (цены), либо отображения. Отображение верхнего уровня содержит три ключа: «Orange», «Pear» и «Pineapple» (апельсин, груша и ананас). Значение, связанное с ключом «Реаг», является отображением, содержащим два ключа «Standard» и «Organic» (стандартный и экологически чистый). При проходе по ассоциативному массиву, содержащему объекты QVariant, нам необходимо использовать функцию type() для проверки находящегося в QVariant типа, чтобы можно было его правильно обработать.
Способ создания подобным образом структур данных может быть очень привлекательным, поскольку мы можем создавать любые структуры данных. Но удобство применения типа QVariant достигается за счет снижения эффективности и читаемости программы. Для хранения наших данных, как правило, предпочтительнее использовать соответствующий класс языка С++ там, где это возможно.
QVariant используется мета-объектной системой Qt и поэтому является частью модуля QtCore. Тем не менее, когда мы собираем приложение с модулем QtGui, QVariant может хранить такие типы, связанные с графическим пользовательским интерфейсом, как QColor, QFont, QIcon, QImage или QPixmap:
QIcon icon("open.png");
QVariant variant = icon;
Для извлечения значений этих типов из QVariant мы можем следующим образом использовать шаблонную функцию—член QVariant::value():
QIcon icon = variant.value();
Функция value() также может использоваться для преобразования между типами неграфического интерфейса и типом QVariant, однако на практике обычно используются функции преобразования вида to…() (например, toString()) для преобразования типов неграфического интерфейса.
QVariant может также использоваться для хранения пользовательских типов данных при условии обеспечения ими стандартного конструктора и конструктора копирования. Чтобы это заработало, прежде всего необходимо зарегистрировать тип, используя макрос Q_DECLARE_METATYPE() обычно в заголовочном файле после определения класса:
Q_DECLARE_METATYPE(BusinessCard)
Это позволяет нам написать следующий программный код:
BusinessCard businessCard;
QVariant variant = QVariant::fromValue(businessCard);
if (variant.canConvert()) {
BusinessCard card = variant.value();
}
Эти шаблонные функции—члены не будут работать с компилятором MSVC 6 из-за ограничений последнего. Если вы не можете отказаться от этого компилятора, вместо указанных функций используйте глобальные функции qVariantFromValue(), qVariantValue() и qVariantCanConvert().
Если в пользовательском типе данных предусмотрены операторы << и >> для записи и чтения из потока данных QDataStream, их можно зарегистрировать, используя функцию qRegisterMetaTypeStreamOperators(). Это позволяет, среди прочего, хранить параметры настройки пользовательских типов данных, используя QSettings. Например:
qRegisterMetaTypeStreamOperators("BusinessCard");
В данной главе основное внимание было уделено контейнерам Qt, а также классам QString, QByteArray и QVariant. Кроме этих классов Qt имеет несколько других контейнеров. Один из них — QPair, который просто хранит два значения и аналогичен классу std::pair. Еще одним контейнером является QBitArray, который мы будем использовать в первом разделе . Наконец, имеется контейнер QVarLengthArray — низкоуровневая альтернатива вектору QVector. Поскольку он заранее выделяет память в стеке и не допускает неявное совместное использование, накладные расходы у него меньше, чем у вектора QVector, что делает его более подходящим в напряженных циклах.
Алгоритмы Qt, включая несколько не рассмотренных здесь, например qCopyBackward() и qEqual(), описаны в документации Qt, которую можно найти по адресу . Более подробное описание контейнеров Qt, в том числе информацию об их временных и объемных характеристиках, можно найти на странице .
Глава 12. Ввод—вывод
Почти в каждом приложении приходится читать или записывать файлы или выполнять другие операции ввода—вывода. Qt обеспечивает великолепную поддержку ввода—вывода при помощи QIODevice — мощной абстракции «устройств», способных читать и записывать блоки байтов. Qt содержит следующие подклассы QIODevice:
• QFile — получает доступ к файлам, находящимся в локальной файловой системе или внедренным в исполняемый модуль,
• QTemporaryFile — создает временные файлы в локальной файловой системе и получает доступ к ним,
• QBuffer — считывает или записывает данные в QByteArray,
• QProcess — запускает внешние программы и обеспечивает связь между процессами,
• QTcpSocket — передает поток данных по сети, используя протокол TCP,
• QUdpSocket — передает и принимает из сети дейтаграммы UDP.
QProcess, QTcpSocket и QUdpSocket являются последовательными устройствами, т.е. они позволяют получить доступ к данным только один раз, начиная с первого байта и последовательно продвигаясь к последнему байту. QFile, QTemporaryFile и QBuffer являются устройствами произвольного доступа и позволяют считывать байты многократно из любой позиции; они используют функцию QIODevice::seek() для изменения положения указателя файла.
Кроме этих устройств Qt предоставляет два класса высокоуровневых потоков данных, которые можно использовать для чтения и записи на любое устройство ввода—вывода: QDataStream для двоичных данных и QTextStream для текста. Эти классы учитывают такие аспекты, как порядок байтов и кодировка текста, позволяя работающим на разных платформах и в разных странах приложениям Qt считывать и записывать файлы друг друга. Это делает классы Qt по вводу—выводу более удобными, чем соответствующие классы стандартного С++, при использовании которых решать подобные проблемы приходится прикладному программисту.
QFile позволяет легко получать доступ к отдельным файлам, независимо от того, располагаются они в файловой системе или оказываются внедренными в исполняемый модуль приложения как ресурсы. Для приложений, которым приходится работать с целыми наборами файлов, в Qt предусмотрены классы QDir и QFileInfo, которые позволяют работать с каталогами и получать сведения о файлах, расположенных внутри каталогов.
Класс QProcess позволяет нам запускать внешние программы и устанавливать связь с ними через стандартные каналы ввода, вывода и ошибок (cin, cout и cerr). Мы можем устанавливать переменные среды и рабочий каталог, которые будут использоваться внешним приложением. По умолчанию связь с процессом осуществляется в асинхронном режиме (без блокировок), но все же остается возможной блокировка определенных операций.
Работа с сетью, а также чтение и запись документов XML настолько важные темы, что будут рассмотрены отдельно в и , специально им посвященным.
Чтение и запись двоичных данных
Самый простой способ загрузки и сохранения двоичных данных в Qt — получить экземпляр класса QFile, открыть файл и получить к нему доступ через объект QDataStream. QDataStream обеспечивает независимый от платформы формат памяти, который поддерживает такие базовые типы С++, как int и double, и многие типы данных Qt, включая QByteArray, QFont, QImage, QPixmap, QString и QVariant, а также классы—контейнеры Qt, например QList и QMap.
Ниже показано, как можно сохранить целый тип QImage и QMap в файле с именем facts.dat:
QImage image("philip.png");
QMap map;
map.insert("red", Qt::red);
map.insert("green", Qt::green);
map.insert("blue", Qt::blue);
QFile file("facts.dat");
if (!file.open(QIODevice::WriteOnly)) {
cerr << "Cannot open file for writing: "
<< qPrintable(file.errorString()) << endl;
return;
}
QDataStream out(&file);
out.setVersion(QDataStream::Qt_4_1);
out << quint32(0x12345678) << image << map;
Если не удается открыть файл, мы информируем об этом пользователя и возвращаем управление. Макрос qPrintable() возвращает const char *, принимая QString. (Можно было бы поступить по-другому и использовать функцию QString::toStdString(), возвращающую тип std::string, для которого в предусмотрена соответствующая перегрузка оператора <<.)
При успешном открытии файла мы создаем QDataStream и определяем его номер версии. Номер версии — это целое число, влияющее на представление в Qt типов данных (базовые типы данных С++ всегда представляются одинаково). В Qt 4.1 большинство сложных форматов имеют версию 7. Мы можем либо жестко закодировать в программе константу 7, либо использовать символическое имя QDataStream::Qt_4_1.
Чтобы обеспечить представление значения 0x12345678 в виде 32-битового целого числа без знака на всех платформах, мы приводим его тип к quint32 — типу данных, размер которого всегда равен точно 32 битам. Для обеспечения функциональной совместимости QDataStream по умолчанию использует прямой порядок байтов (big-endian); это можно изменить, вызывая функцию setByteOrder().
Нам не надо явно закрывать файл, поскольку это делается автоматически, когда переменная типа QFile выходит из области видимости. Если необходимо убедиться в том, что данные действительно записаны, мы можем вызвать функцию flush() и проверить возвращаемое значение (true при успешном завершении).
Программный код для чтения данных является зеркальным отражением кода, используемого нами для записи данных:
quint32 n;
QImage image;
QMap map;
QFile file("facts.dat");
if (!file.open(QIODevice::ReadOnly)) {
cerr << "Cannot open file for reading: "
<< qPrintable(file.errorString()) << endl;
return;
}
QDataStream in(&file);
in.setVersion(QDataStream::Qt_4_1);
in >> n >> image >> map;
При чтении используется та же самая версия QDataStream, которую мы использовали при записи. Это условие должно выполняться всегда. Жестко кодируя номер версии, мы гарантируем успешное чтение и запись данных приложением (при условии компиляции приложения с версией Qt 4.1 или более поздней версией Qt).
QDataStream так хранит данные, что мы сможем их считать обратно без особых усилий. Например, QByteArray представляется в виде структуры с 32-битовым счетчиком байтов, за которым идут сами байты. Используя функции readRawBytes() и writeRawBytes(), QDataStream может также применяться для чтения и записи неформатированных байтов, не имеющих заголовка в виде счетчика байтов.
Обрабатывать ошибки при чтении данных из потока QDataStream достаточно просто. Этот поток данных имеет функцию status(), возвращающую значения QDataStream::Ok, QDataStream::ReadPastEnd или QDataStream::ReadCorruptData. При возникновении ошибки оператор >> всегда считывает нулевые или пустые значения. Это означает, что во многих случаях можно просто считывать файл целиком, не беспокоясь о возможных ошибках, и в конце удостовериться в успешном выполнении чтения, проверив получаемое функцией status() значение.
QDataStream работает с разнообразными типами данных С++ и Qt; полный их список доступен в сети Интернет по адресу . Кроме того, можно добавить поддержку своих собственных пользовательских типов, перегружая операторы << и >>. Ниже приводится определение пользовательского типа данных, которое может быть использовано совместно с QDataStream:
01 class Painting
02 {
03 public:
04 Painting() { myYear = 0; }
05 Painting(const QString &title, const QString &artist, int year) {
06 myTitle = title;
07 myArtist = artist;
08 myYear = year;
09 }
10 void setTitle(const QString &title) { myTitle = title; }
11 QString title() const { return myTitle; }
12 …
13 private:
14 QString myTitle;
15 QString myArtist;
16 int myYear;
17 };
18 QDataStream &operator << (QDataStream &out, const Painting &painting);
19 QDataStream &operator >> (QDataStream &in, Painting &painting);
Ниже показана возможная реализация оператора <<:
01 QDataStream &operator << (QDataStream &out, const Painting &painting)
02 {
03 out << painting.title() << painting.artist()
04 << quint32(painting.year());
05 return out;
06 }
Для вывода Painting мы просто выводим две строки типа QString и значение типа quint32. В конце функции мы возвращаем поток. Этот обычный в С++ прием позволяет использовать последовательность операторов << для вывода данных в поток. Например:
out << painting1 << painting2 << painting3;
Реализация оператора >> аналогична реализации оператора <<.
01 QDataStream &operator >> (QDataStream &in, Painting &painting)
02 {
03 QString title;
04 QString artist;
05 quint32 year;
06 in >> title >> artist >> year;
07 painting = Painting(title, artist, year);
08 return in;
09 }
Обеспечение в пользовательских типах данных операторов ввода—вывода в поток дает несколько преимуществ. Одно из них заключается в том, что это позволяет нам выводить в поток контейнеры с пользовательскими типами. Например:
QList paintings = …;
out << paintings;
Мы можем так же просто считывать контейнеры:
QList paintings;
in >> paintings;
Это привело бы к ошибке компиляции, если бы тип Painting не поддерживал операции << или >>. Еще одно преимущество обеспечения потоковых операторов в пользовательских типах заключается в возможности хранения этих типов в виде объектов QVariant, что расширяет возможности их применения, например, в объектах QSettings. Это будет работать при условии предварительной регистрации типа с помощью функции qRegisterMetaTypeStreamOperators(), работа которой рассматривается в .
При использовании QDataStream Qt обеспечивает чтение и запись каждого типа, включая контейнеры с произвольным числом элементов. Это освобождает нас от структурирования того, что мы записываем, и от выполнения какого бы то ни было синтаксического анализа того, что мы считываем. Необходимо лишь гарантировать чтение всех типов в той же последовательности, в какой они были записаны, предоставляя Qt обработку всех деталей.
QDataStream имеет смысл использовать как для своих собственных пользовательских форматов файлов, так и для стандартных двоичных форматов. Мы можем считывать и записывать стандартные форматы двоичных данных, используя потоковые операторы для базовых типов (например, quint16 или float) или при помощи функций readRawBytes() и writeRawBytes(). Если QDataStream используется только для чтения и записи «чистых» типов данных С++, нет необходимости вызывать функцию setVersion().
До сих пор мы загружали и сохраняли данные, жестко задавая в программе версию потока QDataStream::Qt_4_1. Этот подход прост, и он надежно работает, но он имеет один небольшой недостаток: мы не сможем воспользоваться новыми форматами и обновленными версиями форматов. Например, если в более поздней версии Qt добавится новый атрибут к QFont (кроме размера точки, наименования шрифта и так далее) и мы жестко закодируем номер версии Qt_4_1, этот атрибут не будет сохраняться и загружаться. Существует два решения. Первое решение заключается во включении номера версии QDataStream в файл:
QDataStream out(&file);
out << quint32(MagicNumber) << quint16(out.version());
(MagicNumber — это константа, которая уникально идентифицирует тип файла.) В этом случае мы всегда будем записывать данные с применением последней версии QDataStream (каким бы результат ни был). При считывании файла мы считываем номер версии потока:
01 quint32 magic;
02 quint16 streamVersion;
03 QDataStream in(&file);
04 in >> magic >> streamVersion;
05 if (magic != MagicNumber) {
06 cerr << "File is not recognized by this application" << endl;
07 return false;
08 } else if (streamVersion > in.version()) {
09 cerr << "File is from a more recent version of the application"
10 << endl;
11 return false;
12 }
13 in.setVersion(streamVersion);
Мы можем считывать данные, если версия потока меньше или совпадает с версией, используемой в приложении; в противном случае мы выдаем сообщение об ошибке.
Если файл использует формат с собственным номером версии, мы можем его использовать для определения номера версии потока, а не хранить этот номер в явном виде. Предположим, что файл сформирован в формате версии 1.3 нашего приложения. Тогда мы могли бы записать данные следующим образом:
QDataStream out(&file);
out.setVersion(QDataStream::Qt_4_1);
out << quint32(MagicNumber) << quint16(0x0103);
При считывании данных мы определяем версию QDataStream на основе номера версии приложения:
01 QDataStream in(&file);
02 in >> magic >> appVersion;
03 if (magic != MagicNumber) {
04 cerr << "File is not recognized by this application" << endl;
05 return false;
06 } else if (appVersion > 0x0103) {
07 cerr << "File is from a more recent version of the application"
08 << endl;
09 return false;
10 }
11 if (appVersion < 0x0103) {
12 in.setVersion(QDataStream::Qt_3_0);
13 } else {
14 in.setVersion(QDataStream::Qt_4_1);
15 }
В этом примере мы говорим, что для любого файла, сохраненного в приложении с версией меньшей, чем 1.3, используется версия 4 потока данных (Qt_3_0), а для файлов, сохраненных в приложении с версией 1.3, используется версия 7 потока данных (Qt_4_1).
Итак, существует три политики работы с версиями потоков данных QDataStream: жесткое кодирование номера версии, запись и чтение номера версии в явном виде и использование различных жестко закодированных номеров версий в зависимости от версии приложения. Можно применять любую из этих политик для гарантирования чтения данных новой версией приложения, записанных в старой версии, даже если сборка новой версии приложения выполняется с более свежей версией Qt. После выбора политики обработки версий QDataStream чтение и запись двоичных данных в Qt становятся простыми и надежными.
Если мы хотим выполнить чтение или запись за один шаг, мы не должны использовать QDataStream, а вместо этого мы должны вызывать функции write() и readAll() класса QIODevice. Например:
01 bool copyFile(const QString &source, const QString &dest)
02 {
03 QFile sourceFile(source);
04 if (!sourceFile.open(QIODevice::ReadOnly))
05 return false;
06 QFile destFile(dest);
07 if (!destFile.open(QIODevice::WriteOnly))
08 return false;
09 destFile.write(sourceFile.readAll());
10 return sourceFile.error() == QFile::NoError
11 && destFile.error() == QFile::NoError;
12 }
В строке, где вызывается readAll(), все содержимое входного файла считывается в QByteArray, который затем передается функции write() для записи в выходной файл. Хранение всех данных в QByteArray ведет к большему расходу памяти, чем при последовательном чтении элементов, однако это дает некоторые преимущества. Например, мы можем затем использовать функции qCompress() и qUncompress() для упаковки и распаковки данных.
Существуют другие сценарии, когда прямой доступ к QIODevice оказывается более подходящим, чем использование QDataStream. Класс QIODevice имеет функцию peek(), которая возвращает следующие байты данных, перемещая позицию устройства, а также функцию ungetChar(), которая возвращает считанный байт в поток. Эти функции работают как на устройствах произвольного доступа (таких, как файлы), так и на последовательных устройствах (таких, как сетевые сокеты). Имеется также функция seek(), которая используется для установки позиции устройств, поддерживающих произвольный доступ.
Двоичные форматы файлов являются наиболее универсальным и компактным средством хранения данных, a QDataStream позволяет легко получить доступ к двоичным данным. Кроме примеров в данном разделе мы уже видели в , как QDataStream применяется для чтения и записи файлов в приложении Электронная таблица, и мы снова встретим этот класс в , где он будет использоваться для чтения и записи файлов курсоров в системе Windows.
Чтение и запись текста
Хотя двоичные форматы файлов обычно более компактные, чем текстовые форматы, они плохо воспринимаются человеком и не могут им редактироваться. Там, где последнее играет важную роль, можно использовать текстовые форматы. Qt предоставляет класс QTextStream для чтения и записи простых текстовых файлов или файлов других текстовых форматов, например HTML, XML, и файлы исходных текстов программ. Работа с XML—файлами рассматривается отдельно в .
QTextStream обеспечивает преобразование между Unicode и локальной кодировкой системы или любой другой кодировкой и незаметно для пользователя справляется с различными соглашениями относительно окончаний строк, принятыми в разных операционных системах («\r\n» в Windows, «\n» в Unix и Mac OS X). QTextStream использует 16-битовый тип QChar в качестве основного элемента данных. Кроме символов и строк QTextStream поддерживает основные числовые типы С++, преобразуя их в строку и обратно. Например, в следующем фрагменте программного кода выполняется запись строки «Thomas M. Disch: 334\n» в файл sf-book.txt:
QFile file("sf-book.txt");
if (!file.open(QIODevice::WriteOnly)) {
cerr << "Cannot open file for writing: "
<< qPrintable(file.errorString()) << endl;
return;
}
QTextStream out(&file);
out << "Thomas M. Disch: " << 334 << endl;
Записать текст очень просто, однако его чтение может оказаться трудной задачей, поскольку текстовый формат данных (в отличие от двоичного формата данных, записанных с помощью QDataStream) в принципе двусмысленный. Давайте рассмотрим следующий пример:
out << "Norway" << "Sweden";
Если out является объектом типа QTextStream, то данные в действительности записываются в виде строки «NorwaySweden». Мы не можем рассчитывать на то, что приведенная ниже строка правильно считает данные:
in >> str1 >> str2;
Фактически произойдет то, что строка str1 получит все слово «NorwaySweden», а строка str2 ничего не получит. При использовании класса QDataStream не возникнет таких трудностей, поскольку он сохраняет длину каждой строки в начале символьных данных.
Для сложных форматов файлов может потребоваться полнофункциональный парсер. Такой парсер мог бы считывать символ за символом при помощи оператора >> для типа QChar или строку за строкой при помощи функции QTextStream::readLine(). В конце этого раздела мы представим два небольших примера, в одном из которых входной файл считывается построчно, а в другом он считывается посимвольно. Для того чтобы использовать парсеры, работающие с целым текстом, мы могли бы считать весь файл за один шаг, используя функцию QTextStream::readAll(), если бы нас не волновал расход памяти или если бы мы знали, что файл будет небольшим.
По умолчанию QTextStream использует локальную кодировку системы (например, ISO 8859-1 или ISO 8859-15 в Америке и в большей части Европы) при чтении и записи. Это можно изменить, используя функцию setCodec():
stream.setCodec("UTF-8");
В этом примере используется кодировка UTF-8, совместимая с популярной кодировкой ASCII и позволяющая представить весь набор символов Unicode. Дополнительная информация о кодировке Unicode и о поддержке кодировок классом QTextStream приводится в («Интернационализация»).
QTextStream имеет различные опции, аналогичные опциям . Установить опции можно путем передачи в поток специальных объектов — манипуляторов потока. В следующем примере устанавливаются опции showbase, uppercasedigits и hex перед выводом целого числа 12345678, и в результате получается текст «0xBC614E»:
out << showbase << uppercasedigits << hex << 12345678;
Ниже перечислены функции, устанавливающие опции для QTextStream (рис. 12.1):
• setIntegerBase(int):
0 — основание обнаруживается автоматически по префиксу (при чтении),
2 — двоичное представление,
8 — восьмеричное представление,
10 — десятичное представление,
16 — шестнадцатеричное представление.
• setNumberFlags(NumberFlags):
ShowBase — показывать префикс для оснований 2 («0b»), 8 («0») или 16 («0x»),
ForceSign — всегда показывать знак перед числами,
ForcePoint — всегда показывать десятичную точку,
UppercaseBase — префиксы оснований выдавать на верхнем регистре,
UppercaseDigits — буквы шестнадцатеричных чисел выдавать на верхнем регистре.
• setRealNumberNotation(RealNumberNotation):
FixedNotation — формат с фиксированной точкой (например, 0.000123),
ScientificNotation — научный формат (например, 0.12345678e-04),
SmartNotation — формат с фиксированной точкой или научный формат в зависимости от того, какой из них компактнее.
• setRealNumberPrecision(int) — устанавливает максимальное количество генерируемых цифр (по умолчанию 6).
• setFieldWidth(int) — устанавливает минимальный размер поля.
• setFieldAlignment(FieldAlignment):
AlignLeft — выравнивание влево, заполнитель занимает правую часть поля,
AlignRight — выравнивание вправо, заполнитель занимает левую часть поля,
AlignCenter — выравнивание по центру, заполнитель занимает оба края поля,
AlignAccountingStyle — заполнитель занимает область между знаком и числом.
• setPadChar(QChar) — устанавливает символ, используемый в качестве заполнителя (пробел по умолчанию).
Опции можно также устанавливать с помощью функций—членов:
out.setNumberFlags(QTextStream::ShowBase
| QTextStream::UppercaseDigits);
out.setIntegerBase(16);
out << 12345678;
Класс QTextStream, как и QDataStream, работает с каким-нибудь подклассом QIODevice: QFile, QTemporaryFile, QBuffer, QProcess, QTcpSocket или QUdpSocket. Кроме того, его можно использовать непосредственно со строкой типа QString. Например:
QString str;
QTextStream(&str) << oct << 31 << " " << dec << 25 << endl;
В результате переменная str будет иметь значение «37 25\n», поскольку десятичное число 31 представляется восьмеричным числом 37. В данном случае не требуется устанавливать кодировку, поскольку QString всегда использует Unicode.
Теперь рассмотрим простой пример текстового формата файлов. В приложении Электронная таблица, описанном в , мы использовали двоичный формат для хранения данных этого приложения. Данные представляют собой последовательность троек (строка, столбец, формула) — по одной на каждую непустую ячейку. Запись данных в виде текста выполняется просто; ниже показан фрагмент пересмотренной версии функции Spreadsheet::writeFile():
QTextStream out(&file);
for (int row = 0; row < RowCount; ++row) {
for (int column = 0; column < ColumnCount; ++column) {
QString str = formula(row, column);
if (!str.isEmpty())
out << row << " " << column << " " << str << endl;
}
}
Мы использовали простой формат, когда одна строка соответствует одной ячейке, причем пробелы разделяют номер строки и номер столбца, а также номер столбца и формулу. Формула может содержать пробелы, но мы предполагаем, что она не может содержать ни одного символа '\n' (который используется для завершения строки). Теперь давайте рассмотрим соответствующий программный код, предназначенный для чтения файла:
QTextStream in(&file);
while (!in.atEnd()) {
QString line = in.readLine();
QStringList fields = line.split(' ');
if (fields.size() >= 3) {
int row = fields.takeFirst().toInt();
int column = fields.takeFirst().toInt();
setFormula(row, column, fields.join(' '));
}
}
Мы считываем одним оператором одну строку данных приложения Электронная таблица. Функция readLine() удаляет завершающий символ '\n'. Функция QString::split() возвращает список строк, разбивая строку на части согласно обнаруженным символам—разделителям. Например, при обработке строки «5 19 Total value» будет получен список из четырех элементов [«5», «19», «Total», «value»].
Данные могут быть извлечены, если имеется по крайней мере три поля. Функция QStringList::takeFirst() удаляет первый элемент списка и возвращает удаленный элемент. Мы используем ее для извлечения номеров строк и столбцов. Мы не делаем никакой проверки ошибок; если считываемый номер строки или номер столбца оказывается не числом, функция QString::toInt() возвратит 0. Вызывая функцию setFormula(), мы помещаем оставшиеся поля в одну строку.
В нашем втором примере с QTextStream мы будем посимвольно считывать текстовый файл и затем выводить этот же текст, удаляя из строки завершающие пробелы и заменяя символы табуляции пробелами. Всю эту работу делает функция tidyFile():
01 void tidyFile(QIODevice *inDevice, QIODevice *outDevice)
02 {
03 QTextStream in(inDevice);
04 QTextStream out(outDevice);
05 const int TabSize = 8;
06 int endlCount = 0;
07 int spaceCount = 0;
08 int column = 0;
09 QChar ch;
10 while (!in.atEnd()) {
11 in >> ch;
12 if (ch == '\n') {
13 ++endlCount;
14 spaceCount = 0;
15 column = 0;
16 } else if (ch == '\t') {
17 int size = TabSize - (column % TabSize);
18 spaceCount += size;
19 column += size;
20 } else if (ch == ' ') {
21 ++spaceCount;
22 ++column;
23 } else {
24 while (endlCount > 0) {
25 out << endl;
26 --endlCount;
27 column = 0;
28 }
29 while (spaceCount > 0) {
30 out << ' ';
31 --spaceCount;
32 ++column;
33 }
34 out << ch;
35 ++column;
36 }
37 }
38 out << endl;
39 }
Мы создаем для ввода и вывода данных объекты QTextStream, полученные на базе устройств QIODevice, переданных конструктору. Мы поддерживаем три переменные для контроля состояния: счетчик новых строк, счетчик пробелов и текущую позицию столбца в текущей строке (для преобразования символов табуляции в правильное количество пробелов).
Синтаксический анализ выполняется в цикле while, на каждом шаге которого считывается из входного файла один символ. В этой функции в некоторых местах делаются тонкие вещи. Например, хотя TabSize устанавливается на значение 8, мы заменяем символы табуляции достаточно точным числом пробелов, чтобы достигнуть следующей метки табуляции, а не грубо заменять каждый символ табуляции восемью пробелами. При встрече символа новой строки, символа табуляции и пробелов мы просто обновляем состояние данных. Только при получении символа нового вида мы выполняем вывод данных, а перед записью символа записываем ожидающие вывода символы новой строки и пробелы (чтобы учесть пробельные строки и сохранить отступы) и обновляем состояние.
01 int main()
02 {
03 QFile inFile;
04 QFile outFile;
05 inFile.open(stdin, QFile::ReadOnly);
06 outFile.open(stdout, QFile::WriteOnly);
07 tidyFile(&inFile, &outFile);
08 return 0;
09 }
В этом примере не нужен объект QApplication, потому что мы используем только инструментальные классы Qt. Список всех инструментальных классов приводится на веб-странице . Мы предполагаем, что эта программа используется как фильтр, например:
tidy < cool.cpp > cooler.cpp
Эту программу можно легко расширить, позволяя ей работать с именами файлов, указанными в командной строке, если они заданы, а в противном случае использовать ее для фильтрации потока ввода cin в поток вывода cout.
Поскольку это приложение консольное, его файл .pro немного отличается от используемого нами в приложениях с графическим интерфейсом:
TEMPLATE = app
QT = core
CONFIG += console
CONFIG -= app_bundle
SOURCES = tidy.cpp
Мы собираем приложение только с QtCore, поскольку здесь не используется функциональность графического пользовательского интерфейса. Затем мы указываем, что необходимо включить консольный вывод в Windows и не нужно размещать приложение в каталоге (bundle) приложений системы Mac OS X.
При чтении и записи простых ASCII—файлов и файлов с кодировкой ISO 8859-1 (Latin-1) можно непосредственно использовать программный интерфейс QIODevice вместо класса QTextStream. Поступать так имеет смысл только в редких случаях, поскольку в большинстве приложений требуется в некоторых случаях поддержка других кодировок и только QTextStream обеспечивает такую поддержку безболезненно. Если вы все-таки хотите писать текст непосредственно на устройство QIODevice, необходимо явно указать флажок QIODevice::Text в функции open(), например:
file.open(QIODevice::WriteOnly | QIODevice::Text);
Этот флажок говорит устройству QIODevice о том, что при записи в системе Windows необходимо преобразовывать символы '\n' в последовательность «\r\n». При чтении он говорит устройству, что необходимо игнорировать символы '\r' при работе на любой платформе. Теперь можно рассчитывать на то, что конец каждой строки обозначается символом новой строки '\n' вне зависимости от принятых на этот счет соглашений в операционной системе.
Работа с каталогами
Класс QDir обеспечивает независимые от платформы средства работы с каталогами и получение информации о файлах. Для демонстрации способов применения класса QDir мы напишем небольшое консольное приложение, которое подсчитывает размер дискового пространства, занимаемого всеми изображениями в указанном каталоге во всех его подкаталогах, вне зависимости от глубины их расположения.
Основу приложения составляет функция imageSpace(), которая рекурсивно подсчитывает общий размер изображений в заданном каталоге:
01 qlonglong imageSpace(const QString &path)
02 {
03 qlonglong size = 0;
04 QDir dir(path);
05 QStringList filters;
06 foreach (QByteArray format, QImageReader::supportedImageFormats())
07 filters += "*." + format;
08 foreach (QString file, dir.entryList(filters, QDir::Files))
09 size += QFileInfo(dir, file).size();
10 foreach (QString subDir, dir.entryList(QDir::Dirs
11 | QDir::NoDotAndDotDot))
12 size += imageSpace(path + QDir::separator() + subDir);
13 return size;
14 }
Мы начнем с создания объекта QDir для заданного пути, который может задаваться относительно текущего каталога или в виде полного пути. Мы передаем функции entryList() два аргумента. Первый аргумент содержит список фильтров имен файлов, разделенных пробелами. Шаблоны этих фильтров могут содержать символы «*» и «?». В этом примере мы применяем фильтры для включения только тех файлов, которые может считывать QImage. Второй аргумент задает тип нужных нам элементов (обычные файлы, каталоги, дисководы и так далее).
Мы выполняем цикл по списку файлов, подсчитывая их совокупный размер. Класс QFileInfo позволяет нам осуществлять доступ к таким атрибутам файлов, как их размер, права доступа, владелец и времена создания, изменения и последнего доступа.
Второй вызов функции entryList() получает все подкаталоги данного каталога. Мы выполняем цикл по ним (исключая . и ..) и рекурсивно вызываем функцию imageSpace() для получения совокупного размера изображений.
Для образования пути к каждому подкаталогу мы к текущему каталогу подсоединяем имя подкаталога, разделяя их слешем. Класс QDir использует символ «/» в качестве разделителя каталогов на всех платформах и распознает символ «\» в системе Windows. Представляя пути пользователю, мы можем вызвать статическую функцию QDir::convertSeparators() для преобразования слешей в соответствующий разделитель конкретной платформы.
Давайте добавим функцию main() в нашу небольшую программу:
01 int main(int argc, char *argv[])
02 {
03 QCoreApplication app(argc, argv);
04 QStringList args = app.arguments();
05 QString path = QDir::currentPath();
06 if (args.count() > 1)
07 path = args[1];
08 cout << "Space used by images in " << qPrintable(path)
09 << " and its subdirectories is "
10 << (imageSpace(path) / 1024) << " KB" << endl;
11 return 0;
12 }
Мы используем функцию QDir::currentPath() для получения пути текущего каталога. Мы могли бы поступить по-другому и использовать функцию QDir::homePath() для получения домашнего каталога пользователя. Если пользователь указал путь в командной строке, мы используем именно его. Наконец, мы вызываем нашу функцию imageSpace() для расчета размера пространства, занимаемого изображениями.
Класс QDir содержит и другие функции для работы с файлами и каталогами, включая entryInfoList() (которая возвращает список объектов QFileInfo), rename(), exists(), mkdir() и rmdir(). Класс QFile содержит несколько удобных статических функций, в том числе remove() и exists().
Ресурсы, внедренные в исполняемый модуль
До сих пор в этой главе мы говорили о доступе к данным, которые находятся на внешних устройствах, но в Qt можно также внедрять двоичные данные или текст в исполняемый модуль приложения. Это обеспечивается ресурсной системой Qt. В других главах мы использовали файлы ресурсов для внедрения файлов изображений в исполняемый модуль, однако внедрять можно любой файл. Читать внедренные файлы можно с использованием QFile, как будто это обычные файлы, расположенные в файловой системе.
Ресурсы преобразуются в программный код С++ ресурсным компилятором Qt (rcc). Мы можем указать qmake, что необходимо включить специальные правила для выполнения rcc, добавляя следующую строку в файл .pro:
RESOURCES = myresourcefile.qrc
Файл myresourcefile.qrc — это XML—файл, который содержит список файлов, внедренных в исполняемый модуль.
Допустим, создается приложение, которое сохраняет подробную контактную информацию. Ради удобства пользователей мы хотим внедрить международные телефонные коды в исполняемый модуль. Если файл находится в подкаталоге datafiles каталога сборки приложения, файл ресурсов может выглядеть следующим образом:
datafiles/phone-codes.dat
В приложении ресурсы опознаются по префиксу пути :/. В этом примере файл телефонных кодов имеет путь :/datafiles/phone-codes.dat и может быть считан как любой другой файл, используя QFile.
Преимуществом внедрения данных в исполняемый модуль является невозможность их потери и возможность создания действительно автономных исполняемых модулей (если использовалась статическая компоновка). Двумя недостатками являются необходимость замены всего исполняемого модуля при изменении внедренных данных и увеличение размера исполняемого модуля из-за дополнительного расхода памяти под внедренные данные.
Ресурсная система Qt обладает дополнительными возможностями, которые не представлены в этом примере, включая поддержку псевдонимов файлов и локализацию. Информацию по этим возможностям можно найти на веб-странице
Связь между процессами
Класс QProcess позволяет выполнять внешние программы и взаимодействовать с ними. Этот класс работает асинхронно и в фоновом режиме, из-за чего интерфейс пользователя по-прежнему будет реагировать на действия пользователя. QProcess посылает сигналы, уведомляющие нас о получении данных или о завершении работы.
Мы кратко рассмотрим программный код небольшого приложения, обеспечивающего интерфейс пользователя для внешней программы преобразования изображений. В нашем случае мы используем программу convert из пакета программ ImageMagick, который свободно распространяется на всех основных платформах.
Рис. 12.2. Приложение Image Converter.
Интерфейс пользователя приложения Image Converter (конвертор изображений) был создан при помощи Qt Designer. Файл .ui находится на компакт-диске, который входит в состав данной книги. Здесь мы основное внимание уделим подклассу, который является наследником сгенерированного компилятором uic класса Ui::ConvertDialog, и начнем с заголовочного файла:
01 #ifndef CONVERTDIALOG_H
02 #define CONVERTDIALOG_H
03 #include
04 #include
05 #include "ui_convertdialog.h"
06 class ConvertDialog : public QDialog,
07 public Ui::ConvertDialog
08 {
09 Q_OBJECT
10 public:
11 ConvertDialog(QWidget *parent = 0);
12 private slots:
13 void on_browseButton_clicked();
14 void on_convertButton_clicked();
15 void updateOutputTextEdit();
16 void processFinished(int exitCode, QProcess::ExitStatus exitStatus);
17 void processError(QProcess::ProcessError error);
18 private:
19 QProcess process;
20 QString targetFile;
21 };
22 #endif
Этот заголовочный файл создается по тому знакомому образцу, который используется в подклассах форм Qt Designer. Благодаря механизму автоматического связывания QtDesigner слоты on_browseButton_clicked() и on_convertButton_clicked() автоматически связываются с сигналом clicked() кнопок Browse (просмотреть) и Convert (преобразовать).
01 ConvertDialog::ConvertDialog(QWidget *parent)
02 : QDialog(parent)
03 {
04 setupUi(this);
05 connect(&process, SIGNAL(readyReadStandardError()),
06 this, SLOT(updateOutputTextEdit()));
07 connect(&process, SIGNAL(finished(int, QProcess::ExitStatus)),
08 this, SLOT(processFinished(int, QProcess::ExitStatus)));
09 connect(&process, SIGNAL(error(QProcess::ProcessError)),
10 this, SLOT(processError(QProcess::ProcessError)));
11 }
Вызов setupUi() создает и компонует все виджеты форм, устанавливает соединения сигнал—слот для слотов on_objectName_signalName() и связывает кнопку Quit (выйти) с функцией QDialog::accept(). После этого мы вручную связываем три сигнала объекта QProcess с тремя закрытыми слотами. Любые сообщения внешнего процесса для потока cerr мы будем обрабатывать в функции updateOutputTextEdit().
01 void ConvertDialog::on_browseButton_clicked()
02 {
03 QString initialName = sourceFileEdit->text();
04 if (initialName.isEmpty())
05 initialName = QDir::homePath();
06 QString fileName = QFileDialog::getOpenFileName(this,
07 tr("Choose File"), initialName);
08 fileName = QDir::convertSeparators(fileName);
09 if (!fileName.isEmpty()) {
10 sourceFileEdit->setText(fileName);
11 convertButton->setEnabled(true);
12 }
13 }
Сигнал clicked() кнопки Browse (просмотреть) автоматически связывается в функции setupUi() со слотом on_browseButton_clicked(). Если пользователь ранее выбирал какой-нибудь файл, мы инициализируем диалоговое окно выбора файла именем этого файла; в противном случае мы используем домашний каталог пользователя.
01 void ConvertDialog::on_convertButton_clicked()
02 {
03 QString sourceFile = sourceFileEdit->text();
04 targetFile = QFileInfo(sourceFile).path()
05 + QDir::separator() + QFileInfo(sourceFile).baseName()
06 + "." + targetFormatComboBox->currentText().toLower();
07 convertButton->setEnabled(false);
08 outputTextEdit->clear();
09 QStringList args;
10 if (enhanceCheckBox->isChecked())
11 args << "-enhance";
12 if (monochromeCheckBox->isChecked())
13 args << "-monochrome";
14 args << sourceFile << targetFile;
15 process.start("convert", args);
16 }
Когда пользователь нажимает кнопку Convert (преобразовать), мы копируем имя исходного файла и изменяем его расширение в соответствии с новым форматом файла. Мы используем зависимый от платформы разделитель каталогов ('/' или '\' возвращается функцией QDir::separator()) вместо жесткого кодирования этих символов, поскольку пользователь будет видеть имя файла.
Затем отключаем кнопку Convert, чтобы пользователь не мог случайно запустить одновременно несколько процессов преобразования, и очищаем поле текстового редактора, используемое нами для отображения информации о состоянии.
Для инициирования внешнего процесса мы вызываем функцию QProcess::start() с именем программы, которая должна выполняться (convert), и всеми ее аргументами. В данном случае мы передаем флажки -enhance и -monochrome, если пользователь выбрал соответствующие опции, и затем имена исходного и целевого файлов. Тип выполняемого преобразования программа convert определяет по расширениям файлов.
01 void ConvertDialog::updateOutputTextEdit()
02 {
03 QByteArray newData = process.readAllStandardError();
04 QString text = outputTextEdit->toPlainText()
05 + QString::fromLocal8Bit(newData);
06 outputTextEdit->setPlainText(text);
07 }
При всякой записи внешним процессом в поток cerr вызывается слот updateOutputTextEdit(). Мы считываем текст сообщения об ошибке и добавляем его в существующий текст QTextEdit.
01 void ConvertDialog::processFinished(int exitCode,
02 QProcess::ExitStatus exitStatus)
03 {
04 if (exitStatus == QProcess::CrashExit) {
05 outputTextEdit->append(tr("Conversion program crashed"));
06 } else if (exitCode != 0) {
07 outputTextEdit->append(tr("Conversion failed"));
08 } else {
09 outputTextEdit->append(tr("File %1 created").arg(targetFile));
10 }
11 convertButton->setEnabled(true);
12 }
По окончании процесса мы уведомляем пользователя о результате и включаем кнопку Convert.
01 void ConvertDialog::processError(QProcess::ProcessError error)
02 {
03 if (error == QProcess::FailedToStart) {
04 outputTextEdit->append(tr("Conversion program not found"));
05 convertButton->setEnabled(true);
06 }
07 }
Если процесс не удается запустить, QProcess генерирует сигнал error() вместо finished(). Мы выдаем сообщение об ошибке и включаем кнопку Convert.
В этом примере преобразования файлов выполнялись асинхронно, т.е. QProcess запускал программу convert и сразу же возвращал управление приложению. Это сохраняет работоспособность пользовательского интерфейса во время выполнения преобразований в фоновом режиме. Но в некоторых ситуациях необходимо, чтобы внешний процесс завершился, и только после этого мы сможем идти дальше в нашем приложении; в таких случаях требуется синхронная работа QProcess.
Одним из распространенных примеров, где желателен синхронный режим работы, является приложение, обеспечивающее редактирование простых текстов с применением текстового редактора, предпочитаемого пользователем. Такое приложение реализуется достаточно просто с помощью QProcess. Например, пусть в QTextEdit содержится простой текст и имеется кнопка Edit, при нажатии на которую выполняется слот edit().
01 void ExternalEditor::edit()
02 {
03 QTemporaryFile outFile;
04 if (!outFile.open())
05 return;
06 QString fileName = outFile.fileName();
07 QTextStream out(&outFile);
08 out << textEdit->toPlainText();
09 outFile.close();
10 QProcess::execute(editor, QStringList() << options << fileName);
11 QFile inFile(fileName);
12 if (!inFile.open(QIODevice::ReadOnly))
13 return;
14 QTextStream in(&inFile);
15 textEdit->setPlainText(in.readAll());
16 }
Мы используем QTemporaryFile для создания пустого файла с уникальным именем. Мы не задаем аргументы функции QTemporaryFile::open(), поскольку для нас подходит ее режим по умолчанию, по которому файл открывается для чтения и записи. Мы записываем содержимое поля редактирования во временный файл и затем закрываем файл, потому что некоторые текстовые редакторы не могут работать с уже открытыми файлами.
Статическая функция QProcess::execute() запускает внешний процесс и блокирует работу приложения до завершения процесса. Аргумент editor в строке типа QString содержит имя исполняемого модуля редактора (например, «gvim»). Аргумент options является списком QStringList (который содержит один элемент, «—f», если мы используем gvim).
После закрытия пользователем текстового редактора процесс завершает свою работу и функция execute() возвращает управление. Затем мы открываем временный файл и считываем его содержимое в QTextEdit. QTemporaryFile автоматически удаляет временный файл, когда объект выходит из области видимости.
При синхронной работе QProcess нет необходимости устанавливать соединения сигнал—слот. Если требуется более тонкое управление, чем то, которое обеспечивает статическая функция execute(), мы можем использовать альтернативный подход. Это означает создание объекта QProcess и вызов для него функции start() с последующей установкой блокировки путем вызова функции QProcess::waitForStarted(), после успешного завершения которой вызывается функция QProcess::waitForFinished(). Пример применения этого подхода можно найти в справочной документации по классу QProcess.
В данном разделе мы использовали QProcess, чтобы получить доступ к уже существующей функциональности. Применение уже имеющегося приложения может сократить время разработки и избавить нас от лишних деталей, которые играют второстепенную роль при достижении главной цели нашего приложения. Другой способ получения доступа к уже существующей функциональности заключается в компоновке приложения с соответствующей библиотекой. Но если нет подходящей библиотеки, хорошим решением может быть запуск консольного приложения с помощью QProcess.
QProcess может также применяться для запуска других приложений с графическим пользовательским интерфейсом, например веб—браузера или почтового клиента. Однако если нашей целью является связь между приложениями, а не просто запуск одного из другого, то лучше установить прямую связь между приложениями, используя Qt—классы, предназначенные для работы с сетью, или расширение ActiveQt для Windows.
Глава 13. Базы данных
Модуль QtSql средств разработки Qt обеспечивает независимый от платформы и типа базы данных интерфейс для доступа с помощью языка SQL к базам данных. Этот интерфейс поддерживается набором классов, использующих архитектуру Qt модель/представление для интеграции средств доступа к базам данных с интерфейсом пользователя. Эта глава предполагает знакомство с Qt—классами архитектуры модель/представление, рассмотренными в .
Связь с базой данных обеспечивается объектом QSqlDatabase. Qt использует драйверы для связи с программным интерфейсом различных баз данных. Версия Qt для настольных компьютеров (Qt Desktop Edition) включает в себя следующие драйверы:
QDB2 — IBM DB2 версии 7.1 и выше,
QIBASE — InterBase компании Borland,
QMYSQL — MySQL,
QOCI — Oracle (Oracle Call Interface, интерфейс вызовов Oracle),
QODBC — ODBC (включает Microsoft SQL Server),
QPSQL — PostgreSQL версий 6.x и 7.x,
QSQLITE — SQLite версии 3 и выше,
QSQLITE2 — SQLite версии 2,
QTDS — Sybase Adaptive Server.
Из-за лицензионных ограничений не все драйверы входят в состав издания Qt с открытым исходным кодом (Qt Open Source Edition). При настройке конфигурации Qt драйверы SQL можно либо непосредственно включить в состав Qt, либо использовать как подключаемые модули (plugins). Qt поставляется вместе с SQLite — общедоступной, не нуждающейся в сервере базой данных.
Для пользователей, хорошо знакомых с синтаксисом SQL, класс QSqlQuery предоставляет средства, позволяющие непосредственно выполнять произвольные команды SQL и обрабатывать их результаты. Для пользователей, предпочитающих иметь дело с высокоуровневым интерфейсом базы данных, который не требует знания синтаксиса SQL, классы QSqlTableModel и QSqlRelationalTableModel являются подходящими абстракциями. Эти классы представляют таблицы SQL в том же виде, как и классы других моделей Qt (рассмотренных в ). Они могут использоваться самостоятельно для кодирования в программе просмотра и редактирования данных или могут подключаться к представлениям, с помощью которых конечные пользователи будут сами просматривать и редактировать данные.
Qt также позволяет легко программировать такие распространенные идиомы баз данных, как отображение зависимых представлений для записей, связанных отношением «главная—подчиненные» (master—detail), и возможность многократной детализации выводимых на экран данных (drill-down), что продемонстрируют некоторые примеры этой главы.
Соединение с базой данных и выполнение запросов
Для выполнения запросов SQL мы должны сначала установить соединение с базой данных. Обычно настройка соединений с базой данных выполняется отдельной функцией, которую мы вызываем при запуске приложения. Например:
01 bool createConnection()
02 {
03 QSqlDatabase *db = QSqlDatabase::addDatabase("QOCI8");
04 db->setHostName("mozart.konkordia.edu");
05 db->setDatabaseName("musicdb");
06 db->setUserName("gbatstone");
07 db->setPassword("T17aV44");
08 if (!db->open()) {
09 db->lastError().showMessage();
10 return false;
11 }
12 return true;
13 }
Во-первых, мы вызываем функцию QSqlDatabase::addDatabase() для создания объекта QSqlDatabase. Первый аргумент функции addDatabase() задает драйвер базы данных, который Qt должна использовать для доступа к базе данных. В данном случае мы используем MySQL (??? — в коде QOCI, Oracle Call Interface).
Затем мы устанавливаем имя хоста базы данных, имя базы данных, имя пользователя и пароль, и мы открываем соединение. Если функция open() завершается неудачей, мы выводим сообщение об ошибке, используя QSqlError::showMessage().
Обычно функцию createConnection() вызывают в main():
01 int main(int argc, char *argv[])
02 {
03 QApplication app(argc, argv);
04 if (!createConnection())
05 return 1;
06 return app.exec();
07 }
После установки соединения мы можем применять QSqlQuery для выполнения любой инструкции SQL, поддерживаемой используемой базой данных. Ниже приводится пример выполнения команды SELECT:
QSqlQuery query;
query.exec("SELECT title, year FROM cd WHERE year >= 1998");
После вызова функции exec() мы можем просмотреть результат запроса:
while (query.next()) {
QString title = query.value(0).toString();
int year = query.value(1).toInt();
cerr << qPrintable(title) << ": " << year << endl;
}
Мы вызываем функцию next() один раз для позиционирования QSqlQuery на первую запись полученного набора. Последующие вызовы next() продвигают указатель записи на одну позицию дальше, пока не будет достигнут конец, когда функция next() возвращает false. Если результирующий набор (result set) пустой (или запрос завершается неудачей), первый вызов функции next() возвратит false.
Функция value() возвращает значение поля, как QVariant. Поля пронумерованы начиная с 0 в порядке их указания в команде SELECT. Класс QVariant может содержать многие типы С++ и Qt, включая int и QString. Другие типы данных, которые могут храниться в базе данных, преобразуются в соответствующие типы С++ и Qt и хранятся в QVariant. Например, VARCHAR представляется в виде QString, a DATETIME — в виде QDateTime.
Класс QSqlQuery содержит некоторые другие функции для просмотра результирующего набора: first(), last(), previous() и seek(). Эти функции удобны, но для некоторых баз данных они могут выполняться медленнее и расходовать памяти больше, чем функция next(). При работе с большими наборами данных мы можем осуществить простую оптимизацию, вызывая функцию QSqlQuery::setForwardOnly(true) перед вызовом exec(), и только затем использовать next() для просмотра результирующего набора.
Ранее мы задавали запрос SQL в аргументе функции QSqlQuery::exec(), но, кроме того, мы можем передавать его непосредственно конструктору, который сразу же выполнит его:
QSqlQuery query("SELECT title, year FROM cd WHERE year >= 1998");
Мы можем проверить наличие ошибки, вызывая функцию isActive() для запроса:
if (!query.isActive())
QMessageBox::warning(this, tr("Database Error"),
query.lastError().text());
Если ошибки нет, запрос становится «активным» и мы можем использовать next() для перемещения по результирующему набору.
Выполнение команды INSERT осуществляется почти так же просто, как и команды SELECT:
QSqlQuery query("INSERT INTO cd (id, artistid, title, year) "
"VALUES (203, 102, 'Living in America', 2002)");
После этого функция numRowsAffected() возвращает количество строк, которые были изменены инструкцией SQL (или —1, если возникла ошибка).
Если нам необходимо вставлять много записей или если мы хотим избежать преобразования значений в строковые данные (и правильного преобразования специальных символов), мы можем использовать функцию prepare() для указания полей в шаблоне запроса и затем присваивания им необходимых нам значений. Qt поддерживает как стиль Oracle, так и стиль ODBC для всех баз данных, применяя, где возможно, «родной» интерфейс базы данных или имитируя его в противном случае. Ниже приводится пример, в котором используется синтаксис Oracle для представления поименованных полей:
QSqlQuery query;
query.prepare("INSERT INTO cd (id, artistid, title, year) "
"VALUES (:id, :artistid, :title, :year)");
query.bindValue(":id", 203);
query.bindValue(":artistid", 102);
query.bindValue(":title", "Living in America");
query.bindValue(":year", 2002);
query.exec();
Ниже приводится тот же пример позиционного представления полей в стиле ODBC:
QSqlQuery query;
query.prepare("INSERT INTO cd (id, artistid, title, year) "
"VALUES (?, ?, ?, ?)");
query.addBindValue(203);
query.addBindValue(102);
query.addBindValue("Living in America");
query.addBindValue(2002);
query.exec();
После вызова функции exec() мы можем вызвать bindValue() или addBindValue() для присваивания новых значений, затем снова вызвать exec() для выполнения запроса уже с новыми значениями.
Такие шаблоны часто используются для задания двоичных строковых данных, содержащих символы не в коде ASCII или Latin-1. Незаметно для пользователя Qt использует Unicode в тех базах данных, которые поддерживают Unicode, а в тех, которые не делают этого, Qt также незаметно для пользователя преобразует строковые данные в соответствующую кодировку.
Qt поддерживает SQL—транзакции в тех базах данных, где они предусмотрены. Для запуска транзакции мы вызываем функцию transaction() для объекта QSqlDatabase, представляющего соединение с базой данных. Для завершения транзакции мы вызываем либо функцию commit(), либо функцию rollback(). Например, ниже показано, как мы можем найти внешний ключ (foreign key) и выполнить команду INSERT внутри транзакции:
QSqlDatabase::database().transaction();
QSqlQuery query;
query.exec("SELECT id FROM artist WHERE name= 'Gluecifer'");
if (query.next()) {
int artistId = query.value(0).tolnt();
query.exec("INSERT INTO cd (id, artistid, title, year) "
"VALUES (201, " + QString::number(artistId)
+ ", 'Riding the Tiger', 1997)");
}
QSqlDatabase::database().commit();
Функция QSqlDatabase::database() возвращает объект QSqlDatabase, представляющий соединение, созданное нами при вызове createConnection(). Если транзакция не может запуститься, функция QSqlDatabase::transaction() возвращает false. Некоторые базы данных не поддерживают транзакции. В этом случае функции transaction(), commit() и rollback() ничего не делают. Мы можем проверить возможность поддержки базой данных транзакций путем вызова функции hasFeature() для объекта QSqlDriver, связанного с базой данных:
QSqlDriver *driver = QSqlDatabase::database().driver();
if (driver->hasFeature(QSqlDriver::Transactions))
…
Можно проверить наличие в базе данных ряда других возможностей, включая поддержку объектов BLOB (Binary Large Objects — большие двоичные объекты), Unicode и подготовленных запросов.
В приводимых до сих пор примерах мы предполагали, что в приложении используется одно соединение с базой данных. Если мы хотим создать несколько соединений, мы можем передавать название соединения в качестве второго аргумента функции addDatabase(). Например:
QSqlDatabase *db = QSqlDatabase::addDatabase("QPSQL", "OTHER");
db. setHostName("saturn.mcmanamy.edu");
db.setDatabaseName("starsdb");
db.setUserName("hilbert");
db.setPassword("ixtapa7");
Мы можем затем получить указатель на объект QSqlDatabase, передавая название соединения функции QSqlDatabase::database():
QSqlDatabase db = QSqlDatabase::database("OTHER");
Для выполнения запросов с другим соединением мы передаем объект QSqlDatabase конструктору QSqlQuery:
QSqlQuery query(db);
query.exec("SELECT id FROM artist WHERE name = 'Mando Diao'");
Несколько соединений полезны, если мы хотим выполнять одновременно несколько транзакций, поскольку каждое соединение может использоваться только для одной активной транзакции. Когда мы используем несколько соединений с базой данных, мы можем все-таки иметь одно непоименованное соединение и QSqlQuery будет использовать это соединение, если не указано поименованное соединение.
Кроме QSqlQuery Qt содержит класс QSqlTableModel — интерфейс высокого уровня, позволяя нам не использовать выражения SQL «в чистом виде» для выполнения наиболее распространенных SQL—команд (SELECT, INSERT, UPDATE и DELETE). Этот класс может использоваться автономно без какого-либо графического пользовательского интерфейса или в качестве источника данных для QListView или QTableView.
Ниже приводится пример использования QSqlTableModel для выполнения команды SELECT:
QSqlTableModel model;
model.setTable("cd");
model.setFilter("year >= 1998");
model.select();
Это эквивалентно запросу
SELECT * FROM cd WHERE year >= 1998
Просмотр результирующего набора выполняется путем получения заданной записи функцией QSqlTableModel::record() и доступа к отдельным полям с помощью функции value():
for (int i = 0; i < model.rowCount(); ++i) {
QSqlRecord record = model.record(i);
QString title = record.value("title").toString();
int year = record.value("year").toInt();
cerr << qPrintable(title) << ": " << year << endl;
}
Функция QSqlRecord::value() принимает либо имя поля, либо индекс поля. При работе с большими наборами данных рекомендуется задавать поля с помощью их индексов. Например:
int titleIndex = model.record().indexOf("title");
int yearIndex = model.record().indexOf("year");
for (int i = 0; i < model.rowCount(); ++i) {
QSqlRecord record = model.record(i);
QString title = record.value(titleIndex).toString();
int year = record.value(yearIndex).toInt();
cerr << qPrintable(title) << ": " << year << endl;
}
Для вставки записи в таблицу базы данных мы действуем так же, как если бы делали вставку в двумерную модель: сначала вызываем функцию insertRow() для создания новой пустой строки (записи) и затем используем setData() для установки значения каждого столбца (поля записи).
QSqlTableModel model;
model.setTable("cd");
int row = 0;
model.insertRows(row, 1);
model.setData(model.index(row, 0), 113);
model.setData(model.index(row, 1), "Shanghai My Heart");
model.setData(model.index(row, 2), 224);
model.setData(model.index(row, 3), 2003);
model.submitAll();
После вызова submitAll() запись может быть перемещена в другую позицию, зависящую от упорядоченности таблицы. Вызов submitAll() возвратит false, если вставка окажется неудачной.
Важным отличием модели SQL от стандартной модели является необходимость вызова в модели SQL функции submitAll() для записи всех изменений в базу данных
Для обновления записи мы должны сначала установить QSqlTableModel на запись, которую мы хотим модифицировать (например, используя функции select()). Затем мы извлекаем запись, обновляем соответствующие поля и записываем наши изменения обратно в базу данных:
QSqlTableModel model;
model.setTable("cd");
model.setFilter("id = 125");
model.select();
if (model.rowCount() == 1) {
QSqlRecord record = model.record(0);
record.setValue("title", "Melody A.M.");
record.setValue("year", record.value("year").toInt() + 1);
model.setRecord(0, record);
model.submitAll();
}
Если имеется запись, удовлетворяющая заданному фильтру, доступ к ней мы получаем при помощи функции QSqlTableModel::record(). Мы осуществляем наши изменения и вновь записываем в базу данных запись с новыми значениями полей.
Кроме того, обновление можно выполнить при помощи функции setData(), как это делается для модели, отличной от SQL—модели. Для получения доступа к полям записи используются индексы модели с указанием номера строки (записи) и столбца (поля):
model.select();
if (model.rowCount() == 1) {
model.setData(model.index(0, 1), "Melody A.M.");
model.setData(model.index(0, 3),
model.data(model.index(0, 3)).toInt() + 1);
model.submitAll();
}
Удаление записи напоминает ее обновление:
model.setTable("cd");
model.setFilter("id = 125");
model.select();
if (model.rowCount() == 1) {
model.removeRows(0, 1);
model.submitAll();
}
В вызове removeRows() указываются номер строки первой удаляемой записи и количество удаляемых записей. В следующем примере удаляются все записи, удовлетворяющие фильтру:
model.setTable("cd");
model.setFilter("year < 1990");
model.select();
if (model.rowCount() > 0) {
model.removeRows(0, model.rowCount());
model.submitAll();
}
Классы QSqlQuery и QSqlTableModel обеспечивают интерфейс между Qt и базой данных SQL. Используя эти классы, можно создавать формы, представляющие данные пользователям и позволяющие им вставлять, обновлять и удалять записи.
Представление данных в табличной форме
Во многих случаях табличное представление является самым простым представлением набора данных для пользователей. В этом и последующих разделах мы рассмотрим простое приложение CD Collection (Коллекция компакт-дисков), в котором модель QSqlTableModel и ее подкласс QSqlRelationalTableModel используются для просмотра и взаимодействия пользователей с данными, хранимыми в базе данных.
Главная форма показывает представление «master—detail» для компакт-дисков и дорожек текущего компакт-диска (рис. 13.1).
Рис. 13.1. Приложение CD Collection.
В приложении используются три таблицы, определенные следующим образом:
CREATE TABLE artist (
id INTEGER PRIMARY KEY,
name VARCHAR(40) NOT NULL,
country VARCHAR(40));
CREATE TABLE cd (
id INTEGER PRIMARY KEY,
title VARCHAR(40) NOT NULL,
artistid INTEGER NOT NULL,
year INTEGER N0T NULL,
FOREIGN KEY (artistid) REFERENCES artist);
CREATE TABLE track (
id INTEGER PRIMARY KEY,
title VARCHAR(40) NOT NULL,
duration INTEGER NOT NULL,
cdid INTEGER NOT NULL,
FOREIGN KEY (cdid) REFERENCES cd);
Некоторые базы данных не поддерживают внешние ключи. В этом случае мы должны убрать фразы FOREIGN KEY. Пример будет все-таки работать, но база данных не будет поддерживать целостность на уровне ссылок.
Рис. 13.2. Таблицы приложения CD Collection.
В этом разделе мы создадим диалоговое окно, позволяющее пользователю редактировать список артистов, используя простую форму с таблицей. Пользователь может вставлять, обновлять или удалять артистов при помощи кнопок формы. Обновления можно делать напрямую, просто редактируя текст ячеек. Изменения вносятся в базу данных при нажатии пользователем кнопки Enter или при переходе на другую запись.
Рис. 13.3. Диалоговое окно ArtistForm.
Ниже приводится определение класса для диалогового окна ArtistForm:
01 class ArtistForm : public QDialog
02 {
03 Q_OBJECT
04 public:
05 ArtistForm(const QString &name, QWidget *parent = 0);
06 private slots:
07 void addArtist();
08 void deleteArtist();
09 void beforeInsertArtist(QSqlRecord &record);
10 private:
11 enum {
12 Artist_Id = 0,
13 Artist_Name = 1,
14 Artist_Country = 2
15 };
16 QSqlTableModel *model;
17 QTableView *tableView;
18 QPushButton *addButton;
19 QPushButton *deleteButton;
20 QPushButton *closeButton;
21 };
Конструктор этого класса очень похож на конструктор, который использовался бы для создания формы, построенной для модели, отличной от SQL—модели:
01 ArtistForm::ArtistForm(const QString &name, QWidget *parent)
02 : QDialog(parent)
03 {
04 model = new QSqlTableModel(this);
05 model->setTable("artist");
06 model->setSort(Artist_Name, Qt::AscendingOrder);
07 model->setHeaderData(Artist_Name, Qt::Horizontal, tr("Name"));
08 model->setHeaderData(Artist_Country, Qt::Horizontal, tr("Country"));
09 model->select();
10 connect(model, SIGNAL(beforeInsert(QSqlRecord &)),
11 this, SLOT(beforeInsertArtist(QSqlRecord &)));
12 tableView = new QTableView;
13 tableView->setModel(model);
14 tableView->setColumnHidden(Artist_Id, true);
15 tableView->setSelectionBehavior(QAbstractItemView::SelectRows);
16 tableView->resizeColumnsToContents();
17 for (int row = 0; row < model->rowCount(); ++row) {
18 QSqlRecord record = model->record(row);
19 if (record.value(Artist_Name).toString() == name) {
20 tableView->selectRow(row);
21 break;
22 }
23 }
24 …
25 }
Конструктор начинается с создания объекта QSqlTableModel. Мы передаем this в качестве родителя, чтобы владельцем модели стала форма. Нами выбрана сортировка по столбцу 1 (задается константой Artist_Name), который соответствует полю имени. Если бы мы не задали заголовки столбцов, то использовались бы имена полей. Мы предпочитаем их указать, чтобы обеспечить правильный регистр и локализацию.
Затем создается QTableView для визуального отображения модели. Мы не показываем поле id и устанавливаем такую ширину столбцов, которая будет достаточна для размещения в них текста без необходимости вывода многоточия.
Конструктор ArtistForm принимает имя артиста, который будет выбран при выводе на экран диалогового окна. Мы проходим по записям таблицы artist и выбираем этого артиста. Остальная часть программного кода конструктора используется для создания кнопок и подключения к ним слотов, а также для компоновки дочерних виджетов в диалоговом окне.
01 void ArtistForm::addArtist()
02 {
03 int row = model->rowCount();
04 model->insertRow(row);
05 QModelIndex index = model->index(row, Artist_Name);
06 tableView->setCurrentIndex(index);
07 tableView->edit(index);
08 }
Для добавления нового артиста мы вставляем одну пустую строку в конец табличного представления QTableView. Теперь пользователь может вводить имя нового артиста и его страну. Если пользователь подтверждает вставку, нажимая кнопку Enter, генерируется сигнал beforeInsert(), и после этого новая запись вставляется в базу данных.
01 void ArtistForm::beforeInsertArtist(QSqlRecord &record)
02 {
03 record.setValue("id", generateId("artist"));
04 }
В конструкторе мы связываем сигнал модели beforeInsert() с этим слотом. Мы передаем неконстантную ссылку на запись непосредственно перед ее вставкой в базу данных. Здесь мы устанавливаем значение поля id.
Поскольку нам потребуется вызывать функцию generateId() несколько раз, мы определяем ее как inline—функцию в заголовочном файле и включаем ее каждый раз по мере необходимости. Ниже дается простой (и неэффективный) способ ее реализации:
01 inline int generateId(const QString &table)
02 {
03 QSqlQuery query;
04 query.exec("SELECT MAX(id) FROM " + table);
05 int id = 0;
06 if (query.next())
07 id = query.value(0).tolnt() + 1;
08 return id;
09 }
Функция generateId() может гарантированно работать правильно, если она выполняется в рамках контекста одной транзакции соответствующей команды INSERT. Некоторые базы данных поддерживают средство автоматической генерации полей, и обычно значительно лучше использовать предусмотренные в базе данных специальные средства поддержки этой операции.
Удаление — это последняя операция, которую позволяет сделать диалоговое окно ArtistForm. Вместо каскадного удаления (вскоре будет рассмотрено) мы разрешаем удалять артистов только в том случае, если в коллекции нет их компакт-дисков.
01 void ArtistForm::deleteArtist()
02 {
03 tableView->setFocus();
04 QModelIndex index = tableView->currentIndex();
05 if (!index.isValid())
06 return;
07 QSqlRecord record = model->record(index.row());
08 QSqlTableModel cdModel;
09 cdModel.setTable("cd");
10 cdModel.setFilter("artistid = " + record.value("id").toString());
11 cdModel.select();
12 if (cdModel.rowCount() == 0) {
13 model->removeRow(tableView->currentIndex().row());
14 } else {
15 QMessageBox::information(this, tr("Delete Artist"),
16 tr("Cannot delete %1 because there are CDs associated "
17 "with this artist in the collection.")
18 .arg(record.value("name").toString()));
19 }
20 }
Если выделена какая-то запись, мы проверяем наличие компакт-дисков у данного артиста, и если они отсутствуют, мы сразу же удаляем эту запись артиста. В противном случае мы выводим на экран окно с сообщением о причине невыполнения удаления. Строго говоря, здесь следовало бы использовать транзакцию, потому что из программного кода видно, что между вызовами функций cdModel.select() и model->removeRow() у артиста может появиться свой компакт-диск. Транзакция будет рассмотрена в следующем разделе.
Создание форм по технологии «master—detail»
Теперь мы рассмотрим главную форму, которая реализует подход «master—detail». Главный вид представляет собой список компакт-дисков. Вид описания деталей представляет собой список дорожек текущего компакт-диска. Это диалоговое окно является главным окном приложения CD Collection (Коллекция компакт-дисков); оно показано на рис. 13.1.
01 class MainForm : public QWidget
02 {
03 Q_OBJECT
04 public:
05 MainForm();
06 private slots:
07 void addCd();
08 void deleteCd();
09 void addTrack();
10 void deleteTrack();
11 void editArtists();
12 void currentCdChanged(const QModelIndex &index);
13 void beforeInsertCd(QSqlRecord &record);
14 void beforeInsertTrack(QSqlRecord &record);
15 void refreshTrackViewHeader();
16 private:
17 enum {
18 Cd_Id = 0,
19 Cd_Title = 1,
20 Cd_ArtistId = 2,
21 Cd_Year = 3
22 };
23 enum {
24 Track_Id = 0,
25 Track_Title = 1,
26 Track_Duration = 2,
27 Track_CdId = 3
28 };
29 QSqlRelationalTableModel *cdModel;
30 QSqlTableModel *trackModel;
31 QTableView *cdTableView;
32 QTableView *trackTableView;
33 QPushButton *addCdButton;
34 QPushButton *deleteCdButton;
35 QPushButton *addTrackButton;
36 QPushButton *deleteTrackButton;
37 QPushButton *editArtistsButton;
38 QPushButton *quitButton;
39 };
Мы используем для таблицы компакт-дисков cd модель QSqlRelationalTableModel, а не простую модель QSqlTableModel, потому что нам придется работать с внешними ключами. Мы рассмотрим по очереди все функции, начиная с конструктора, который мы разобьем на несколько секций из-за его большого размера.
01 MainForm::MainForm()
02 {
03 cdModel = new QSqlRelationalTableModel(this);
04 cdModel->setTable("cd");
05 cdModel->setRelation(Cd_ArtistId,
06 QSqlRelation("artist", "id", "name"));
07 cdModel->setSort(Cd_Title, Qt::AscendingOrder);
08 cdModel->setHeaderData(Cd_Title, Qt::Horizontal, tr("Title"));
09 cdModel->setHeaderData(Cd_ArtistId, Qt::Horizontal, tr("Artist"));
10 cdModel->setHeaderData(Cd_Year, Qt::Horizontal, tr("Year"));
11 cdModel->select();
Конструктор начинается с настройки модели QSqlRelationalTableModel, которая управляет таблицей cd. Вызов setRelation() указывает модели на то, что ее поле artistid (индекс которого находится в переменной Cd_ArtistId) содержит идентификатор id внешнего ключа из таблицы артистов artist и что вместо идентификаторов необходимо выводить на экран содержимое соответствующего поля name. Если пользователь переходит в режим редактирования этого поля (например, нажимая клавишу F2), модель автоматически выведет на экран поле с выпадающим списком имен всех артистов, и если пользователь выбирает другого артиста, таблица cd будет обновлена.
12 cdTableView = new QTableView;
13 cdTableView->setModel(cdModel);
14 cdTableView->setItemDelegate(new QSqlRelationalDelegate(this));
15 cdTableView->setSelectionMode(QAbstractItemView::SingleSelection);
16 cdTableView->setSelectionBehavior(QAbstractItemView::SelectRows);
17 cdTableView->setColumnHidden(Cd_Id, true);
18 cdTableView->resizeColumnsToContents();
Настройка представления таблицы cd выполняется аналогично тому, что мы уже делали. Единственным существенным отличием является применение QSqlRelationalDelegate вместо делегата по умолчанию. Именно этот делегат обеспечивает работу с внешними ключами.
19 trackModel = new QSqlTableModel(this);
20 trackModel->setTable("track");
21 trackModel->setHeaderData(Track_Title, Qt::Horizontal, tr("Title"));
22 trackModel->setHeaderData(Track_Duration, Qt::Horizontal,
23 tr("Duration"));
24 trackTableView = new QTableView;
25 trackTableView->setModel(trackModel);
26 trackTableView->setItemDelegate(
27 new TrackDelegate(Track_Duration, this));
28 trackTableView->setSelectionMode(QAbstractItemView::SingleSelection);
29 trackTableView->setSelectionBehavior(QAbstractItemView::SelectRows);
Для дорожек мы собираемся выводить на экран только названия песен и их длительности, поэтому достаточно использовать модель QSqlTableModel. (Поля id и cdid, используемые в рассмотренном ниже слоте currentCdChanged(), не выводятся на экран.) Единственно, на что следует обратить внимание в этой части программного кода, — это использование разработанного в класса TrackDelegate, показывающего времена дорожек в виде «минуты:секунды» и позволяющего их редактировать с помощью удобного класса QTimeEdit.
Создание представлений и кнопок, их компоновка и соединения сигнал—слот не содержат ничего особенного, поэтому из оставшейся части конструктора мы покажем только несколько не совсем очевидных соединений.
30 …
31 connect(cdTableView->selectionModel(),
32 SIGNAL(currentRowChanged(const QModelIndex &,
33 const QModelIndex &)),
34 this, SLOT(currentCdChanged(const QModelIndex &)));
35 connect(cdModel, SIGNAL(beforeInsert(QSqlRecord &)),
36 this, SLOT(beforeInsertCd(QSqlRecord &)));
37 connect(trackModel, SIGNAL(beforeInsert(QSqlRecord &)),
38 this, SLOT(beforeInsertTrack(QSqlRecord &)));
39 connect(trackModel, SIGNAL(rowsInserted(
40 const QModelIndex &, int, int)),
41 this, SLOT(refreshTrackViewHeader()));
42 …
43 }
Первое соединение необычно, поскольку вместо связывания виджета мы связываем модель выборки. Класс QItemSelectionModel используется для отслеживания выборок в представлениях. Связанный с моделью выборки представления таблицы, наш слот currentCdChanged() будет вызываться при всяком перемещении пользователя от одной записи к другой.
01 void MainForm::currentCdChanged(const QModelIndex &index)
02 {
03 if (index.isValid()) {
04 QSqlRecord record = cdModel->record(index.row());
05 int id = record.value("id").toInt();
06 trackModel->setFilter(QString("cdid = %1").arg(id));
07 } else {
08 trackModel->setFilter("cdid = -1");
09 }
10 trackModel->select();
11 refreshTrackViewHeader();
12 }
Этот слот вызывается при каждой смене текущего компакт-диска. Это происходит при переходе пользователя к другому компакт-диску (щелкая мышкой по соответствующей строке или используя клавиши Up и Down). Если компакт-диск недействителен (например, если вообще нет компакт-дисков или был вставлен новый компакт-диск, или текущий компакт-диск был только что удален), мы устанавливаем идентификатор cdid таблицы дорожек track в значение —1 (недействительный идентификатор, которому не соответствует никакая запись).
Затем, установив фильтр, мы выбираем ему соответствующие записи дорожек. Функция refreshTrackViewHeader() будет рассмотрена вскоре.
01 void MainForm::addCd()
02 {
03 int row = 0;
04 if (cdTableView->currentIndex().isValid())
05 row = cdTableView->currentIndex().row();
06 cdModel->insertRow(row);
07 cdModel->setData(cdModel->index(row, Cd_Year),
08 QDate::currentDate().year());
09 QModelIndex index = cdModel->index(row, Cd_Title);
10 cdTableView->setCurrentIndex(index);
11 cdTableView->edit(index);
12 }
Когда пользователь нажимает клавишу Add CD (добавить компакт-диск), в таблицу cdTableView вставляется новая пустая строка и мы переходим в режим редактирования. Мы также устанавливаем значение по умолчанию для поля year. В этот момент пользователь может редактировать запись, заполняя пустые поля и выбирая артиста из выпадающего списка, который автоматически выдается моделью QSqlRelationalTableModel благодаря вызову setRelation(), a также изменяя год, если не подходит значение по умолчанию. Если пользователь подтверждает вставку нажатием клавиши Enter, запись вставляется. Пользователь может отменить вставку, нажав клавишу Esc.
01 void MainForm::beforeInsertCd(QSqlRecord &record)
02 {
03 record.setValue("id", generateId("cd"));
04 }
Этот слот вызывается, когда cdModel генерирует свой сигнал beforeInsert(). Мы используем его для заполнения поля id, как это делалось при вставке нового артиста, и здесь применимо то же самое предостережение: данная операция должна выполняться в рамках транзакции, а в идеальном случае должно использоваться зависимое от базы данных средство создания идентификаторов (например, автоматическая генерация идентификаторов).
01 void MainForm::deleteCd()
02 {
03 QModelIndex index = cdTableView->currentIndex();
04 if (!index.isValid())
05 return;
06 QSqlDatabase db = QSqlDatabase::database();
07 db.transaction();
08 QSqlRecord record = cdModel->record(index.row());
09 int id = record.value(Cd_Id).toInt();
10 int tracks = 0;
11 QSqlQuery query;
12 query.exec(QString("SELECT COUNT(*) FROM track WHERE cdid = %1")
13 .arg(id));
14 if (query.next())
15 tracks = query.value(0).tolnt();
16 if (tracks > 0) {
17 int r = QMessageBox::question(this, tr("Delete CD"),
18 tr("Delete \"%1\" and all its tracks?")
19 .arg(record.value(Cd_ArtistId).toString()),
20 QMessageBox::Yes | QMessageBox::Default,
21 QMessageBox::No | QMessageBox::Escape);
22 if (r == QMessageBox::No) {
23 db.rollback();
24 return;
25 }
26 query.exec(QString("DELETE FROM track WHERE cdid = %1")
27 .arg(id));
28 }
29 cdModel->removeRow(index.row());
30 cdModel->submitAll();
31 db.commit();
32 currentCdChanged(QModelIndex());
33 }
Когда пользователь нажимает клавишу Delete CD (удалить компакт-диск), вызывается этот слот. Если имеется текущий компакт-диск, мы определяем, сколько у него дорожек. Если нет ни одной дорожки, мы просто удаляем запись компакт-диска. Если имеется по крайней мере одна дорожка, мы просим пользователя подтвердить удаление, и, если он нажимает кнопку Yes, мы удаляем все дорожки и затем запись самого компакт-диска. Все это делается в рамках транзакции, поэтому каскадное удаление либо совсем не будет выполнено, либо выполнится полностью при условии, что ваша база данных поддерживает транзакции.
Обработка данных дорожки очень похожа на обработку данных компакт-диска. Для обновления данных пользователь может просто редактировать ячейки. Что касается длительностей дорожек, то класс TrackDelegate гарантирует удобный формат отображения времен и они легко могут редактироваться с использованием QTimeEdit.
01 void MainForm::addTrack()
02 {
03 if (!cdTableView->currentIndex().isValid())
04 return;
05 int row = 0;
06 if (trackTableView->currentIndex().isValid())
07 row = trackTableView->currentIndex().row();
08 trackModel->insertRow(row);
09 QModelIndex index = trackModel->index(row, Track_Title);
10 trackTableView->setCurrentIndex(index);
11 trackTableView->edit(index);
12 }
Эта функция работает так же, как addCd(), со вставкой в представление новой пустой строки.
01 void MainForm::beforeInsertTrack(QSqlRecord &record)
02 {
03 QSqlRecord cdRecord = cdModel->record(cdTableView->currentIndex().row());
04 record.setValue("id", generateId("track"));
05 record.setValue("cdid", cdRecord.value(Cd_Id).toInt());
06 }
Если пользователь подтверждает вставку, инициированную функцией addTrack(), указанная выше функция вызывается для заполнения полей id и cdid. Упомянутые ранее предостережения применимы, конечно, и в этом случае.
01 void MainForm::deleteTrack()
02 {
03 trackModel->removeRow(trackTableView->currentIndex().row());
04 if (trackModel->rowCount() == 0)
05 trackTableView->horizontalHeader()->setVisible(false);
06 }
Если пользователь нажимает кнопку Delete Track (удалить дорожку), мы сразу же удаляем дорожку. Если предпочтительнее подтверждать удаление, мы могли бы легко выдать окно с сообщением и кнопками Yes и No.
01 void MainForm::refreshTrackViewHeader()
02 {
03 trackTableView->horizontalHeader()->setVisible(
04 trackModel->rowCount() > 0);
05 trackTableView->setColumnHidden(Track_Id, true);
06 trackTableView->setColumnHidden(Track_CdId, true);
07 trackTableView-> resizeColumnsToContents();
08 }
Слот refreshTrackViewHeader() вызывается из различных мест; он гарантирует вывод на экран горизонтального заголовка в представлении дорожек только в случае наличия дорожек. Он не показывает поля идентификаторов id и cdid и изменяет видимые размеры столбцов таблицы в зависимости от текущего содержимого таблицы.
01 void MainForm::editArtists()
02 {
03 QSqlRecord record = cdModel->record(cdTableView->currentIndex().row());
04 ArtistForm artistForm(record.value(Cd_ArtistId).toString(), this);
05 artistForm.exec();
06 cdModel->select();
07 }
Этот слот, вызывается при нажатии пользователем кнопки Edit Artists (правка артистов). Он обеспечивает вывод на экран данных о компакт-дисках текущего артиста, вызывая форму ArtistForm, рассмотренную в предыдущем разделе, и делая выборку по соответствующему артисту. Если нет текущей записи, функция record() возвратит безвредную пустую запись, которая не будет соответствовать (и поэтому не будет выбрана) никакому артисту в форме артистов. В действительности при вызове record.value(Cd_ArtistId), используемого из-за применения модели QSqlRelationalTableModel, которая идентификаторам артистов ставит в соответствие их имена, возвращается имя артиста (а оно будет пустой строкой, если запись пустая). В конце мы снова выбираем данные модели cdModel, что заставляет cdTableView обновить свои видимые ячейки. Это делается для того, чтобы гарантировать правильный вывод на экран имен артистов, поскольку некоторые из них пользователь мог изменить в диалоговом окне ArtistForm.
Для проектов, использующих SQL—классы, необходимо добавить строку
QT += sql
в файлы .pro; это обеспечит сборку приложения с библиотекой QtSql.
Данная глава показывает, что Qt—классы архитектуры модель/представление позволяют достаточно просто просматривать и редактировать данные, размещенные в базах данных SQL. В тех случаях, когда внешние ключи ссылаются на таблицы с большим количеством записей (например, тысячи записей и больше), по-видимому, лучше всего создать свой собственный делегат и использовать его для представления формы со «списком значений» и с возможностями поиска, а не полагаться на выпадающие списки модели QSqlRelationalTableModel. Кроме того, в ситуациях, когда требуется отображать записи в виджете формы, мы должны обеспечить это сами в своем программном коде — использовать QSqlQuery или QSqlTableModel для взаимодействия с базой данных и связать содержимое виджетов пользовательского интерфейса (который мы хотим использовать для представления и редактирования данных) с соответствующей базой данных.
Глава 14. Работа с сетью
Qt обеспечивает классы QFtp и QHttp для работы с протоколами FTP и HTTP. Эти протоколы удобно применять для скачивания файлов из сети и их загрузки на удаленный компьютер, а также в случае применения протокола HTTP для передачи запросов на веб—серверы и получения результатов.
Qt также предоставляет низкоуровневые классы QTCPSocket и QUdpSocket, которые реализуют транспортные протоколы TCP и UDP. TCP — это надежный, ориентированный на соединение протокол, который оперирует потоками данных, циркулирующими между узлами сети, в то время как UDP — ненадежный, не ориентированный на соединения протокол, основанный на передаче дискретных пакетов от одних сетевых узлов к другим. Оба протокола могут использоваться для создания клиентских и серверных сетевых приложений. В серверных приложениях необходимо также использовать класс QTcpServer для обработки входящих ТСР—соединений.
Написание FTP—клиентов
Класс QFtp реализует клиентскую часть протокола FTP в Qt. Он предлагает различные функции для выполнения самых распространенных операций протокола FTP и позволяет выполнять произвольные команды FTP.
Класс QFtp работает асинхронно. Когда мы вызываем такие функции, как get() или put(), управление сразу же возвращается к нам, а пересылка данных осуществляется после передачи управления обратно в цикл обработки событий Qt. Это обеспечивает работоспособность интерфейса пользователя во время выполнения команд FTP.
Мы начнем с примера чтения одного файла с помощью функции get(). В этом примере создается консольное приложение с именем ftpget, которое скачивает удаленный файл, указанный в командной строке. Давайте начнем с функции main():
01 int main(int argc, char *argv[])
02 {
03 QCoreApplication app(argc, argv);
04 QStringList args = app.arguments();
05 if (args.count() != 2) {
06 cerr << "Usage: ftpget url" << endl << "Example:" << endl
07 << " ftpget ftp://ftp.trolltech.com/mirrors" << endl;
08 return 1;
09 }
10 FtpGet getter;
11 if (!getter.getFile(QUrl(args[1])))
12 return 1;
13 QObject::connect(&getter, SIGNAL(done()), &app, SLOT(quit()));
14 return app.exec();
15 }
Мы создаем объект класса QCoreApplication, а не его подкласса QApplication, чтобы избежать сборки с библиотекой QtGui. Функция QCoreApplication::arguments() возвращает аргументы командной строки в виде списка QStringList, первым элементом которого является имя вызванной программы, а все специфичные для Qt аргументы, такие как —style, удаляются. Центральными моментами в функции main() являются конструирование объекта FtpGet и вызов функции getFile(). Если этот вызов оказывается успешным, мы позволяем циклу событий выполняться до тех пор, пока файл не будет полностью скачан.
Всю работу делает подкласс FtpGet, который определяется следующим образом:
01 class FtpGet : public QObject
02 {
03 Q_OBJECT
04 public:
05 FtpGet(QObject *parent = 0);
06 bool getFile(const QUrl &url);
07 signals:
08 void done();
09 private slots:
10 void ftpDone(bool error);
11 private:
12 QFtp ftp;
13 QFile file;
14 …
15 };
Класс имеет открытую функцию getFile(), которая считывает файл по указанному адресу URL. Класс QUrl имеет высокоуровневый интерфейс для извлечения различных частей URL, таких как имя файла, путь, протокол и порт.
Класс FtpGet имеет закрытый слот ftpDone(bool), который вызывается после окончания операции пересылки файла, и сигнал done(), который генерируется при завершении скачивания файла. Этот класс имеет также две закрытые переменные. Переменная ftp имеет тип QFtp и инкапсулирует соединение с сервером FTP; переменная file используется для записи скачанного из сети файла на диск.
01 FtpGet::FtpGet(QObject *parent)
02 : QObject(parent)
03 {
04 connect(&ftp, SIGNAL(done(bool)), this, SLOT(ftpDone(bool)));
05 }
В конструкторе мы подсоединяем сигнал QFtp::done(bool) к нашему закрытому слоту ftpDone(bool). QFtp генерирует сигнал done(bool) после завершения обработки всех запросов. Параметр типа bool показывает, возникла ошибка или нет.
01 bool FtpGet::getFile(const QUrl &url)
02 {
03 if (!url.isValid()) {
04 cerr << "Error: Invalid URL" << endl;
05 return false;
06 }
07 if (url.scheme() != "ftp") {
08 cerr << "Error: URL must start with 'ftp:'" << endl;
09 return false;
10 }
11 if (url.path().isEmpty()) {
12 cerr << "Error: URL has no path" << endl;
13 return false;
14 }
15 QString localFileName = QFileInfo(url.path()).fileName();
16 if (localFileName.isEmpty())
17 localFileName = "ftpget.out";
18 file.setFileName(localFileName);
19 if (!file.open(QIODevice::WriteOnly)) {
20 cerr << "Error: Cannot open "
21 << qPrintable(file.fileName()) << " for writing: "
22 << qPrintable(file.errorString()) << endl;
23 return false;
24 }
25 ftp.connectToHost(url.host(), url.port(21));
26 ftp.login();
27 ftp.get(url.path(), &file);
28 ftp.close();
29 return true;
30 }
Функция getFile() начинается с проверки переданного ей URL. Если возникла проблема, функция выводит в поток cerr сообщение об ошибке и возвращает false, указывая на неудачное скачивание файла.
Мы не обязываем пользователя указывать имя локального файла и пытаемся сами создать осмысленное имя на основе URL, а при неудаче используем имя ftpget.out. Если не удается открыть файл, мы печатаем сообщение об ошибке и возвращаем false.
Затем мы выполняем последовательность из четырех команд FTP, используя наш объект QFtp. Вызов url.port(21) возвращает номер порта, указанный в URL, или порт 21, если URL не содержит порта. Поскольку функции login() не передаются ни имя пользователи, ни пароль, делается попытка анонимного входа в систему. Второй аргумент функции get() задает выходное устройство ввода—вывода.
Команды FTP ставятся в очередь и обрабатываются в цикле обработки событий Qt. Завершение всех команд регистрируется сигналом done(bool) объекта QFtp, который мы подсоединили к слоту ftpDone(bool) в конструкторе.
01 void FtpGet::ftpDone(bool error)
02 {
03 if (error) {
04 cerr << "Error: " << qPrintable(ftp.errorString()) << endl;
05 } else {
06 cerr << "File downloaded as " << qPrintable(file.fileName()) << endl;
07 }
08 file.close();
09 emit done();
10 }
После выполнения всех команд FTP мы закрываем файл и генерируем сигнал done(). Может показаться странным, что мы закрываем файл именно здесь, а не после вызова ftp.close() в конце функции getFile(), но следует помнить, что команды FTP выполняются асинхронно и их выполнение вполне может быть еще не закончено после возврата управления функцией getFile(). Только после генерации объектом QFtp сигнала done() мы можем быть уверены, что скачивание файла завершено и теперь можно спокойно закрывать файл.
Класс QFtp поддерживает несколько FTP—команд, включая connectToHost(), login(), close(), list(), cd(), get(), put(), remove(), mkdir(), rmdir() и rename(). Все эти функции отправляют какую-то команду FTP и возвращают число, идентифицирующее эту команду. Можно также управлять режимом передачи (по умолчанию используется пассивная передача) и типом передачи (двоичный по умолчанию).
Произвольные команды FTP можно выполнять при помощи функции rawCommand(). Ниже приводится пример выполнения команды SITE CHMOD:
ftp.rawCommand("SITE CHMOD 755 fortune");
QFtp генерирует сигнал commandStarted(int) в начале выполнения команды и сигнал commandFinished(int, bool) после завершения выполнения команды. Параметр типа int является числом, которое идентифицирует команду. Если мы собираемся отслеживать результаты выполнения отдельных команд, мы можем сохранять эти идентификаторы при постановке команд в очередь. Отслеживание идентификаторов обеспечивает более оперативную обратную связь с пользователем. Например:
01 bool FtpGet::getFile(const QUrl &url)
02 {
03 …
04 connectId = ftp.connectToHost(url.host(), url.port(21));
05 loginId = ftp.login();
06 getId = ftp.get(url.path(), &file);
07 closeId = ftp.close();
08 return true;
09 }
10 void FtpGet::ftpCommandStarted(int id)
11 {
12 if (id == connectId) {
13 сегг << "Connecting..." << endl;
14 } else if (id == loginId) {
15 cerr << "Logging in..." << endl;
16 …
17 }
Другой способ обеспечения обратной связи заключается в подключении к сигналу stateChanged() класса QFtp, который генерируется при всяком изменении состояния соединения (QFtp::Connecting, QFtp::Connected, QFtp::LoggedIn и т.д.).
В большинстве приложений нас интересует только результат исполнения всей последовательности команд, а не каких-то конкретных команд. В таком случае мы можем просто подключить сигнал done(bool), который генерируется всякий раз, когда очередь команд становится пустой.
При возникновении ошибки QFtp автоматически очищает очередь команд. Это означает, что при неудачном подсоединении или входе пользователя в систему оставшиеся в очереди команды никогда не выполнятся. Если мы после возникновения ошибки зададим новые команды с использованием того же объекта QFtp, они будут поставлены в очередь и затем выполнены.
В файл приложения .pro необходимо добавить следующую строку для сборки приложения совместно с библиотекой QtNetwork:
QT += network
Теперь мы рассмотрим более сложный пример. Программа командной строки spider (паук) скачивает все файлы, расположенные в каталоге FTP—сервера, рекурсивно просматривая каждый его подкаталог. Вся логика работы с сетью содержится в классе Spider:
01 class Spider : public QObject
02 {
03 Q_OBJECT
04 public:
05 Spider(QObject *parent = 0);
06 bool getDirectory(const QUrl &url);
07 signals:
08 void done();
09 private slots:
10 void ftpDone(bool error);
11 void ftpListInfo(const QUrlInfo &urlInfo);
12 private:
13 void processNextDirectory();
14 QFtp ftp;
15 QList openedFiles;
16 QString currentDir;
17 QString currentLocalDir;
18 QStringList pendingDirs;
19 };
Начальный каталог определяется как объект типа QUrl и устанавливается при помощи функции getDirectory().
01 Spider::Spider(QObject *parent)
02 : QObject(parent)
03 {
04 connect(&ftp, SIGNAL(done(bool)), this, SLOT(ftpDone(bool)));
05 connect(&ftp, SIGNAL(listInfo(const QUrlInfo &)),
06 this, SLOT(ftpListInfo(const QUrlInfo &)));
07 }
В конструкторе мы устанавливаем два соединения сигнал—слот. Когда мы выдаем запрос на получение списка элементов каталога в getDirectory(), QFtp генерирует сигнал listInfo(const QUrlInfo &) для каждого найденного имени. Этот сигнал подключается к слоту с именем ftpListInfo(), который скачивает файл из сети по указанному адресу URL.
01 bool Spider::getDirectory(const QUrl &url)
02 {
03 if (!url.isValid()) {
04 cerr << "Error: Invalid URL" << endl;
05 return false;
06 }
07 if (url.scheme() != "ftp") {
08 cerr << "Error: URL must start with 'ftp:'" << endl;
09 return false;
10 }
11 ftp.connectToHost(url.host(), url.port(21));
12 ftp.login();
13 QString path = url.path();
14 if (path.isEmpty())
15 path = "/";
16 pendingDirs.append(path);
17 processNextDirectory();
18 return true;
19 }
Выполнение функции getDirectory() начинается с некоторых основных проверок, и если все нормально, делается попытка установить FTP—соединение. Она отслеживает пути, которые необходимо будет обрабатывать, и вызывает функцию processNextDirectory(), чтобы начать скачивание корневого каталога.
01 void Spider::processNextDirectory()
02 {
03 if (!pendingDirs.isEmpty()) {
04 currentDir = pendingDirs.takeFirst();
05 currentLocalDir = "downloads/" + currentDir;
06 QDir(".").mkpath(currentLocalDir);
07 ftp.cd(currentDir);
08 ftp.list();
09 } else {
10 emit done();
11 }
12 }
Функция processNextDirectory() принимает первый удаленный каталог из списка каталогов, ожидающих обработки, pendingDirs, и создает соответствующий каталог в локальной файловой системе. После этого она указывает объекту QFtp на необходимость изменения каталога на принятый ею каталог и затем получения списка его файлов. Для каждого файла, обрабатываемого функцией list(), генерируется сигнал listInfo(), приводящий к вызову слота ftpListInfo().
Когда все каталоги оказываются обработанными, эта функция генерирует сигнал done(), обозначающий завершение скачивания.
01 void Spider::ftpListInfo(const QUrlInfo &urlInfo)
02 {
03 if (urlInfo.isFile()) {
04 if (urlInfo.isReadable()) {
05 QFile *file = new QFile(currentLocalDir + "/"
06 + urlInfo.name());
07 if (!file->open(QIODevice::WriteOnly)) {
08 cerr << "Warning: Cannot open file << qPrintable(
09 QDir::convertSeparators(file->fileName()))
10 << endl;
11 return;
12 }
13 ftp.get(urlInfo.name(), file);
14 openedFiles.append(file);
15 }
16 } else if (urlInfo.isDir() && !urlInfo.isSymLink()) {
17 pendingDirs.append(currentDir + "/" + urlInfo.name());
18 }
19 }
Параметр urlInfo слота ftpListInfo() содержит информацию о файле в сети. Если это обычный файл (не каталог) и его можно считывать, мы вызываем функцию get() для его загрузки. Объект QFile, используемый для загрузки файла, создается с помощью оператора new, и указатель на него хранится в списке openedFiles.
Если содержащиеся в QUrlInfo сведения об удаленном каталоге говорят, что он не является символической связью, этот каталог добавляется к списку pendingDirs. Мы пропускаем символические связи, поскольку они легко могут привести к бесконечной рекурсии.
01 void Spider::ftpDone(bool error)
02 {
03 if (error) {
04 cerr << "Error: " << qPrintable(ftp.errorString()) << endl;
05 } else {
06 cout << "Downloaded " << qPrintable(currentDir) << " to "
07 << qPrintable(QDir::convertSeparators(
08 QDir(currentLocalDir).canonicalPath()));
09 }
10 qDeleteAll(openedFiles);
11 openedFiles.clear();
12 processNextDirectory();
13 }
Слот ftpDone() вызывается после завершения всех команд FTP или при возникновении ошибки. Мы удаляем объекты QFile для предотвращения утечек памяти, а также для закрытия всех файлов. Наконец, мы вызываем функцию processNextDirectory(). Если какие-нибудь каталоги остались, весь процесс повторяется для следующего каталога в списке; в противном случае скачивание файлов прекращается и генерируется сигнал done().
Если ошибок нет, последовательность команд FTP и сигналов будет такой:
connectToHost(host, port)
login()
cd(directory_1)
list()
emit listInfo(file_1_1)
get(file_1_1)
emit listInfo(file_1_2)
get(file_1_2)
…
emit done()
…
cd(directory_N)
list()
emit listInfo(file_N_1)
get(file_N_1)
emit listInfo(file_N_2)
get(file_N_2)
…
emit done()
Если файл фактически оказывается каталогом, он добавляется в список pendingDirs и, когда завершается скачивание последнего файла, полученного текущей командой list(), выдается новая команда cd(), за которой следует новая команда list() для следующего каталога, ожидающего обработки, и весь процесс повторяется для нового каталога. Скачиваются новые файлы, и в список pendingDirs добавляются новые каталоги до тех пор, пока не будут скачаны все файлы из всех каталогов и список pendingDirs в результате не станет пустым.
Если возникнет сетевая ошибка при загрузке пятого файла, скажем, из двадцати файлов в каталоге, остальные файлы не будут скачаны. Если бы мы захотели скачать как можно больше файлов, то один из способов заключается в выполнении по одной операции GET и ожидании сигнала done(bool) перед выполнением новой операции GET. В функции listInfo() мы бы просто добавили имя файла в конец списка QStringList вместо немедленного вызова get(), а в слоте done(bool) мы бы вызывали функцию get() для следующего загружаемого файла из списка QStringList. Последовательность команд выглядела бы так:
connectToHost(host, port)
login()
cd(directory_1)
list()
…
cd(directory_N)
list()
emit listInfo(file_1_1)
emit listInfo(file_1_2)
…
emit listInfo(file_N_1)
emit listInfo(file_N_2)
…
emit done()
get(file_1_1)
emit done()
get(file_1_2)
emit done()
…
get(file_N_1)
emit done()
get(file_N_2)
emit done()
…
Еще одно решение могло бы заключаться в применении одного объекта QFtp для каждого файла. Это позволило бы нам скачивать файлы из сети параллельно, используя отдельные FTP—соединения.
01 int main(int argc, char *argv[])
02 {
03 QCoreApplication app(argc, argv);
04 QStringList args = app.arguments();
05 if (args.count() != 2) {
06 cerr << "Usage: spider url" << endl << "Example:" << endl
07 << " spider ftp://ftp.trolltech.com/freebies/leafnode" << endl;
08 return 1;
09 }
10 Spider spider;
11 if (!spider.getDirectory(QUrl(args[1])))
12 return 1;
13 QObject::connect(&spider, SIGNAL(done()), &app, SLOT(quit()));
14 return app.exec();
15 }
Функция main() завершает программу. Если пользователь не задает адрес URL в командной строке, мы выдаем сообщение об ошибке и завершаем программу.
В обоих примерах применения протокола FTP данные, полученные функцией get(), записывались в объект QFile. Это не обязательно должно быть так. Если бы мы захотели хранить данные в памяти, мы могли бы использовать QBuffer — подкласс QIODevice, являющийся оболочкой массива QByteArray. Например:
QBuffer *buffer= new QBuffer;
buffer->open(QIODevice::WriteOnly);
ftp.get(urlInfo.name(), buffer);
Мы могли бы также не задавать в функции get() аргумент с устройством ввода—вывода или передать нулевой указатель. Класс QFtp тогда генерирует сигнал readyRead() при поступлении каждой новой порции данных и данные могут считываться при помощи функции read() или readAll().
Написание НТТР—клиента
Класс QHttp реализует клиентскую часть протокола HTTP в Qt. Он содержит различные функции для выполнения самых распространенных операций протокола HTTP, включая get() и post(), и обеспечивает средство выполнения произвольных запросов HTTP. Если вы прочитали предыдущий раздел о классе QFtp, вы обнаружите, что существует много общего у классов QFtp и QHttp.
Класс QHttp работает асинхронно. Когда мы вызываем такие функции, как get() или post(), управление сразу же возвращается к нам, а пересылка данных осуществляется после передачи управления обратно в цикл обработки событий Qt. Это обеспечивает работоспособность интерфейса пользователя во время обработки запросов HTTP.
Мы рассмотрим пример консольного приложения с именем httpget, демонстрирующего способ загрузки файла с использованием протокола HTTP. Мы не приводим здесь заголовочный файл, поскольку данный пример очень напоминает пример ftpget, который мы использовали в предыдущем разделе.
01 HttpGet::HttpGet(QObject *parent)
02 : QObject(parent)
03 {
04 …
05 connect(&http, SIGNAL(done(bool)), this, SLOT(httpDone(bool)));
06 }
В конструкторе мы подсоединяем сигнал done(bool) объекта QHttp к закрытому слоту httpDone(bool).
01 bool HttpGet::getFile(const QUrl &url)
02 {
03 if (!url.isValid()) {
04 сегг << "Error: Invalid URL" << endl;
05 return false;
06 }
07 if (url.scheme() != "http") {
08 cerr << "Error: URL must start with 'http:'" << endl;
09 return false;
10 }
11 if (url.path().isEmpty()) {
12 cerr << "Error: URL has no path" << endl;
13 return false;
14 }
15 QString localFileName = QFileInfo(url.path()).fileName();
16 if (localFileName.isEmpty())
17 localFileName = "httpget.out";
18 file.setFileName(localFileName);
19 if (!file.open(QIODevice::WriteOnly)) {
20 cerr << "Error: Cannot open "
21 << qPrintable(file.fileName()) << " for writing: "
22 << qPrintable(file.errorString()) << endl;
23 return false;
24 }
25 http.setHost(url.host(), url.port(80));
26 http.get(url.path(), &file);
27 http.close();
28 return true;
29 }
Функция getFile() проверяет ошибочные ситуации так же, как рассмотренная ранее функция FtpGet::getFile(), и использует тот же подход при задании имени локального файла. При загрузке файлов с веб-сайта не требуется входить в систему, поэтому мы просто указываем хост и порт (используя стандартный для HTTP порт 80, если его нет в URL) и скачиваем данные в файл, заданный вторым аргументом функции QHttp::get().
Запросы HTTP ставятся в очередь и обрабатываются асинхронно в цикле обработки событий Qt. На завершение выполнения запросов указывает сигнал done(bool) объекта QHttp, который мы подсоединили к слоту httpDone(bool) в конструкторе.
01 void HttpGet::httpDone(bool еггог)
02 {
03 if (еггог) {
04 сегг << "Еггог: " << qPrintable(http.errorString()) << endl;
05 } else {
06 сегг << "File downloaded as " << qPrintable(file.fileName()) << endl;
07 }
08 file.close();
09 emit done();
10 }
После выполнения запросов HTTP мы файл закрываем, уведомляя пользователя о возникновении ошибки.
Функция main() очень похожа на такую же функцию в примере ftpget:
01 int main(int argc, char *argv[])
02 {
03 QCoreApplication app(argc, argv);
04 QStringList args = app.arguments();
05 if (args.count() != 2) {
06 cerr << "Usage: httpget url" << endl << "Example:" << endl
07 << " httpget http://doc.trolltech.com/qq/index.html" << endl;
08 return 1;
09 }
10 HttpGet getter;
11 if (!getter.getFile(QUrl(args[1])))
12 return 1;
13 QObject::connect(&getter, SIGNAL(done()), &app, SLOT(quit()));
14 return app.exec();
15 }
Класс QHttp содержит много операций, включая setHost(), get(), post() и head(). Если для входа на сайт необходимо выполнить аутентификацию пользователя, setUser() может использоваться для установки имени пользователя и пароля. QHttp может использовать сокет, указанный программистом, а не свой собственный внутренний QTcpSocket. Это делает возможным применение безопасного сокета QtSslSocket (который предоставляется компонентом Qt Solution компании «Trolltech») для работы с HTTP через SSL.
Мы можем применять функцию post() для пересылки пар «имя = значение» в сценарий CGI:
http.setHost("www.example.com");
http.post("/cgi/somescript.py", "x=200&y=320", &file);
Мы можем передавать данные в виде 8-битовой строки либо передавать открытое устройство QIODevice, например QFile. Для обеспечения большего контроля мы можем использовать функцию request(), которая принимает произвольные заголовок и данные HTTP. Например:
QHttpRequestHeader header("POST", "/search.html");
header.setValue("Host", "www.trolltech.com");
header.setContentType("application/x-www-form-urlencoded");
http.setHost(www.trolltech.com);
http.request(header, "qt-interest=on&search=opengl");
QHttp генерирует сигнал requestStarted(int) в начале выполнения команды и сигнал requestFinished(int, bool) после завершения выполнения команды. Параметр типа int является числом, которое идентифицирует запрос. Если мы собираемся отслеживать результаты выполнения отдельных запросов, мы можем сохранять эти идентификаторы при постановке запросов в очередь. Отслеживание идентификаторов обеспечивает более оперативную обратную связь с пользователем.
В большинстве приложений нас интересует результат исполнения всей последовательности команд. Это легко достигается путем подсоединения сигнала done(bool), который генерируется всякий раз, когда очередь запросов становится пустой.
При возникновении ошибки очередь запросов автоматически очищается. Но если мы после возникновения ошибки зададим новые запросы с использованием того же объекта QHttp, они будут поставлены в очередь и затем выполнены в обычном порядке.
Как и QFtp, класс QHttp содержит сигнал readyRead(), а также функции read() и readAll(), которые мы можем использовать вместо указания устройства ввода—вывода.
Написание клиент—серверных приложений на базе TCP
Классы QTcpSocket и QTcpServer могут использоваться для реализации клиентов и серверов TCP. TCP — это транспортный протокол, который составляет основу большинства прикладных протоколов сети Интернет, включая FTP и HTTP, и который может также использоваться для создания пользовательских протоколов.
TCP является потокоориентированным протоколом. Для приложений данные представляются в виде большого потока данных, очень напоминающего большой однородный файл. Протоколы высокого уровня, построенные на основе TCP, являются либо строкоориентированными, либо блокоориентированными:
• строкоориентированные протоколы передают текстовые данные построчно, завершая каждую строку символом перехода на новую строку;
• блокоориентированные протоколы передают данные в виде двоичных блоков. Каждый блок имеет в начале поле, где указан его размер, и затем идут байты данных.
Класс QTcpSocket наследует QIODevice через класс QAbstractSocket, и поэтому чтение с него или запись на него могут производиться с применением средств класса QDataStream или QTextStream. Одно существенное отличие чтения данных из сети по сравнению с чтением обычного файла заключается в том, что мы должны быть уверены в получении достаточного количества данных от партнерского узла (peer) перед использованием оператора >>. В противном случае результат может быть непредсказуемым.
В данном разделе мы рассмотрим программный код клиента и сервера, которые используют пользовательский протокол блочной передачи. Клиент называется Trip Planner (планировщик путешествий) и позволяет пользователям составлять план путешествия на поезде. Сервер называется Trip Server (сервер путешествий) и обеспечивает клиента информацией о путешествии. Мы начнем с написания клиентского приложения Trip Planner.
Приложение Trip Planner содержит поле From (из пункта), поле To (до пункта), поле Date (дата), поле Approximate Time (приблизительное время) и два переключателя, определяющие приблизительное время отправления или прибытия. Когда пользователь нажимает клавишу Search, приложение посылает запрос на сервер, который возвращает список железнодорожных рейсов, которые удовлетворяют критериям пользователя. Этот список отображается в виджете QTableWidget в окне Trip Planner. В нижней части окна расположены текстовая метка QLabel, показывающая состояние последней операции, и индикатор состояния процесса QProgressBar.
Рис. 14.1. ПриложениеТпр Planner.
Пользовательский интерфейс приложения Trip Planner был создан при помощи QtDesigner в файле tripplanner.ui. Ниже мы основное внимание уделим исходному коду подкласса QDialog, который реализует функциональность приложения:
#include "ui_tripplanner.h"
01 class TripPlanner : public QDialog, public Ui::TripPlanner
02 {
03 Q_OBJECT
04 public:
05 TripPlanner(QWidget *parent = 0);
06 private slots:
07 void connectToServer();
08 void sendRequest();
09 void updateTableWidget();
10 void stopSearch();
11 void connectionClosedByServer();
12 void error();
13 private:
14 void closeConnection();
15 QTcpSocket tcpSocket;
16 quint16 nextBlockSize;
17 };
Класс TripPlanner наследует не только QDialog, но и Ui::TripPlanner (который генерируется компилятором uic, используя файл tripplanner.ui). Переменная—член tcpSocket инкапсулирует соединение TCP. Переменная nextBlockSize используется при синтаксическом анализе блоков, поступивших с сервера.
01 TripPlanner::TripPlanner(QWidget *parent)
02 : QDialog(parent)
03 {
04 setupUi(this);
05 QDateTime dateTime = QDateTime::currentDateTime();
06 dateEdit->setDate(dateTime.date());
07 timeEdit->setTime(QTime(dateTime.time().hour(), 0));
08 progressBar->hide();
09 progressBar->setSizePolicy(QSizePolicy::Preferred,
10 QSizePolicy::Ignored);
11 tableWidget->verticalHeader()->hide();
12 tableWidget->setEditTriggers(QAbstractItemView::NoEditTriggers);
13 connect(searchButton, SIGNAL(clicked()),
14 this, SLOT(connectToServer()));
15 connect(stopButton, SIGNAL(clicked()), this, SLOT(stopSearch()));
16 connect(&tcpSocket, SIGNAL(connected()),
17 this, SLOT(sendRequest()));
18 connect(&tcpSocket, SIGNAL(disconnected()),
19 this, SLOT(connectionClosedByServer()));
20 connect(&tcpSocket, SIGNAL(readyRead()),
21 this, SLOT(updateTableWidget()));
22 connect(&tcpSocket, SIGNAL(error(QAbstractSocket::SocketError)),
23 this, SLOT(error()));
24 }
В конструкторе мы инициализируем поля редактирования даты и времени текущей датой и временем. Мы также не показываем индикатор состояния программы, потому что он необходим только при активном соединении. В Qt Designer свойства minimum и maximum индикатора состояния устанавливались в 0. Это определяет поведение QProgressBar как индикатора занятости вместо стандартного индикатора, показывающего процент выполнения работы.
В конструкторе мы также связываем сигналы connected(), disconnected(), readyRead() и error(QAbstractSocket::SocketError) класса QTcpSocket с закрытыми слотами.
01 void TripPlanner::connectToServer()
02 {
03 tcpSocket.connectToHost("tripserver.zugbahn.de", 6178);
04 tableWidget->setRowCount(0);
05 searchButton->setEnabled(false);
06 stopButton->setEnabled(true);
07 statusLabel->setText(tr("Connecting to server..."));
08 progressBar->show();
09 nextBlockSize = 0;
10 }
Слот connectToServer() выполняется, когда пользователь нажимает клавишу Search для запуска процедуры поиска. Мы вызываем функцию connectToHost() объекта типа QTcpSocket для подсоединения к серверу, который, как мы предполагаем, доступен через порт 6178 по вымышленному адресу хоста tripserver.zugbahn.de. (Если вы собираетесь проверить работу этого примера на вашей машине, замените имя хоста на QHostAddress::LocalHost.) Вызов connectToHost() выполняется асинхронно; эта функция всегда немедленно возвращает управление. Соединение обычно устанавливается позже. Объект QTcpSocket генерирует сигнал connected(), если соединение успешно осуществлено и действует, или error(QAbstractSocket::SocketError), если соединение завершилось неудачей.
Затем мы обновляем интерфейс пользователя, в частности делаем видимым индикатор состояния приложения.
Наконец, мы устанавливаем переменную nextBlockSize на 0. Эта переменная содержит длину следующего блока, полученного от сервера. Мы задали значение 0, поскольку еще не знаем размер следующего блока.
01 void TripPlanner::sendRequest()
02 {
03 QByteArray block;
04 QDataStream out(&block, QIODevice::WriteOnly);
05 out.setVersion(QDataStream::Qt_4_1);
06 out << quint16(0) << quint8('S') << fromComboBox->currentText()
07 << toComboBox->currentText() << dateEdit->date()
08 << timeEdit->time();
09 if (departureRadioButton->isChecked()) {
10 out << quint8('D');
11 } else {
12 out << quint8('A');
13 }
14 out.device()->seek(0);
15 out << quint16(block.size() - sizeof(quint16));
16 tcpSocket.write(block);
17 statusLabel->setText(tr("Sending request..."));
18 }
Слот sendRequest() выполняется, когда объект QTcpSocket генерирует сигнал connected(), уведомляя об установке соединения. Задача этого слота — сгенерировать запрос к серверу с передачей всей введенной пользователем информации.
Запрос является двоичным блоком следующего формата:
• quint16 — размер блока в байтах (не учитывая данное поле),
• quint8 — тип запроса (всегда «S»),
• QString — пункт отправления,
• QString — пункт прибытия,
• QDate — дата поездки,
• QTime — примерное время отправления или прибытия,
• quint8 — признак времени отправления («D») или прибытия («А»).
Сначала мы записываем данные в массив типа QByteArray с именем block. Мы не можем писать данные непосредственно в QTcpSocket, поскольку мы не знаем размер блока, который будет отсылаться первым, пока не разместим все данные в блоке.
Сначала мы записываем 0 в поле размера блока и затем размещаем остальные данные. Затем мы делаем вызов seek(0) для устройства ввода—вывода (для установки на начало буфера QBuffer, создаваемого автоматически классом QDataStream), чтобы встать на начало массива байтов и переписать первоначальный 0 фактическим размером блока данных. Эта величина рассчитывается как размер блока за вычетом sizeof(quint16) (то есть 2), чтобы исключить поле с размером блока из общей суммы байтов. После этого мы вызываем функцию write() для объекта QTcpSocket, чтобы отослать этот блок на сервер.
01 void TripPlanner::updateTableWidget()
02 {
03 QDataStream in(&tcpSocket);
04 in.setVersion(QDataStream::Qt_4_1);
05 forever {
06 int row = tableWidget->rowCount();
07 if (nextBlockSize == 0) {
08 if (tcpSocket.bytesAvailable() < sizeof(quint16))
09 break;
10 in >> nextBlockSize;
11 }
12 if (nextBlockSize == 0xFFFF) {
13 closeConnection();
14 statusLabel->setText(tr("Found %1 trip(s)").arg(row));
15 break;
16 }
17 if (tcpSocket.bytesAvailable() < nextBlockSize)
18 break;
19 QDate date;
20 QTime departureTime;
21 QTime arrivalTime;
22 quint16 duration;
23 quint8 changes;
24 QString trainType;
25 in >> date >> departureTime >> duration >> changes >> trainType;
26 arrivalTime = departureTime.addSecs(duration * 60);
27 tableWidget->setRowCount(row + 1);
28 QStringList fields;
29 fields << date.toString(Qt::LocalDate)
30 << departureTime.toString(tr("hh:mm"))
31 << arrivalTime.toString(tr("hh:mm"))
32 << tr("%1 hr %2 min").arg(duration / 60).arg(duration % 60)
33 << QString::number(changes) << trainType;
34 for (int i = 0; i < fields.count(); ++i)
35 tableWidget->setItem(row, i, new QTableWidgetItem(fields[i]));
36 nextBlockSize = 0;
37 }
38 }
Слот updateTableWidget() подсоединяется к сигналу readyRead() класса QTcpSocket, который генерируется всякий раз при получении QTcpSocket новых данных от сервера.
Сервер пересылает нам список возможных железнодорожных рейсов, которые удовлетворяют критерию пользователя. Каждый рейс передается в виде одного блока, и каждый блок начинается с поля размера блока. Цикл forever необходим, потому что мы не обязательно получаем от сервера блоки по одному. Мы можем получить целый блок или только его часть или полтора блока либо даже все блоки сразу.
Рис. 14.2. Блоки приложения Trip Server.
Итак, как действует цикл forever? Если переменная nextBlockSize равна 0, это означает, что мы не прочитали размер следующего блока. Мы пытаемся прочитать его (предполагается, что имеется по крайней мере 2 байта). Сервер использует значение 0xFFFF в поле размера блока для указания на то, что все данные переданы, и поэтому, если мы обнаруживаем это значение, мы знаем, что достигнут конец.
Если размер блока не равен 0xFFFF, мы пытаемся считать следующий блок. Во-первых, мы проверяем наличие блока байтов необходимого размера. Если его нет, мы прерываем цикл. Сигнал readyRead() будет вновь сгенерирован, когда станет доступно больше данных, и мы попытаемся повторить процедуру.
Если мы уверены, что получен целый блок, мы можем спокойно использовать оператор >> для QDataStream для извлечения относящейся к поездкам информации, и мы создаем элементы QTableWidgetItem с этой информацией. Полученный от сервера блок имеет следующий формат:
• quint16 — размер блока в байтах (не учитывая данное поле),
• QDate — дата отправления,
• QTime — время отправления,
• quint16 — длительность поездки (в минутах),
• quint8 — количество пересадок,
• QString — тип поезда.
В конце мы вновь устанавливаем переменную nextBlockSize на 0 для указания того, что размер следующего блока неизвестен и его необходимо считать.
01 void TripPlanner::closeConnection()
02 {
03 tcpSocket.close();
04 searchButton->setEnabled(true);
05 stopButton->setEnabled(false);
06 progressBar->hide();
07 }
Закрытая функция closeConnection() закрывает соединение сервера TCP и обновляет интерфейс пользователя. Она вызывается из функции updateTableWidget(), когда считывается значение 0xFFFF, и из нескольких других слотов, которые мы вскоре рассмотрим.
01 void TripPlanner::stopSearch()
02 {
03 statusLabel->setText(tr("Search stopped"));
04 closeConnection();
05 }
Слот stopSearch() подсоединяется к сигналу clicked() кнопки Stop. По существу, он просто вызывает функцию closeConnection().
01 void TripPlanner::connectionClosedByServer()
02 {
03 if (nextBlockSize != 0xFFFF)
04 statusLabel->setText(tr("Error: Connection closed by server" ));
05 closeConnection();
06 }
Слот connectionClosedByServer() подсоединяется к сигналу disconnected() объекта QTcpSocket. Если сервер закрывает соединение и мы еще не получили маркер конца, мы уведомляем пользователя о возникновении ошибки. И как обычно, мы вызываем функцию closeConnection() для обновления интерфейса пользователя.
01 void TripPlanner::error()
02 {
03 statusLabel->setText(tcpSocket.errorString());
04 closeConnection();
05 }
Слот error() подсоединяется к сигналу error(QAbstractSocket::SocketError) объекта QTcpSocket. Мы игнорируем код ошибки и используем функцию QTcpSocket::errorString(), которая возвращает понятное человеку сообщение о последней возникшей ошибке.
На этом завершается рассмотрение класса TripPlanner. Функция main() приложения Trip Planner выглядит обычным образом:
01 int main(int argc, char *argv[])
02 {
03 QApplication app(argc, argv);
04 TripPlanner tripPlanner;
05 tripPlanner.show();
06 return app.exec();
07 }
Теперь давайте реализуем сервер. Сервер состоит из двух классов: TripServer и ClientSocket. Класс TripServer наследует QTcpServer — класс, который позволяет нам принимать входящие соединения TCP. Класс ClientSocket переопределяет QTcpSocket и обслуживает одно соединение. В каждый момент времени в памяти имеется ровно столько объектов типа ClientSocket, сколько обслуживается клиентов.
01 class TripServer : public QTcpServer
02 {
03 Q_OBJECT
04 public:
05 TripServer(QObject *parent = 0);
06 private:
07 void incomingConnection(int socketId);
08 };
Класс TripServer переопределяет функцию incomingConnection() из класса QTcpServer. Данная функция вызывается всякий раз, когда клиент пытается подсоединиться к порту, который прослушивает сервер.
01 TripServer::TripServer(QObject *parent)
02 : QTcpServer (parent)
03 {
04 }
Конструктор TripServer тривиален.
01 void TripServer::incomingConnection(int socketId)
02 {
03 ClientSocket *socket = new ClientSocket(this);
04 socket->setSocketDescriptor(socketId);
05 }
В функции incomingConnection() мы создаем объект ClientSocket в качестве дочернего по отношению к объекту TripServer, и мы устанавливаем дескриптор его coкета на переданное нам значение. Объект ClientSocket автоматически удалит сам себя при прекращении соединения.
01 class ClientSocket : public QTcpSocket
02 {
03 Q_OBJECT
04 public:
05 ClientSocket(QObject *parent = 0);
06 private slots:
07 void readClient();
08 private:
09 void generateRandomTrip(const QString &from, const QString &to,
10 const QDate &date, const QTime &time);
11 quint16 nextBlockSize;
12 };
Класс ClientSocket наследует QTcpSocket и инкапсулирует состояние одного клиента.
01 ClientSocket::ClientSocket(QObject *parent)
02 : QTcpSocket(parent)
03 {
04 connect(this, SIGNAL(readyRead()), this, SLOT(readClient()));
05 connect(this, SIGNAL(disconnected()), this, SLOT(deleteLater()));
06 nextBlockSize = 0;
07 }
В конструкторе мы устанавливаем необходимые соединения сигнал—слот и задаем переменной nextBlockSize значение 0, свидетельствующее о том, что мы еще не знаем размер посланного клиентом блока.
Сигнал disconnected() подсоединяется к функции deleteLater(), которая наследуется от класса QObject, и удаляет объект после возврата управления в цикл обработки событий Qt. Это обеспечивает удаление объекта ClientSocket после закрытия сокетного соединения.
01 void ClientSocket::readClient()
02 {
03 QDataStream in(this);
04 in.setVersion(QDataStream::Qt_4_1);
05 if (nextBlockSize == 0) {
06 if (bytesAvailable() < sizeof(quint16))
07 return;
08 in >> nextBlockSize;
09 }
10 if (bytesAvailable() < nextBlockSize)
11 return;
12 quint8 requestType;
13 QString from;
14 QString to;
15 QDate date;
16 QTime time;
17 quint8 flag;
18 in >> requestType;
19 if (requestType == 'S') {
20 in >> from >> to >> date >> time >> flag;
21 srand(from.length() * 3600 + to.length() * 60 + time.hour());
22 int numTrips = rand() % 8;
23 for (int i = 0; i < numTrips; ++i)
24 generateRandomTrip(from, to, date, time);
25 QDataStream out(this);
26 out << quint16(0xFFFF);
27 }
28 close();
29 }
Слот readClient() подсоединяется к сигналу readyRead() класса QTcpSocket. Если nextBlockSize равен 0, мы начинаем считывать размер блока; в противном случае он уже считан нами, и тогда мы проверяем поступление целого блока. Если это целый блок, мы считываем его за один шаг. Мы используем QDataStream непосредственно для QTcpSocket (объект this) и считываем поля, используя оператор >>.
После чтения запроса клиента мы готовы сформировать ответ. В реальном приложении мы осуществляли бы поиск информации в базе данных расписания железнодорожных рейсов и попытались бы найти подходящие рейсы. Но здесь мы воспользуемся функцией generateRandomTrip(), которая случайным образом генерирует произвольный рейс. Мы вызываем эту функцию произвольное число раз и затем посылаем 0xFFFF для обозначения конца данных. В конце мы закрываем соединение.
01 void ClientSocket::generateRandomTrip(const QString & /* откуда */,
02 const QString & /* куда */, const QDate &date, const QTime &time)
03 {
04 QByteArray block;
05 QDataStream out(&block, QIODevice::WriteOnly);
06 out.setVersion(QDataStream::Qt_4_1);
07 quint16 duration = rand() % 200;
08 out << quint16(0) << date << time << duration << quint8(1)
09 << QString("InterCity");
10 out.device()->seek(0);
11 out << quint16(block.size() - sizeof(quint16));
12 write(block);
13 }
Функция generateRandomTrip() демонстрирует способ пересылки блока данных через соединение TCP. Это очень напоминает то, что мы делали в клиенте в функции sendRequest(). И вновь мы записываем блок в массив QByteArray таким образом, что мы можем определять его размер до того, как мы его отошлем с помощью функции write().
01 int main(int argc, char *argv[])
02 {
03 QApplication app(argc, argv);
04 TripServer server;
05 if (!server.listen(QHostAddress::Any, 6178)) {
06 cerr << "Failed to bind to port" << endl;
07 return 1;
08 }
09 QPushButton quitButton(QObject::tr("&Quit"));
10 quitButton.setWindowTitle(QObject::tr("Trip Server"));
11 QObject::connect(&quitButton, SIGNAL(clicked()),
12 &app, SLOT(quit()));
13 quitButton.show();
14 return app.exec();
15 }
В функции main() мы создаем объект TripServer и кнопку QPushButton, которая позволяет пользователю остановить сервер. Работа сервера начинается с вызова функции QTcpSocket::listen(), принимающей адрес IP и номер порта, по которому мы хотим принимать соединения. Специальный адрес 0.0.0.0 (QHostAddress::Any) соответствует наличию любого интерфейса IP на локальном хосте.
Этим завершается наш пример системы клиент—сервер. В данном случае нами использовался блокоориентированный протокол, позволяющий применять объект типа QDataStream для чтения и записи данных. Если бы мы захотели использовать строкоориентированный протокол, наиболее простым было бы применение функций canReadLine() и readLine() класса QTcpSocket в слоте, подсоединенном к сигналу readyRead():
QStringList lines;
while (tcpSocket.canReadLine())
lines.append(tcpSocket.readLine());
Мы бы затем могли обрабатывать каждую считанную строку. Пересылка данных могла бы выполняться с использованием QTextStream для QTcpSocket.
Представленная здесь реализация сервера не очень эффективна в случае, когда соединений много. Это объясняется тем, что при обработке нами одного запроса мы не обслуживаем другие соединения. Более эффективным был бы запуск нового процесса для каждого соединения. Пример Threaded Fortune Server (многопоточный сервер, передающий клиентам интересные изречения, называемые «fortunes»), расположенный в каталоге Qt examples/network/threadedfortuneserver, демонстрирует, как это можно сделать.
Передача и прием дейтаграмм UDP
Класс QUdpSocket может использоваться для отправки и приема дейтаграмм UDP. UDP — это ненадежный, ориентированный на дейтаграммы протокол. Некоторые приложения применяют протокол UDP, поскольку с ним легче работать, чем с протоколом TCP. По протоколу UDP данные передаются пакетами (дейтаграммами) от одного хоста к другому. Для него не существует понятия соединения, и если доставка пакета UDP в пункт назначения завершается неудачей, никакого сообщения об ошибке не передается отправителю.
Рис. 14.3. Приложение Weather Station.
Мы рассмотрим способы применения UDP в приложении Qt на примере приложений Weather Balloon (метеозонд) и Weather Station (метеостанция). Приложение Weather Balloon является приложением без графического интерфейса, которое посылает каждые 2 секунды дейтаграммы UDP с параметрами текущего атмосферного состояния. Приложение Weather Station получает эти дейтаграммы и выводит их на экран. Мы начнем с рассмотрения программного кода приложения Weather Balloon.
01 class WeatherBalloon : public QPushButton
02 {
03 Q_OBJECT
04 public:
05 WeatherBalloon(QWidget *parent = 0);
06 double temperature() const;
07 double humidity() const;
08 double altitude() const;
09 private slots:
10 void sendDatagram();
11 private:
12 QUdpSocket udpSocket;
13 QTimer timer;
14 };
Класс WeatherBalloon наследует QPushButton. Он использует свою закрытую переменную типа QUdpSocket для обеспечения связи с приложением Weather Station.
01 WeatherBalloon::WeatherBalloon(QWidget *parent)
02 : QPushButton(tr("Quit"), parent)
03 {
03 connect(this, SIGNAL(clicked()), this, SLOT(close()));
04 connect(&timer, SIGNAL(timeout()), this, SLOT(sendDatagram()));
05 timer.start(2 * 1000);
06 setWindowTitle(tr("Weather Balloon"));
07 }
В конструкторе мы запускаем QTimer для вызова sendDatagram() через каждые 2 секунды.
01 void WeatherBalloon::sendDatagram()
02 {
03 QByteArray datagram;
04 QDataStream out(&datagram, QIODevice::WriteOnly);
05 out.setVersion(QDataStream::Qt_4_1);
06 out << QDateTime::currentDateTime() << temperature()
07 << humidity() << altitude();
08 udpSocket.writeDatagram(datagram, QHostAddress::LocalHost, 5824);
09 }
В sendDatagram() мы формируем и отсылаем дейтаграмму, содержащую текущую дату, время, температуру, влажность и высоту над уровнем моря.
• QDateTime — дата и время измерений,
• double — температура по Цельсию,
• double — влажность в процентах,
• double — высота над уровнем моря в метрах.
Эта дейтаграмма отсылается функцией QUdpSocket::writeBlock() (в коде "writeDatagram". wtf?). Вторым и третьим аргументами функции writeBlock() являются адрес IP и номер порта партнера (приложения Weather Station). В данном примере мы предполагаем, что приложение Weather Station выполняется на той же машине, на которой работает приложение Weather Balloon, и поэтому мы используем адрес IP 127.0.0.1 (QHostAddress::LocalHost) — специальный адрес, предназначенный для использования местными хостами.
В отличие от QAbstractSocket, класс QUdpSocket не получает имена хостов, а только их числовые адреса. Если нам нужно определить имя хоста по его адресу IP, мы имеем две возможности. Если мы готовы блокировать работу во время выполнения поиска, мы можем использовать статическую функцию QHostInfo::fromName(). В противном случае мы можем использовать статическую функцию QHostInfo::lookupHost(), которая немедленно возвращает управление и вызывает слот с передачей в качестве аргумента объекта QHostInfo, который будет содержать соответствующие адреса после завершения поиска.
01 int main(int argc, char *argv[])
02 {
03 QApplication app(argc, argv);
04 WeatherBalloon balloon;
05 balloon.show();
06 return app.exec();
07 }
Функция main() просто создает объект WeatherBalloon, кoтopый являeтcя yчacтником связи по протоколу UDP и одновременно представлен на экране кнопкой QPushButton. Нажимая кнопку QPushButton, пользователь может завершить приложение.
Теперь давайте рассмотрим исходный код клиентского приложения Weather Station.
01 class WeatherStation : public QDialog
02 {
03 Q_OBJECT
04 public:
05 WeatherStation(QWidget *parent = 0);
06 private slots:
07 void processPendingDatagrams();
08 private:
09 QUdpSocket udpSocket;
10 QLabel *dateLabel;
11 QLabel *timeLabel;
12 QLineEdit *altitudeLineEdit;
13 };
Класс WeatherStation наследует QDialog. Он прослушивает определенный порт UDP, выполняет синтаксический разбор поступающих дейтаграмм (от приложения Weather Balloon) и выводит на экран их содержимое в виде пяти строк редактирования QLineEdit, которые используются только для вывода данных. Здесь нас интересует только одна закрытая переменная udpSocket типа QUdpSocket, которая будет использована для приема дейтаграмм.
01 WeatherStation::WeatherStation(QWidget *parent)
02 : QDialog(parent)
03 {
04 udpSocket.bind(5824);
05 connect(&udpSocket, SIGNAL(readyRead()),
06 this, SLOT(processPendingDatagrams()));
07 }
Конструктор мы начинаем с привязки объекта QUdpSocket к порту, на который передает данные метеозонд. Поскольку мы не указали адрес хоста, сокет будет принимать дейтаграммы, посланные на любой адрес IP, принадлежащий машине, на которой работает приложение Weather Station. Затем мы связываем сигнал сокета readyRead() c закрытым слотом processPendingDatagrams(), который извлекает данные и отображает их на экране.
01 void WeatherStation::processPendingDatagrams()
02 {
03 QByteArray datagram;
04 do {
05 datagram.resize(udpSocket.pendingDatagramSize());
06 udpSocket.readDatagram(datagram.data(), datagram.size());
07 } while (udpSocket.hasPendingDatagrams());
08 QDateTime dateTime;
09 double temperature;
10 double humidity;
11 double altitude;
12 QDataStream in(&datagram, QIODevice::ReadOnly);
13 in.setVersion(QDataStream::Qt_4_1);
14 in >> dateTime >> temperature >> humidity >> altitude;
15 dateLineEdit->setText(dateTime.date().toString());
16 timeLineEdit->setText(dateTime.time().toString());
17 temperatureLineEdit->setText(tr("%1° C").arg(temperature));
18 humidityLineEdit->setText(tr("%1%").arg(humidity));
19 altitudeLineEdit->setText(tr("%1 m").arg(altitude));
20 }
Слот processPendingDatagrams() вызывается при получении дейтаграммы. QUdpSocket ставит в очередь поступившие дейтаграммы и позволяет получать к ним доступ последовательно в порядке очереди. Обычно в очереди будет только одна дейтаграмма, однако нельзя исключать возможность передачи отправителем последовательно нескольких дейтаграмм до генерации сигнала readyRead(). В этом случае мы игнорируем все дейтаграммы, кроме последней, поскольку предыдущие дейтаграммы содержат устаревшие параметры атмосферного состояния.
Функция pendingDatagramSize() возвращает размер первой ждущей обработки дейтаграммы. С точки зрения приложения дейтаграммы всегда посылаются и принимаются как один блок данных. Это означает, что при любом количестве байтов дейтаграмма будет считываться целиком. Вызов readDatagram() копирует содержимое первой ждущей обработки дейтаграммы в указанный буфер char * (обрезая данные, если размер буфера оказывается недостаточным) и осуществляет переход к следующей необработанной дейтаграмме. После считывания всех дейтаграмм мы разбиваем последнюю из них (имеющую самые свежие значения параметров атмосферного состояния) на составные части и заполняем строки редактирования QLineEdit новыми данными.
01 int main(int argc, char *argv[])
02 {
03 QApplication app(argc, argv);
04 WeatherStation station;
05 station.show();
06 return app.exec();
07 }
Наконец, в функции main() мы создаем и показываем объект WeatherStation.
На этом мы завершаем рассмотрение наших примеров по передаче и приему данных с применением протокола UDP. Представленные приложения максимально упрощены, причем приложение Weather Balloon посылает дейтаграммы, а приложение Weather Station получает их. В большинстве реальных приложений в обоих случаях пришлось бы как считывать, так записывать данные на свой сокет. Функциям QUdpSocket::writeDatagram() могут передаваться адрес хоста и номер порта, поэтому QUdpSocket может читать с хоста и порта, с которыми он был связан функцией bind(), и писать на какой-нибудь другой хост и порт.
Глава 15. XML
XML (Extensible Markup Language — расширяемый язык разметки) — это универсальный формат текстовых файлов, который получил широкое распространение при обмене и хранении данных. Qt обеспечивает два различных программных интерфейса для чтения документов XML; эти интерфейсы входят в состав модуля QtXml:
• SAX (Simple API for XML — простой программный интерфейс для документов XML) позволяет обрабатывать «события синтаксического анализа» непосредственно в приложении в соответствующих виртуальных функциях.
• DOM (Document Object Model — объектная модель документа) преобразует документ XML в структуру в виде дерева, которая затем может обрабатываться в приложении.
Существует много факторов, которые необходимо учитывать в каждом конкретном случае при выборе между DOM и SAX. SAX является интерфейсом более низкого уровня и обычно работает быстрее, что делает его особенно пригодным как для решения простых задач (например, для поиска в документе XML всех повторений заданного тега), так и для чтения очень больших файлов, которые не помещаются в оперативной памяти. Но для большинства приложений удобство применения DOM перевешивает потенциальные преимущества более высокого быстродействия и более эффективного использования памяти в SAX.
Создавать файлы XML можно двумя способами: мы можем сгенерировать XML вручную или представить данные в виде дерева DOM, размещенного в памяти, и «попросить» это дерево записать себя в файл.
Чтение документов XML при помощи интерфейса SAX
SAX является фактическим стандартом программного интерфейса с открытым исходным кодом, который обеспечивает чтение документов XML.
Классы Qt для интерфейса SAX моделируют реализацию SAX2 Java с некоторыми отличиями в названиях для обеспечения принятых в Qt правил обозначений названий классов и их членов. Более подробную информацию относительно SAX можно получить в сети Интернет по адресу .
Qt обеспечивает построенный на основе интерфейса SAX парсер документов XML, не предусматривающий проверку их достоверности под названием QXmlSimpleReader. Этот парсер распознает хорошо сформированные документы XML и поддерживает пространства имен XML. Когда парсер обрабатывает документ, он вызывает виртуальные функции в зарегистрированных классах—обработчиках, уведомляющих о возникновении соответствующих событий в ходе синтаксического анализа документа. (Эти события никак не связаны с такими событиями Qt, как события клавиатуры и события мышки.) Например, пусть парсер выполняет анализ следующего документа XML:
Ars longa vita brevis
В этом случае парсер вызовет следующие обработчики событий синтаксического анализа:
startDocument()
startElement("doc")
startElement("quote")
characters("Ars longa vita brevis")
endElement("quote")
endElement("doc")
endDocument()
Все приведенные выше функции объявлены в классе QXmlContentHandler. Для простоты мы не стали указывать некоторые аргументы функций startElement() и endElement().
QXmlContentHandler — это всего лишь один из многих классов—обработчиков, которые могут использоваться совместно с классом QXmlSimpleReader. Другими такими классами являются QXmlEntityResolver, QXmlDTDHandler, QXmlErrorHandler, QXmlDeclHandler и QXmlLexicalHandler. Эти классы только объявляют чистые виртуальные функции и предоставляют информацию о различных событиях синтаксического анализа. Для большинства приложений вполне достаточно использовать лишь классы QXmlContentHandler и QXmlErrorHandler.
Для удобства Qt также предоставляет класс QXmlDefaultHandler, который наследует все классы—обработчики и обеспечивает очень простую реализацию всех функций. Такая конструкция со множеством абстрактных классов—обработчиков и одним подклассом с тривиальной реализацией функций необычна для Qt; она принята для максимального соответствия модели Java—реализации.
Теперь мы рассмотрим пример, который показывает способы применения QXmlSimpleReader и QXmlDefaultHandler для синтаксического анализа файла XML заранее известного формата и для отображения его содержимого в виджете QTreeWidget. Подкласс QXmlDefaultHandler имеет название SaxHandler, и он используется для обработки предметного указателя книги, который содержит элементы и подэлементы.
Рис. 15.1. Дерево наследования для SaxHandler.
Ниже приводится файл предметного указателя книги, который отображается в виджете QTreeWidget и показан на рис. 15.2:
10
34-35
307-308
115
244
9
Рис. 15.2. Файл предметного указателя книги, загруженный в виджет QTreeWidget.
Первый этап в реализации парсера заключается в создании подкласса QXmlDefaultHandler:
01 class SaxHandler : public QXmlDefaultHandler
02 {
03 public:
04 SaxHandler(QTreeWidget *tree);
05 bool startElement(const QString &namespaceURI,
06 const QString &localName,
07 const QString &qName,
08 const QXmlAttributes &attributes);
09 bool endElement(const QString &namespaceURI,
10 const QString &localName,
11 const QString &qName);
12 bool characters(const QString &str);
13 bool fatalError(const QXmlParseException &exception);
14 private:
15 QTreeWidget *treeWidget;
16 QTreeWidgetItem *currentItem;
17 QString currentText;
18 };
Класс SaxHandler наследует QXmlDefaultHandler и переопределяет четыре функции: startElement(), endElement(), characters() и fatalError(). Первые четыре функции объявлены в QXmlContentHandler; последняя функция объявлена в QXmlErrorHandler.
01 SaxHandler::SaxHandler(QTreeWidget *tree)
02 {
03 treeWidget = tree;
04 currentItem = 0;
05 }
Конструктор SaxHandler принимает объект типа QTreeWidget, который мы собираемся заполнять информацией, содержащейся в файле XML.
01 bool SaxHandler::startElement(const QString & /* namespaceURI */,
02 const QString & /* localName */,
03 const QString &qName,
04 const QXmlAttributes &attributes)
05 {
06 if (qName == "entry") {
07 if (currentItem) {
08 currentItem = new QTreeWidgetItem(currentItem);
09 } else {
10 currentItem = new QTreeWidgetItem(treeWidget);
11 }
12 currentItem->setText(0, attributes.value("term"));
13 } else if (qName == "page") {
14 currentText.clear();
15 }
16 return true;
17 }
Функция startElement() вызывается, когда обнаруживается новый открывающий тег. Третий параметр представляет собой имя тега (или точнее — «подходящее имя»). В четвертом параметре задается список атрибутов. В этом примере мы игнорируем первый и второй параметры. Они полезны для тех файлов XML, которые используют механизм пространств имен, подробно описанный в справочной документации.
Если обнаружен тег , мы создаем новый элемент списка QTreeWidget. Если данный тег является вложенным в другой тег , новый тег определяет подэлемент предметного указателя, и новый элемент QTreeWidgetItem создается как дочерний по отношению к внешнему элементу QTreeWidgetItem. В противном случае мы создаем элемент QTreeWidgetItem, используя в качестве родительского элемента объект treeWidget, делая его элементом верхнего уровня. Мы вызываем функцию setText() для отображения в столбце 0 текста со значением атрибута term тега .
Если обнаружен тег , мы устанавливаем значение переменной currentText на пустую строку. В переменной currentText накапливается текст, расположенный между тегами и .
В конце мы возвращаем true, указывая SAX на необходимость продолжения синтаксического анализа файла. Если бы нам нужно было сообщить об ошибке из-за обнаружения неизвестного тега, мы возвращали бы в этих случаях false. Нам также потребовалось бы переопределить функцию errorString() класса QXmlDefaultHandler для возврата соответствующего сообщения об ошибке.
01 bool SaxHandler::characters(const QString &str)
02 {
03 currentText += str;
04 return true;
05 }
Функция characters() используется для извлечения символьных данных из документа XML. Мы просто добавляем символы в конец переменной currentText.
01 bool SaxHandler::endElement(const QString & /* namespaceURI */,
02 const QString & /* localName */, const QString &qName)
03 {
04 if (qName == "entry") {
05 currentItem = currentItem->parent();
06 } else if (qName == "page") {
07 if (currentItem) {
08 QString allPages = currentItem->text(1);
09 if (!allPages.isEmpty())
10 allPages += ", ";
11 allPages += currentText;
12 currentItem->setText(1, allPages);
13 }
14 }
15 return true;
16 }
Функция endElement() вызывается при обнаружении закрывающего тега. Так же как и для функции startElement(), ее третий параметр содержит имя тега.
Если обнаружен тег , мы устанавливаем закрытую переменную currentItem на родительский элемент текущего элемента QTreeWidgetItem. Это обеспечивает восстановление переменной currentItem на значение, которое она имела перед чтением соответствующего тега .
Если обнаружен тег , мы добавляем указанный номер страницы или диапазон страниц в разделяемый запятыми список в столбце 1 текущего элемента.
01 bool SaxHandler::fatalError(const QXmlParseException &exception)
02 {
03 QMessageBox::warning(0, QObject::tr("SAX Handler"),
04 QObject::tr("Parse error at line %1, column %2:\n%3.")
05 .arg(exception.lineNumber())
06 .arg(exception.columnNumber())
07 .arg(exception.message()));
08 return false;
09 }
Функция fatalError() вызывается, когда синтаксический анализ файла XML завершается неудачей. В этом случае мы просто выводим на экран сообщение, указывая номер строки, номер столбца и текст об ошибке синтаксического анализа.
Этим мы завершаем реализацию класса SaxHandler. Теперь давайте посмотрим, как можно использовать этот класс:
01 bool parseFile(const QString &fileName)
02 {
03 QStringList labels;
04 labels << QObject::tr("Terms") << QObject::tr("Pages");
05 QTreeWidget *treeWidget = new QTreeWidget;
06 treeWidget->setHeaderLabels(labels);
07 treeWidget->setWindowTitle(QObject::tr("SAX Handler"));
08 treeWidget->show();
09 QFile file(fileName);
10 QXmlInputSource inputSource(&file);
11 QXmlSimpleReader reader;
12 SaxHandler handler(treeWidget);
13 reader.setContentHandler(&handler);
14 reader.setErrorHandler(&handler);
15 return reader.parse(inputSource);
16 }
Мы задаем два столбца в виджете QTreeWidget. Затем мы создаем объект типа QFile для считываемого файла и объект типа QXmlSimpleReader для синтаксического анализа файла. Нам не требуется самим открывать QFile; QXmlInputSource делает это автоматически.
Наконец, мы создаем объект типа SaxHandler, который используется для объекта reader одновременно в качестве обработчика содержимого файла и обработчика ошибок, и мы вызываем функцию parse() для выполнения синтаксического анализа.
Вместо простого объекта файла мы передаем функции parse() объект QXmlInputSource. Этот класс открывает заданный файл, читает его (учитывая кодировку символов в объявлении ) и предоставляет интерфейс для чтения файла парсером.
В классе SaxHandler мы всего лишь переопределили функции, унаследованные от классов QXmlContentHandler и QXmlErrorHandler. Если бы мы стали переопределять функции других классов—обработчиков, нам пришлось бы вызывать соответствующие функции—установщики для объекта reader.
Для сборки приложения с библиотекой QtXml в файл .pro необходимо добавить следующую строку:
QT += xml
Чтение документов XML при помощи интерфейса DOM
DOM является стандартным программным интерфейсом синтаксического анализа документов XML, который разработан Консорциумом всемирной паутины (W3C). Qt обеспечивает уровень 2 интерфейса DOM для чтения, обработки и записи документов XML без проверки их достоверности.
DOM представляет файл XML в памяти в виде дерева. Мы можем просматривать дерево DOM столько раз, сколько нам нужно, и мы можем модифицировать и записывать его на диск в виде файла XML.
Давайте рассмотрим следующий документ XML:
Ars longa vita brevis
Art is long, life is short
Ему соответствует следующее дерево DOM:
Дерево DOM содержит узлы разных типов. Например, узел Element соответствует открывающему тегу и связанному с ним закрывающему тегу. Все, что располагается между этими тегами, представляется в виде дочерних узлов данного элемента Element.
В Qt различные типы таких узлов (как и все другие связанные с DOM классы) имеют префикс QDom. Так, QDomElement представляет узел Element, a QDomText представляет узел Text.
Различные узлы могут иметь дочерние узлы разных типов. Например, узел Element может содержать другие узлы Element, а также узлы EntityReference, Text, CDATASection, ProcessingInstruction и Comment. Рис. 15.3 показывает, какие типы дочерних узлов допустимы для соответствующих родительских узлов. Узлы, показанные серым, не могут иметь дочерних узлов.
Рис. 15.3. Родственные связи между узлами DOM.
Для иллюстрации применения DOM при чтении файлов XML мы напишем парсер для файла предметного указателя книги, описанного в предыдущем разделе.
01 class DomParser
02 {
03 public:
04 DomParser(QIODevice *device, QTreeWidget *tree);
05 private:
06 void parseEntry(const QDomElement &element,
07 QTreeWidgetItem *parent);
08 QTreeWidget *treeWidget;
09 };
Мы определяем класс с названием DomParser, который выполняет синтаксический анализ предметного указателя книги, представленного в виде документа XML, и отображает результат в виджете QTreeWidget. Этот класс не наследует никакой другой класс.
01 DomParser::DomParser(QIODevice *device, QTreeWidget *tree)
02 {
03 treeWidget = tree;
04 QString errorStr;
05 int errorLine;
06 int errorColumn;
07 QDomDocument doc;
08 if (!doc.setContent(device, true, &errorStr,
09 &errorLine, &errorColumn)) {
10 QMessageBox::warning(0, QObject::tr("DOM Parser"),
11 QObject::tr("Parse error at line %1, column %2:\n%3")
12 .arg(errorLine).arg(errorColumn).arg(errorStr));
13 return;
14 }
15 QDomElement root = doc.documentElement();
16 if (root.tagName() != "bookindex")
17 return;
18 QDomNode node = root.firstChild();
19 while (!node.isNull()) {
20 if (node.toElement().tagName() == "entry")
21 parseEntry(node.toElement(), 0);
22 node = node.nextSibling();
23 }
24 }
В конструкторе мы создаем объект QDomDocument и вызываем для него функцию setContent(), чтобы с его помощью прочесть документ XML с устройства QIODevice. Функция setContent() автоматически открывает устройство, если оно еще не открыто. Затем мы вызываем функцию documentElement() для объекта QDomDocument, чтобы получить его одиночный дочерний элемент QDomElement, после чего мы проверяем, является ли данный элемент . Мы выполняем цикл по всем дочерним узлам, и если узлом является элемент , мы вызываем функцию parseEntry() для его синтаксического анализа.
Класс QDomNode может хранить узлы любого типа. Если мы хотим продолжить обработку узла, мы должны сначала преобразовать его в правильный тип данных. В нашем примере нас интересуют только узлы Element, и поэтому мы вызываем функцию toElement() объекта QDomNode для преобразования его в объект QDomElement и затем вызова функции tagName() для получения имени тега элемента. Если данный узел не имеет тип Element, функция toElement() возвращает нулевой объект типа QDomElement, содержащий пустое имя тега.
01 void DomParser::parseEntry(const QDomElement &element,
02 QTreeWidgetItem *parent)
03 {
04 QTreeWidgetItem *item;
05 if (parent) {
06 item = new QTreeWidgetTtem(parent);
07 } else {
08 item = new QTreeWidgetItem(treeWidget);
09 }
10 item->setText(0, element.attribute("term"));
11 QDomNode node = element.firstChild();
12 while (!node.isNull()) {
13 if (node.toElement().tagName() == "entry") {
14 parseEntry(node.toElement(), item);
15 } else if (node.toElement().tagName() == "page") {
16 QDomNode childNode = node.firstChild();
17 while (!childNode.isNull()) {
18 if (childNode.nodeType() == QDomNode::TextNode) {
19 QString page = childNode.toText().data();
20 QString allPages = item->text(1);
21 if (!allPages.isEmpty())
22 allPages += ", ";
23 allPages += page;
24 item->setText(1, allPages);
25 break;
26 }
27 childNode = childNode.nextSibling();
28 }
29 }
30 node = node.nextSibling();
31 }
32 }
В функции parseEntry() мы создаем элемент объекта QTreeWidget. Если тег вложен в другой , новый тег определяет подэлемент предметного указателя, и мы создаем элемент QTreeWidgetItem как дочерний для внешнего элемента QTreeWidgetItem. В противном случае мы создаем элемент QTreeWidgetItem с treeWidget в качестве его родительского элемента, делая его элементом верхнего уровня. Мы вызываем функцию setText() для установки текста столбца 0 на значение атрибута term тега .
После инициализации нами элемента QTreeWidgetItem мы выполняем цикл по дочерним узлам элемента QDomElement, который соответствует текущему тегу .
Если элементом является , мы вызываем функцию parseEntry(), передавая текущий элемент в качестве второго аргумента. Затем будет создан новый элемент QTreeWidgetItem, в качестве родительского элемента которого выступает внешний элемент QTreeWidgetItem.
Если элементом является , мы просматриваем список дочерних элементов для поиска узла Text. После его обнаружения мы вызываем функцию toText() для преобразования его в объект типа QDomText и функцию data() для получения текста в виде строки типа QString. Затем мы добавляем текст в разделяемый запятыми список номеров страниц в столбце 1 элемента QTreeWidgetItem.
Давайте теперь посмотрим, как мы можем использовать класс DomParser для синтаксического анализа файла:
01 void parseFile(const QString &fileName)
02 {
03 QStringList labels;
04 labels << QObject::tr("Terms") << QObject::tr("Pages");
05 QTreeWidget *treeWidget = new QTreeWidget;
06 treeWidget->setHeaderLabels(labels);
07 treeWidget->setWindowTitle(QObject::tr("DOM Parser"));
08 treeWidget->show();
09 QFile file(fileName);
10 DomParser(&file, treeWidget);
11 }
Мы начинаем с настройки QTreeWidget. Затем мы создаем объекты QFile и DomParser. При выполнении конструктора DomParser осуществляется синтаксический анализ файла и пополняется виджет дерева.
Как и в предыдущем примере, для сборки приложения с библиотекой QtXml в файл .pro необходимо добавить следующую строку:
QT += xml
Как показывает наш пример, проход по дереву DOM может быть достаточно непростым делом. Простая операция по извлечению текста между тегами и требует обработки в цикле элементов списка при помощи функций firstChild() и nextSibling() класса QDomNode. Программисты, которым очень часто приходится использовать интерфейс DOM, создают свои собственные высокоуровневые функции—оболочки для упрощения выполнения таких наиболее распространенных операций, как извлечение текста между открывающими и закрывающими тегами.
Запись документов XML
Существует два основных подхода к формированию файлов XML в приложениях Qt:
• мы можем построить дерево DOM и вызвать для него функцию save();
• мы можем сформировать файл XML вручную.
Выбор между этими подходами часто не зависит от типа используемого нами интерфейса для чтения документов XML: SAX или DOM.
Ниже приводится фрагмент программного кода, который иллюстрирует способ создания дерева DOM и его записи при помощи QTextStream:
const int Indent = 4;
QDomDocument doc;
QDomElement root = doc.createElement("doc");
QDomElement quote = doc.createElement("quote");
QDomElement translation = doc.createElement("translation");
QDomText latin = doc.createTextNode("Ars longa vita brevis");
QDomText english = doc.createTextNode("Art is long, life is short");
doc.appendChild(root);
root.appendChild(quote);
root.appendChild(translation);
quote.appendChild(latin);
translation.appendChild(english);
QTextStream out(&file);
doc.save(out, Indent);
Второй аргумент функции save() задает размер отступа. При ненулевом его значении читаемость сформированного файла будет лучше. Ниже приводится полученный на выходе файл XML:
....Ars longa vita brevis
....Art is long, life is short
Порядок действий будет другим, если в приложении дерево DOM используется в качестве главной структуры данных. В таких случаях приложения обычно считывают документы XML, применяя интерфейс DOM, затем модифицируют в памяти дерево DOM и, наконец, вызывают функцию save() для обратного преобразования дерева в документ XML.
По умолчанию функция QDomDocument::save() использует для генерации файла кодировку UTF-8. Мы можем применить другую кодировку, если добавить XML—объявление, например такое, как
в начало дерева DOM. Следующий фрагмент программного кода показывает, как это делать:
QTextStream out(&file);
QDomNode xmlNode = doc.createProcessingInstruction("xml",
"version=\"1.0\" encoding=\"ISO-8859-1\"");
doc.insertBefore(xmlNode, doc.firstChild());
doc.save(out, Indent);
Формирование файлов XML вручную выполняется не намного сложнее, чем при помощи DOM. Мы можем использовать QTextStream и писать строки, как мы бы делали с любым другим текстовым файлом. Наиболее сложным является вставка специальных символов в текст и значения атрибутов. Функция Qt::escape() заменяет символы '<', '>' и '&'. Ниже приводится пример ее использования:
QTextStream out(&file);
out.setCodec("UTF-8");
out << "\n"
<< " " << Qt::escape(quoteText) << " \n"
<< " " << Qt::escape(translationText) << "\n"
<< "\n";
В статье «Generating XML» (Формирование документов XML) в журнале «Qt Quarterly», доступной в сети Интернет по адресу , рассматривается очень простой класс, позволяющий легко формировать файлы XML. Этот класс решает вопросы, связанные со специальными символами, отступами и кодировкой, позволяя нам полностью сконцентрироваться на документе XML, который мы собираемся формировать. Он предназначен для работы с Qt 3, но его очень легко перенести на Qt 4.
Глава 16. Обеспечение интерактивной помощи
Большинство приложений предоставляют своим пользователям систему помощи, работающую в интерактивном режиме. В некоторых случаях эта помощь носит форму коротких сообщений, например, в виде всплывающих подсказок, комментариев в строке состояния и справок «что это такое?». Все это, естественно, поддерживается в Qt. В других случаях система помощи может быть значительно сложнее и может содержать много страниц текста. Для такого рода систем вы можете воспользоваться классом QTextBrowser в качестве простого браузера системы помощи, а также вы можете вызывать из вашего приложения Qt Assistant или другой браузер файлов HTML.
Всплывающие подсказки, комментарии в строке состояния и справки «что это такое?»
Всплывающая подсказка (tooltip) представляет собой небольшое текстовое сообщение, которое появляется при нахождении курсора мышки на виджете в течение определенного времени. Всплывающие подсказки отображаются на желтом фоне черными буквами. В основном они предназначены для пояснения назначения кнопок на панели инструментов.
Мы можем добавлять всплывающие подсказки к любым виджетам путем включения в программный код вызова функции QWidget::setToolTip(). Например:
findButton->setToolTip(tr("Find next"));
Для установки всплывающей подсказки для объекта QAction, который может быть добавлен к меню или панели инструментов, мы можем просто вызвать функцию setToolTip() для этой команды. Например:
newAction = new QAction(tr("&New"), this);
newAction->setToolTip(tr("New document"));
Если мы явно не устанавливаем всплывающую подсказку, QAction автоматически сформирует ее на основе текста команды.
Комментарии в строке состояния (status tip) также представляют собой короткие текстовые сообщения, причем они обычно немного длиннее всплывающих подсказок. При нахождении курсора мышки на кнопке панели инструментов или на строке меню такой комментарий появляется в строке состояния. Для добавления к команде или к виджету отображаемого в строке состояния комментария необходимо вызвать функцию setStatusTip():
newAction->setStatusTip(tr("Create a new document"));
Рис. 16.1. В этом приложении отображаются всплывающая подсказка и комментарий в строке состояния.
В некоторых ситуациях желательно обеспечить больше информации о виджете, чем это возможно сделать с помощью всплывающих подсказок или комментариев в строке состояния. Например, у нас может возникнуть потребность в обеспечении сложного диалогового окна с пояснительным текстом для каждого поля без принуждения пользователя к вызову отдельного окна системы помощи. Режим «что это такое?» идеально подходит для этого. Когда окно находится в режиме «что это такое?», курсор приобретает форму «?» и пользователь может щелкнуть по любому компоненту интерфейса пользователя для получения текста помощи. Для входа в режим «что это такое?» пользователь может либо нажать на кнопку «?» в строке заголовка диалогового окна (в системе Windows и KDE), либо нажать сочетание клавиш Shift+F1.
Ниже приводится пример установки для диалогового окна текста справки «что это такое?»:
dialog->setWhatsThis(tr("![](\":/images/icon.png\") "
" The meaning of the Source field depends "
"on the Type field:"
" "));
Мы можем применять теги HTML для форматирования текста справки «что это такое?». В нашем примере мы используем изображение (которое указано в файле ресурсов приложения), маркированный список и жирный текст в некоторых местах. Теги и атрибуты, которые поддерживаются в Qt, приведены на веб-странице .
Рис. 16.2. Диалоговое окно с отображением текста справки «что это такое?»
Кроме того, мы можем задавать текст справки «что это такое?» для команды:
openAct->setWhatsThis(tr(" "
"Click this option to open an existing file."));
При задании для команды текста справки «что это такое?» он будет отображаться, когда пользователь в режиме справки «что это такое?» выбирает пункт меню, нажимает кнопку на панели инструментов или клавишу быстрого вызова команды. Когда компоненты пользовательского интерфейса главного окна приложения предусматривают вывод справки «что это такое?», обычно в меню Help (справка) содержится пункт What's This? (что это такое?) и панель инструментов содержит соответствующую кнопку. Это можно сделать путем создания команды What's This? при помощи статической функции QWhatsThis::createAction() и добавления возвращаемой ею команды в меню Help и в панель инструментов. Класс QWhatsThis предоставляет также статические функции для программного входа и выхода из режима справки «что это такое?».
Использование
QTextBrowser
в качестве простого браузера системы помощи
Для больших приложений может потребоваться более сложная система помощи в отличие от той, которую обычно обеспечивают всплывающие подсказки, комментарии в строке состояния и справки «что это такое?». Простое решение состоит в применении браузера системы помощи. Приложения, которые включают в себя браузер системы помощи, обычно имеют подпункт меню Help в меню Help главного окна и кнопку Help в каждом диалоговом окне.
В данном разделе мы представим простой браузер системы помощи, показанный на рис. 16.3, и покажем, как его можно использовать в приложении. Окно приложения применяет QTextBrowser для вывода на экран страниц справки, представленных в формате HTML. QTextBrowser может обрабатывать много тегов HTML, и поэтому он идеально подходит для этих целей.
Мы начинаем с заголовочного файла:
01 #include
02 class QPushButton;
03 class QTextBrowser;
04 class HelpBrowser : public QWidget
05 {
06 Q_OBJECT
07 public:
08 HelpBrowser(const QString &path,
09 const QString &page, QWidget *parent = 0);
10 static void showPage(const QString &page);
11 private slots:
12 void updateWindowTitle();
13 private:
14 QTextBrowser *textBrowser;
15 QPushButton *homeButton;
16 QPushButton *backButton;
17 QPushButton *closeButton;
18 };
Класс HelpBrowser содержит статическую функцию, которую можно вызывать в любом месте в приложении. Данная функция создает окно HelpBrowser и выводит на экран заданную страницу.
Рис. 16.3. Виджет HelpBrowser.
Ниже приводится начало реализации:
01 #include
02 #include "helpbrowser.h"
03 HelpBrowser::HelpBrowser(const QString &path,
04 const QString &page, QWidget *parent)
05 : QWidget(parent)
06 {
07 setAttribute(Qt::WA_DeleteOnClose);
08 setAttribute(Qt::WA_GroupLeader);
09 textBrowser = new QTextBrowser;
10 homeButton = new QPushButton(tr("&Home"));
11 backButton = new QPushButton(tr("&Back"));
12 closeButton = new QPushButton(tr("Close"));
13 closeButton->setShortcut(tr("Esc"));
14 QHBoxLayout *buttonLayout = new QHBoxLayout;
15 buttonLayout->addWidget(homeButton);
16 buttonLayout->addWidget(backButton);
17 buttonLayout->addStretch();
18 buttonLayout->addWidget(closeButton);
19 QVBoxLayout *mainLayout = new QVBoxLayout;
20 mainLayout->addLayout(buttonLayout);
21 mainLayout->addWidget(textBrowser);
22 setLayout(mainLayout);
23 connect(homeButton, SIGNAL(clicked()),
24 textBrowser, SLOT(home()));
25 connect(backButton, SIGNAL(clicked()),
26 textBrowser, SLOT(backward()));
27 connect(closeButton, SIGNAL(clicked()),
28 this, SLOT(close()));
29 connect(textBrowser, SIGNAL(sourceChanged(const QUrl &)),
30 this, SLOT(updateWindowTitle()));
31 textBrowser->setSearchPaths(QStringList() << path << ":/images");
32 textBrowser->setSource(page);
33 }
Мы устанавливаем атрибут Qt::WA_GroupLeader, потому что хотим выдавать окна HelpBrowser не только из главного окна, но также из модальных диалоговых окон. Обычно модальные диалоговые окна не позволяют пользователям работать с другими окнами приложения. Однако очевидно, что после запроса помощи пользователь должен иметь возможность работать как с модальным диалоговым окном, так и с браузером системы помощи. Установка атрибута Qt::WA_GroupLeader делает возможным такой режим работы.
Мы обеспечиваем два пути поиска: первый определяет путь в файловой системе к документации приложения, а второй определяет расположение ресурсов изображений. HTML может содержать обычные ссылки на изображения в файловой системе и ссылки на ресурсы изображений, пути которых начинаются с символов :/ (двоеточие и слеш). Параметр page содержит имя файла документации с возможным указанием метки HTML (anchor).
01 void HelpBrowser::updateWindowTitle()
02 {
03 setWindowTitle(tr("Help: %1")
04 .arg(textBrowser->documentTitle()));
05 }
При всяком изменении исходной страницы вызывается слот updateWindowTitle(). Функция documentTitle() возвращает текст, содержащийся в теге этой страницы. </p>
<p class="paragraph">
01 void HelpBrowser::showPage(const QString &page) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 QString path = QApplication::applicationDirPath() + "/doc"; </p>
<p class="paragraph">
04 HelpBrowser *browser = new HelpBrowser(path, page); </p>
<p class="paragraph">
05 browser->resize(500, 400); </p>
<p class="paragraph">
06 browser->show(); </p>
<p class="paragraph">
07 } </p>
<p class="paragraph">
В статической функции showPage() мы создаем окно HelpBrowser и затем выдаем его на экран. Это окно будет удалено автоматически, когда пользователь закроет его, поскольку мы установили в конструкторе HelpBrowser атрибут Qt::WA_DeleteOnClose. </p>
<p class="paragraph">
В этом примере мы предполагаем, что документация располагается в подкаталоге doc того каталога, где находится исполняемый модуль приложения. Все страницы, передаваемые функции showPage(), будут браться из этого подкаталога. </p>
<p class="paragraph">
Теперь мы можем вызывать браузер системы помощи из приложения. В главном окне приложения мы могли бы создать команду Help и подсоединить ее к слоту help(), который может иметь следующий вид: </p>
<p class="paragraph">
01 void MainWindow::help() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 HelpBrowser::showPage("index.html"); </p>
<p class="paragraph">
04 } </p>
<p class="paragraph">
Здесь предполагается, что главный файл системы помощи имеет имя index.html. Для диалоговых окон мы могли бы подсоединить кнопку Help к слоту help(), который может иметь следующий вид: </p>
<p class="paragraph">
01 void EntryDialog::help() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 HelpBrowser::showPage("forms.html#editing"); </p>
<p class="paragraph">
04 } </p>
<p class="paragraph">
Здесь мы выводим на экран другой справочный файл, forms.html, и позиционируем браузер QTextBrowser нa метку editing. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Использование </p>
<p class="chap">Qt Assistant</p>
<p class="chap"> для мощной интерактивной системы помощи</p>
<p class="paragraph">
Qt Assistant является свободно распространяемой интерактивной системой помощи, поддерживаемой фирмой «Trolltech». Основным ее достоинством является поддержка индексации и поиск по всему тексту, а также возможность ее работы с наборами документации нескольких приложений. </p>
<p class="paragraph">
Для применения Qt Assistant мы должны включить в наше приложение соответствующий программный код и указать Qt Assistant место расположения нашей документации. </p>
<p class="paragraph">
Связь между приложением Qt и QtAssistant обеспечивается классом QAssistantClient, который располагается в отдельной библиотеке. Для сборки этой библиотеки с нашим приложением мы должны добавить следующую строку к файлу приложения .pro: </p>
<p class="paragraph">
CONFIG += assistant </p>
<p class="paragraph">
Теперь мы рассмотрим программный код нового класса HelpBrowser, который использует Qt Assistant. </p>
<p class="paragraph">
01 #ifndef HELPBROWSER_H </p>
<p class="paragraph">
02 #define HELPBROWSER_H </p>
<p class="paragraph">
03 class QAssistantClient; </p>
<p class="paragraph">
04 class QString; </p>
<p class="paragraph">
05 class HelpBrowser </p>
<p class="paragraph">
06 { </p>
<p class="paragraph">
07 public: </p>
<p class="paragraph">
08 static void showPage(const QString &page); </p>
<p class="paragraph">
09 private: </p>
<p class="paragraph">
10 static QAssistantClient *assistant; </p>
<p class="paragraph">
11 }; </p>
<p class="paragraph">
12 #endif </p>
<p class="paragraph">
Ниже приводится новый файл helpbrowser.cpp: </p>
<p class="paragraph">
01 #include <QApplication> </p>
<p class="paragraph">
02 #include <QAssistantClient> </p>
<p class="paragraph">
03 #include "helpbrowser.h" </p>
<p class="paragraph">
04 QAssistantClient *HelpBrowser::assistant = 0; </p>
<p class="paragraph">
05 void HelpBrowser::showPage(const QString &page) </p>
<p class="paragraph">
06 { </p>
<p class="paragraph">
07 QString path = QApplication::applicationDirPath() + "/doc/" + page; </p>
<p class="paragraph">
08 if (!assistant) </p>
<p class="paragraph">
09 assistant = new QAssistantClient(""); </p>
<p class="paragraph">
10 assistant->showPage(path); </p>
<p class="paragraph">
11 } </p>
<p class="paragraph">
Конструктор QAssistantClient принимает в качестве своего первого аргумента строку пути, который используется для определения места нахождения исполняемого модуля Qt Assistant. Передавая пустой путь, мы указываем на необходимость QAssistantClient поиска исполняемого модуля в путях переменной среды PATH. QAssistantClient имеет функцию showPage(), которая принимает имя файла страницы HTML с необязательным указанием метки позиции. </p>
<p class="paragraph">
На следующем этапе необходимо подготовить оглавление и предметный указатель документации. Это выполняется путем создания профиля Qt Assistant и файла .dcf, который содержит сведения о документации. Все это объясняется в документации по Qt Assistant, и поэтому мы не станем здесь повторять эти сведения. </p>
<p class="paragraph">
В качестве альтернативы QTextBrowser или Qt Assistant можно спользовать зависящие от платформы методы обеспечения интерактивной помощи. Для приложений Windows можно создать файлы системы помощи Windows HTML Help и обеспечить доступ к ним при помощи Internet Explorer компании Microsoft. Вы могли бы использовать для этого класс Qt QProcess или рабочую среду ActiveQt. Для приложений X11 подходящий метод мог бы состоять в создании файлов HTML и запуске веб-браузера, с использованием QProcess. В Mac OS X подсистема Apple Help предоставляет аналогичные функциональные возможности для Qt Assistant. </p>
<p class="paragraph">
На этом мы завершаем часть II. В рассматриваются более продвинутые и специализированные средства разработки Qt. Их применение при программировании на С++ вызывает не больше трудностей, чем программирование того, что мы видели в части II, однако некоторые концепции и идеи могут вызвать дополнительные сложности в новых для вас областях. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
</div>
<div id="sec_7">
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Часть III. Advanced Qt</p>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Глава 17. Интернационализация</p>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<div>
<img src="data:image/jpg;base64,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" />
</div>
<p class="paragraph">
Кроме латинского алфавита, используемого для английского и многих европейских языков, Qt 4 обеспечивает широкую поддержку остальных мировых систем записи: </p>
<p class="paragraph">
• Qt применяет Unicode в программном интерфейсе и во внутренних операциях. В приложении можно обеспечить всем пользователям одинаковую поддержку независимо от того, какой язык применяется в пользовательском интерфейсе; </p>
<p class="paragraph">
• текстовый процессор Qt может работать со всеми основными нелатинскими системами записи, в том числе с арабской, китайской, кириллицей, ивритом, японской, корейской, тайской и с языками Индии; </p>
<p class="paragraph">
• процессор компоновки Qt обеспечивает компоновку справа налево для таких языков, как арабский и иврит; </p>
<p class="paragraph">
• для определенных языков требуются специальные методы ввода текста. Такие виджеты редактирования, как QLineEdit и QTextEdit, хорошо работают в условиях применения любого метода ввода текста, существующего в системе пользователя. </p>
<p class="paragraph">
Разрешение ввода текста пользователями на их родном языке часто оказывается недостаточным; необходимо также перевести весь пользовательский интерфейс. В Qt это делается просто: все видимые пользователем строки обработайте функцией tr() (как это мы делали в предыдущих главах) и воспользуйтесь утилитами Qt для подготовки файлов перевода на требуемый язык. Qt имеет утилиту с графическим пользовательским интерфейсом, которая называется Qt Linguist и предназначается для переводчиков. Qt Linguist дополняется двумя консольными программами lupdate и lrelease, которые обычно используются разработчиками приложений. </p>
<p class="paragraph">
В большинстве приложений файл перевода загружается при запуске приложения с учетом установленных пользователем параметров локализации. Однако в некоторых случаях пользователям необходимо переключаться с одного языка на другой во время выполнения приложения. Это, несомненно, можно делать в Qt, хотя и потребует немного дополнительной работы. А благодаря системе компоновки Qt различные компоненты интерфейса пользователя будут автоматически перенастраиваться, чтобы обеспечить достаточно места для переведенного текста, когда его размер превышает размер исходного текста. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Работа с </p>
<p class="chap">Unicode</p>
<p class="paragraph">
Unicode является стандартной кодировкой, которая поддерживает большинство мировых систем записи. В основе кодировки Unicode лежит идея использования для хранения символов 16 бит, а не 8, и поэтому она позволяет закодировать примерно 65 000 символов вместо только 256. Unicode содержит коды ASCII и ISO 8859-1 (Latin-1) в качестве своего подмножества с прежним их представлением. Например, английская буква «А» имеет значение 0x41 в кодировках ASCII, Latin-1 и Unicode, а буква «В» имеет значение 0xD1 в кодировках Latin-1 и Unicode. Класс Qt QString хранит строковые значения в кодировке Unicode. Каждый символ QString имеет 16-битовый тип QChar, а не 8-битовый тип char. Ниже приводятся два способа установки первого символа строки на значение «А»: </p>
<p class="paragraph">
str[0] = 'A'; </p>
<p class="paragraph">
str[0] = QChar(0x41); </p>
<p class="paragraph">
Если исходный файл имеет кодировку Latin-1, задавать символы Latin-1 очень легко: </p>
<p class="paragraph">
str[0] = 'C'; </p>
<p class="paragraph">
Но если исходный файл имеет другую кодировку, хорошо срабатывает вариант с числовым кодом: </p>
<p class="paragraph">
str[0] = QChar(0xD1); </p>
<p class="paragraph">
Мы можем задать любой символ Unicode с помощью его числового кода. Например, ниже показано, как задается прописная буква «сигма» греческого алфавита («Σ») и символ валюты евро («€»): </p>
<p class="paragraph">
str[0] = QChar(0x3A3); </p>
<p class="paragraph">
str[0] = QChar(0x20AC); </p>
<p class="paragraph">
Все числовые коды, поддерживаемые кодировкой Unicode, можно найти в сети Интернет по адресу . Если вам приходится редко использовать символы Unicode, не относящиеся к Latin-1, для поиска их кодов вполне достаточно воспользоваться указанным адресом; но Qt обеспечивает более удобный способ ввода в программе Qt строк символов в кодировке Unicode, как мы увидим позднее в данном разделе. </p>
<p class="paragraph">
Текстовый процессор в Qt 4 поддерживает на всех платформах следующие системы записи: арабскую, китайскую, кириллическую, греческую, иврит, японскую, корейскую, лаосскую, латинскую, тайскую и вьетнамскую. Он также поддерживает все скрипты 4.1 в кодировке Unicode, которые не требуют специальной обработки. Кроме того, в системе X11 с Fontconfig и в последних версиях системы Windows поддерживаются следующие языки: бенгальский, деванагари, гуйарати, гурмухи, каннада, кхмерский, малайский, сирийский, тамильский, телугу, тхаана (дивехи) и тибетский. Наконец, ория поддерживается в системе X11, а монгольский и синхала поддерживаются в Windows XP. Если в системе установлен соответствующий шрифт, Qt сможет воспроизвести текст на любом из этих языков. А при установке соответствующих программ ввода текста пользователи смогут вводить в своих приложениях Qt текст на этих языках. </p>
<p class="paragraph">
Программирование с использованием QChar немного отличается от программирования с применением char. Для получения числового кода символа QChar вызовите для него функцию unicode(). Для получения кода ASCII переменной типа QChar (в виде char) вызовите функцию toLatin1(). Для символов, отсутствующих в кодировке Latin-1, функция toLatin1() возвращает '\0'. </p>
<p class="paragraph">
Если нам заранее известно, что все строковые данные в программе представлены в кодировке ASCII или Latin-1, мы можем использовать такие стандартные функции (определенные в файле <cctype>), как isalpha(), isdigit() и isspace(), для обработки возвращаемого функцией toLatin1() значения. Однако в общем случае лучше использовать функции—члены класса QChar для выполнения этих операций, поскольку они будут правильно работать для любых символов Unicode. К таким функциям класса QChar относятся isPrint(), isPunct(), isSpace(), isMark(), isLetter(), isNumber(), isLetterOrNumber(), isDigit(), isSymbol(), isLower() и isUpper(). Например, ниже показано, как осуществлять проверку символа на цифру или прописную букву: </p>
<p class="paragraph">
if (ch.isDigit() || ch.isUpper()) </p>
<p class="paragraph">
… </p>
<p class="paragraph">
Этот фрагмент кода правильно работает для любых алфавитов, в которых различаются символы верхнего и нижнего регистров, в том числе для латинского, греческого и кириллицы. </p>
<p class="paragraph">
Строку в кодировке Unicode мы можем использовать в любом месте программного интерфейса Qt, где допускается применение строки типа QString. Qt сам отвечает за правильное ее отображение и преобразование в соответствущие кодировки при взаимодействии с операционной системой. </p>
<p class="paragraph">
Особенно внимательными надо быть при чтении и записи текстовых файлов. Текстовые файлы могут использовать различные кодировки, и часто оказывается невозможным определить кодировку текстового файла по его содержанию. По умолчанию QTextStream использует локальную системную 8-битовую кодировку (которая доступна при помощи функции QTextCodec::codecForLocale()), как для чтения, так и для записи. Для стран Америки и Западной Европы это обычно подразумевает кодировку Latin-1. </p>
<p class="paragraph">
Если мы разработали свой собственный формат файлов и собираемся считывать и записывать произвольные символы Unicode, мы можем сохранять данные в кодировке Unicode с помощью вызова </p>
<p class="paragraph">
stream.setCodec("UTF-16"); </p>
<p class="paragraph">
stream.setGenerateByteOrderMark(true); </p>
<p class="paragraph">
до начала записи в поток QTextStream. Данные в этом случае будут сохраняться в формате UTF-16, который использует два байта для представления одного символа и который будет иметь префикс из специального 16-битового значения (признак порядка байтов Unicode, 0xFFFE), указывающего на применение файлом кодировки Unicode и на прямой или обратный порядок байтов. Формат UTF-16 идентичен представлению в памяти строк QString, и поэтому чтение и запись представленных в кодировке Unicode строк в формате UTF-16 могут выполняться очень быстро. Однако такой подход связан с перерасходом памяти при сохранении данных, представленных целиком в кодировке ASCII, в формате UTF-16, поскольку в данном случае каждый символ займет два байта вместо одного. </p>
<p class="paragraph">
Другие кодировки можно задавать путем вызова функции setCodec() с указанием соответствующего объекта преобразования QTextCodec. QTextCodec осуществляет преобразование между Unicode и заданной кодировкой. Объекты QTextCodec используются в различных контекстах в Qt. Внутренними средствами они применяются для поддержки шрифтов, методов ввода, буфера обмена, технологии «drag-and-drop» и названий файлов. Но мы можем их использовать и непосредственно при написании приложений Qt. </p>
<p class="paragraph">
При чтении текстового файла QTextStream автоматически обнаруживает кодировку Unicode, если файл начинается с признака, определяющего порядок байтов. Такой режим работы можно отключить с помощью вызова setAutoDetectUnicode(false). Если нельзя рассчитывать на то, что данные начинаются с признака, определяющего порядок байтов, лучше всего перед чтением вызвать функцию setCodec() с аргументом «UTF-16». </p>
<p class="paragraph">
Другой кодировкой, поддерживающей весь Unicode, является UTF-8. Его главное достоинство по сравнению с UTF-16, состоит в том, что он — супермножество по отношению к ASCII. Любой символ с кодом в диапазоне от 0x00 до 0x7F представляется в виде одного байта. Другие символы, включая символы Latin-1, код которых превышает значение 0x7F, представляются в виде последовательности из нескольких байтов. Текст, состоящий в основном из символов ASCII, в формате UTF-8 займет примерно вполовину меньше памяти, чем в формате UTF-16. Для применения UTF-8 с QTextStream перед чтением и записью сделайте вызов setEncoding(QTextStream::UnicodeUTF8). </p>
<p class="paragraph">
Если мы всегда собираемся считывать и записывать файлы в кодировке Latin-1, вне зависимости от применяемой пользователем локальной кодировки, мы можем установить кодировку «ISO 8859-1» для потока QTextStream. Например: </p>
<p class="paragraph">
QTextStream in(&file); </p>
<p class="paragraph">
in.setCodec("ISO 8859-1"); </p>
<p class="paragraph">
При применении некоторых форматов файлов их кодировка задается в заголовке файла. Заголовок обычно представляется в простом виде в кодировке ASCII, чтобы обеспечить его правильное чтение вне зависимости от используемой кодировки (в предположении, что она является супермножеством по отношению к ASCII). Интересным примером таких форматов являются файлы XML. Обычно файлы XML представлены в кодировке UTF-8 или UTF-16. Для правильного их чтения необходимо вызвать функцию setCodec() с «UTF-8». Если используется формат UTF-16, QTextStream автоматически обнаружит это и настроится на него. Заголовок <?xml?> файла XML иногда содержит аргумент encoding, например: </p>
<p class="paragraph">
<?xml version="1.0" encoding="EUC-KR"?> </p>
<p class="paragraph">
Поскольку QTextStream не позволяет менять кодировку после начала чтения, чтобы учесть явно заданную кодировку, придется заново прочитать файл, задавая правильное преобразование (полученное функцией QTextCodec::codecForName()). В случае файла XML мы можем сами не делать преобразование кодировок, воспользовавшись классами Qt, предназначенными для XML и описанными в . </p>
<p class="paragraph">
Другое применение объектов QTextCodec заключается в указании кодировки строк в исходном коде. Давайте рассмотрим пример, когда группа японских программистов создает приложение, предназначенное главным образом для применения на японском рынке. Эти программисты, вероятно, будут писать свой исходный программный код в текстовом редакторе, использующем такие кодировки, как EUC-JP или Shift-JIS. Такой редактор позволяет им вводить японские иероглифы непосредственно, и, например, они смогут написать следующий код: </p>
<p class="paragraph">
QPushButton *button = new QPushButton(tr("♦♦")); </p>
<p class="paragraph">
По умолчанию Qt считает, что аргументы функции tr() задаются в кодировке Latin-1. Для изменения этого необходимо вызвать статическую функцию QTextCodec::setCodecForTr(). Например: </p>
<p class="paragraph">
QTextCodec *japaneseCodec = QTextCodec::codecForName("EUC-JP"); </p>
<p class="paragraph">
QTextCodec::setCodecForTr(japaneseCodec); </p>
<p class="paragraph">
Это должно быть сделано до первого вызова tr(). Обычно мы делаем это в функции main() непосредственно после создания объекта QApplication. </p>
<p class="paragraph">
Другие используемые в программе строки будут по-прежнему интерпретироваться как строки, представленные в кодировке Latin-1. Если программисты хотят вводить японские иероглифы и здесь, они могут явно преобразовывать их в Unicode, используя объект QTextCodec: </p>
<p class="paragraph">
QString text = japaneseCodec->toUnicode("♦♦♦♦♦"); </p>
<p class="paragraph">
Можно поступить по-другому и указать Qt на необходимость применения особого преобразования между типами const char * и QString путем вызова функции QTextCodec::setCodecForCStrings(): </p>
<p class="paragraph">
QTextCodec::setCodecForCStrings(QTextCodec::codecForName("EUC-JP")); </p>
<p class="paragraph">
Описанные выше методы можно применять к любому языку, алфавит которого выходит за рамки кодировки Latin-1, включая языки китайский, греческий, корейский и русский. </p>
<p class="paragraph">
Ниже приводится список кодировок, поддерживаемых Qt 4: </p>
<p class="paragraph">
• Apple Roman </p>
<p class="paragraph">
• Big5 </p>
<p class="paragraph">
• Big5-HKSCS </p>
<p class="paragraph">
• EUC-JP </p>
<p class="paragraph">
• EUC-KR </p>
<p class="paragraph">
• GB18030-0 </p>
<p class="paragraph">
• IBM 850 </p>
<p class="paragraph">
• IBM 866 </p>
<p class="paragraph">
• IBM 874 </p>
<p class="paragraph">
• ISO 2022-JP </p>
<p class="paragraph">
• ISO 8859-1 </p>
<p class="paragraph">
• ISO 8859-2 </p>
<p class="paragraph">
• ISO 8859-3 </p>
<p class="paragraph">
• ISO 8859-4 </p>
<p class="paragraph">
• ISO 8859-5 </p>
<p class="paragraph">
• ISO 8859-6 </p>
<p class="paragraph">
• ISO 8859-7 </p>
<p class="paragraph">
• ISO 8859-8 </p>
<p class="paragraph">
• ISO 8859-9 </p>
<p class="paragraph">
• ISO 8859-10 </p>
<p class="paragraph">
• ISO 8859-13 </p>
<p class="paragraph">
• ISO 8859-14 </p>
<p class="paragraph">
• ISO 8859-15 </p>
<p class="paragraph">
• ISO 8859-16 </p>
<p class="paragraph">
• Iscii-Bng </p>
<p class="paragraph">
• Iscii-Dev </p>
<p class="paragraph">
• Iscii-Gjr </p>
<p class="paragraph">
• Iscii-Knd </p>
<p class="paragraph">
• Iscii-Mlm </p>
<p class="paragraph">
• Iscii-Ori </p>
<p class="paragraph">
• Iscii-Pnj </p>
<p class="paragraph">
• Iscii-Tlg </p>
<p class="paragraph">
• Iscii-Tml </p>
<p class="paragraph">
• JIS X 0201 </p>
<p class="paragraph">
• JIS X 0208 </p>
<p class="paragraph">
• KOI8-R </p>
<p class="paragraph">
• KOI8-U </p>
<p class="paragraph">
• MuleLao-1 </p>
<p class="paragraph">
• ROMAN8 </p>
<p class="paragraph">
• Shift-JIS </p>
<p class="paragraph">
• TIS-620 </p>
<p class="paragraph">
• TSCII </p>
<p class="paragraph">
• UTF-8 </p>
<p class="paragraph">
• UTF-16 </p>
<p class="paragraph">
• UTF-16BE </p>
<p class="paragraph">
• UTF-16LE </p>
<p class="paragraph">
• Windows-1250 </p>
<p class="paragraph">
• Windows-1251 </p>
<p class="paragraph">
• Windows-1252 </p>
<p class="paragraph">
• Windows-1253 </p>
<p class="paragraph">
• Windows-1254 </p>
<p class="paragraph">
• Windows-1255 </p>
<p class="paragraph">
• Windows-1256 </p>
<p class="paragraph">
• Windows-1257 </p>
<p class="paragraph">
• Windows-1258 </p>
<p class="paragraph">
• WINSAMI2 </p>
<p class="paragraph">
Для всех этих кодировок функция QTextCodec::codecForName() всегда будет возвращать достоверный указатель. Другие кодировки можно обеспечить путем создания подкласса QTextCodec. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Создание переводимого интерфейса приложения</p>
<p class="paragraph">
Если мы хотим иметь многоязыковую версию нашего приложения, мы должны сделать две вещи: </p>
<p class="paragraph">
• убедиться, что все строки, которые видит пользователь, проходят через функцию tr(); </p>
<p class="paragraph">
• загрузить файл перевода (.qm) при запуске приложения. </p>
<p class="paragraph">
Ничего подобного не надо делать, если приложения никогда не будут переводиться на другой язык. Однако применение функции tr() почти не требует дополнительных усилий и оставляет дверь открытой для их перевода когда-нибудь в будущем. </p>
<p class="paragraph">
Функция tr() является статической функцией, определенной в классе QObject и переопределяемой в каждом подклассе, в котором встречается макрос Q_OBJECT. При ее использовании в рамках подкласса QObject мы можем вызывать tr() без ограничений. Вызов tr() возвращает перевод строки, если он имеется, и первоначальный текст в противном случае. </p>
<p class="paragraph">
Для подготовки файлов переводов мы должны запустить утилиту Qt lupdate. Эта утилита собирает все строковые константы, которые встречаются в вызовах tr(), и формирует файлы переводов, содержащие все эти подготовленные к переводу строки. Эти файлы могут затем быть переданы переводчику для добавления к ним перевода строк. Эта процедура рассматривается позже в данной главе в разделе «Перевод приложений». </p>
<p class="paragraph">
В общем виде вызов tr() имеет следующий синтаксис: </p>
<p class="paragraph">
Контекст::tr(исходныйТекст, комментарий) </p>
<p class="paragraph">
Здесь Контекст — имя подкласса QObject, в котором используется макрос Q_OBJECT. Нам не требуется его указывать, если мы вызываем tr() в функции—члене рассматриваемого класса. Аргумент исходныйТекст — текстовая константа, которую нужно будет переводить. Аргумент комментарий является необязательным, и он может использоваться для предоставления переводчику дополнительной информации. </p>
<p class="paragraph">
Ниже приводится несколько примеров: </p>
<p class="paragraph">
01 RockyWidget::RockyWidget(QWidget *parent) </p>
<p class="paragraph">
02 : QWidget(parent) </p>
<p class="paragraph">
03 { </p>
<p class="paragraph">
04 QString str1 = tr("Letter"); </p>
<p class="paragraph">
05 QString str2 = RockyWidget::tr("Letter"); </p>
<p class="paragraph">
06 QString str3 = SnazzyDialog::tr("Letter"); </p>
<p class="paragraph">
07 QString str4 = SnazzyDialog::tr("Letter", "US paper size"); </p>
<p class="paragraph">
08 } </p>
<p class="paragraph">
Первые два вызова tr() выполняются в контексте объекта RockyWidget (скалистый виджет), а вторые два — в контексте объекта SnazzyDialog (притягательное диалоговое окно). В качестве исходного текста во всех четырех случаях используется слово «Letter» (буква). Последний вызов имеет также комментарий, помогающий переводчику точнее понять смысл исходного текста. </p>
<p class="paragraph">
Строки в различных контекстах (классах) переводятся независимо друг от друга. Переводчики, как правило, одновременно работают только с одним контекстом, причем часто при этом работает приложение и на экране отображается виджет или диалоговое окно, которые необходимо перевести. </p>
<p class="paragraph">
Когда мы вызываем tr() из глобальной функции, мы должны явно указать контекст. Любой подкласс QObject может использоваться в приложении в качестве контекста. Если такого подкласса нет, мы всегда можем использовать сам класс QObject. Например: </p>
<p class="paragraph">
01 int main(int argc, char *argv[]) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 QApplication app(argc, argv); </p>
<p class="paragraph">
04 QPushButton button(QObject::tr("Hello Qt!")); </p>
<p class="paragraph">
05 button.show(); </p>
<p class="paragraph">
06 return app.exec(); </p>
<p class="paragraph">
07 } </p>
<p class="paragraph">
До сих пор во всех примерах контекст задавался именем класса. Это удобно, поскольку мы почти всегда можем опустить его, но на самом деле это не так. Наиболее общий способ перевода строки в Qt заключается в использовании функции QApplication::translate(), которая принимает три аргумента: контекст, исходный текст и необязательный комментарий. Например, ниже приводится другой способ перевода «Hello Qt!»: </p>
<p class="paragraph">
QApplication::translate("Global Stuff", "Hello Qt!"); </p>
<p class="paragraph">
На этот раз мы поместили текст в контекст «Global Stuff» (глобальное вещество — ну нихрена себе перевод :) ). </p>
<p class="paragraph">
Функции tr() и translate() играют двоякую роль: они являются маркерами, которые утилита lupdate использует для поиска видимых пользователем строк, и одновременно они являются функциями С++, которые переводят текст. Это отражается на том, как следует записывать программный код. Например, следующий программный код не сработает: </p>
<p class="paragraph">
// НЕПРАВИЛЬНО </p>
<p class="paragraph">
const char *appName = "OpenDrawer 2D"; </p>
<p class="paragraph">
QString translated = tr(appName); </p>
<p class="paragraph">
Проблема состоит в том, что утилита lupdate не сможет извлечь строковую константу «OpenDrawer 2D», поскольку она не входит в вызов функции tr(). Это означает, что переводчик не будет иметь возможность перевести эту строку. Эта проблема часто возникает и при построении динамических строк: </p>
<p class="paragraph">
// НЕПРАВИЛЬНО </p>
<p class="paragraph">
statusBar()->showMessage(tr("Host " + hostName + " found")); </p>
<p class="paragraph">
Здесь значение строки, которую мы передаем функции tr(), меняется в зависимости от значения hostName, и поэтому мы не можем ожидать, что перевод функцией tr() будет выполнен правильно. </p>
<p class="paragraph">
Решение заключается в применении функции QString::arg(): </p>
<p class="paragraph">
statusBar()->showMessage(tr("Host %1 found").arg(hostName)); </p>
<p class="paragraph">
Обратите внимание на то, как это работает: строковый литерал «Host %1 found» (хост %1 найден) передается функции tr(). Если загружен файл перевода на французский язык, tr() возвратит что-то подобное «Нфtе %1 trouvй». Параметр «%1» замещается на содержимое переменной hostName. </p>
<p class="paragraph">
Хотя в целом не рекомендуется вызывать tr() для переменной, это может сработать. Мы должны использовать макрос QT_TR_NOOP() для пометки тех строковых литералов, перевод которых должен быть выполнен до их присваивания переменной. Это лучше всего делать для статических массивов строк. Например: </p>
<p class="paragraph">
01 void OrderForm::init() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 static const char * const flowers[] = { </p>
<p class="paragraph">
04 QT_TR_NOOP("Medium Stem Pink Roses"), </p>
<p class="paragraph">
05 QT_TR_NOOP("One Dozen Boxed Roses"), </p>
<p class="paragraph">
06 QT_TR_NOOP("Calypso Orchid"), </p>
<p class="paragraph">
07 QT_TR_NOOP("Dried Red Rose Bouquet"), </p>
<p class="paragraph">
08 QT_TR_NOOP("Mixed Peonies Bouquet"), </p>
<p class="paragraph">
09 0 </p>
<p class="paragraph">
10 }; </p>
<p class="paragraph">
11 for (int i = 0; flowers[i]; ++i) </p>
<p class="paragraph">
12 comboBox->addItem(tr(flowers[i])); </p>
<p class="paragraph">
13 } </p>
<p class="paragraph">
Макрос QT_TR_NOOP() просто возвращает свой аргумент. Но утилита lupdate обнаружит все строки, заданные в виде аргумента макроса QT_TR_NOOP(), и поэтому они смогут быть переведены. При использовании позже этой переменной мы вызываем, как обычно, tr() для выполнения перевода. Несмотря на передачу функции tr() переменной, перевод все-таки будет выполнен. </p>
<p class="paragraph">
Существует также макрос QT_TRANSLATE_NOOP(), который работает подобно макросу QT_TR_NOOP(), но для него, кроме того, задается контекст. Этот макрос удобно использовать для инициализации переменных вне класса: </p>
<p class="paragraph">
static const char * const flowers[] = { </p>
<p class="paragraph">
QT_TRANSLATE_NOOP("OrderForm", "Medium Stem Pink Roses"), </p>
<p class="paragraph">
QT_TRANSLATE_NOOP("OrderForm", "One Dozen Boxed Roses"), </p>
<p class="paragraph">
QT_TRANSLATE_NOOP("OrderForm", "Calypso Orchid"), </p>
<p class="paragraph">
QT_TRANSLATE_NOOP("OrderForm", "Dried Red Rose Bouquet"), </p>
<p class="paragraph">
QT_TRANSLATE_NOOP("OrderForm", "Mixed Peonies Bouquet"), </p>
<p class="paragraph">
0 </p>
<p class="paragraph">
}; </p>
<p class="paragraph">
Здесь аргумент контекста должен совпадать с контекстом при будущем вызове функции tr() или translate(). </p>
<p class="paragraph">
Когда мы начинаем использовать в приложении функцию tr(), легко можно забыть в каких-то случаях о необходимости задавать видимые пользователем строки через вызов функции tr() (особенно если это делается впервые). Эти пропущенные строки фактически могут быть обнаружены переводчиком или, еще хуже, пользователями переведенного приложения, когда некоторые строки будут отображаться с применением первоначального языка. Чтобы не допустить этого, мы можем указать Qt на необходимость запрета неявных преобразований с типа const char * на тип QString. Это делается путем определения препроцессорного символа QT_NO_CAST_FROM_ASCII перед включением любого заголовочного файла Qt. Наиболее простой способ обеспечения установки этого символа состоит в добавлении следующей строки в файл .pro: </p>
<p class="paragraph">
DEFINES += QT_NO_CAST_FROM_ASCII </p>
<p class="paragraph">
Это заставит нас каждый строковый литерал использовать через вызов tr() или QLatin1String() в зависимости от того, надо ли его переводить или нет. Строки, которые не будут заданы именно таким образом, приведут к выводу сообщения об ошибке компилятора и заставят нас восполнить пропущенные вызовы функций tr() или QLatin1String(). </p>
<p class="paragraph">
После заключения всех видимых пользователем строк в вызовы функций tr() для обеспечения перевода нам остается только загрузить файл перевода. Обычно мы это делаем в функции приложения main(). Например, ниже показано, как можно попытаться загрузить файл перевода, который зависит от пользовательской локализации приложения: </p>
<p class="paragraph">
01 int main(int argc, char *argv[]) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 QApplication app(argc, argv); </p>
<p class="paragraph">
04 QTranslator appTranslator; </p>
<p class="paragraph">
05 appTranslator.load("myapp_" + QLocale::system().name(), </p>
<p class="paragraph">
06 qApp->applicationDirPath()); </p>
<p class="paragraph">
07 app.installTranslator(&appTranslator); </p>
<p class="paragraph">
08 … </p>
<p class="paragraph">
09 return app.exec(); </p>
<p class="paragraph">
10 } </p>
<p class="paragraph">
Функция QLocale::system() возвращает объект QLocale, который содержит информацию о пользовательской локализации. Обычно имя локализации является частью имени файла .qm. Локализации можно задавать более или менее точно; например, fr задает европейский французский язык, fr_CA задает канадский французский язык, a fr_CA.ISO8859-15 задает канадский французский язык с использованием кодировки ISO 8859-15 (которая поддерживает символы «^», «КЬ», «№» и «Ы» — в исходном бумажном издании французский куда-то подевался %) ). </p>
<p class="paragraph">
Если локализацией является fr_CA.ISO8859-15, функция QTranslator::load() сначала попытается загрузить файл myapp_fr_CA.ISO8859-15.qm. Если этого файла нет, функция load() на следующем шаге попытается загрузить файл myapp_fr_CA.qm, затем myapp_fr.qm и, наконец, myapp.qm, и это будет последней попыткой. В обычных случаях нам необходимо предоставить только файл myapp_fr.qm, содержащий перевод на стандартный французский язык, но если нам нужен другой файл перевода для говорящих на французском в Канаде, мы можем также обеспечить файл myapp_fr_CA.qm, и он будет использован для локализации fr_CA. </p>
<p class="paragraph">
Второй аргумент функции QTranslator::load() является каталогом, где функция load() будет искать файл перевода. В данном случае мы предполагаем, что файлы переводов размещаются в том же каталоге, где находится исполняемый модуль. </p>
<p class="paragraph">
В самих библиотеках Qt содержится несколько строк, которые необходимо перевести. Компания «Trolltech» располагает переводы на французский, немецкий и упрощенный китайский языки в каталоге Qt translations. Имеются переводы также на другие языки, но они выполнены пользователями Qt и официально не поддерживаются. Необходимо также загрузить файл перевода библиотек Qt: </p>
<p class="paragraph">
QTranslator qtTranslator; </p>
<p class="paragraph">
qtTranslator.load("qt_" + QLocale::system().name(), </p>
<p class="paragraph">
qApp->applicationDirPath()); </p>
<p class="paragraph">
app.installTranslator(&qtTranslator); </p>
<p class="paragraph">
Объект QTranslator может работать одновременно только с одним файлом перевода, и поэтому мы используем отдельный QTranslator для перевода приложения Qt. Возможность применения только одного файла для перевода не составляет проблемы, поскольку мы можем установить любое необходимое нам их количество. QApplication будет рассматривать все такие файлы при поиске перевода. </p>
<p class="paragraph">
Некоторые языки, такие как арабский и иврит, используют запись справа налево, а не слева направо. Для таких языков общая компоновка приложения должна быть изменена на зеркальную, что делается при помощи вызова функции QApplication::setLayoutDirection(Qt::RightToLeft). Файлы перевода Qt содержат специальный маркер типа «LTR», указывающий Qt на направление записи используемого языка — слева направо или справа налево, и поэтому нам обычно не приходится самим вызывать функцию setLayoutDirection(). </p>
<p class="paragraph">
Для наших пользователей может быть более удобно, если файлы перевода будут встраиваться в исполняемый модуль приложения, используя ресурсную систему Qt. Это не только снижает количество файлов в дистрибутиве приложения, но при этом снижается риск случайной потери или удаления файлов переводов. </p>
<p class="paragraph">
Предположим, что файлы .qm располагаются в подкаталоге translations исходного дерева, тогда файл myapp.qrc будет содержать следующие строки: </p>
<p class="paragraph">
<!DOCTYPE RCC><RCC version="1.0"> </p>
<p class="paragraph">
<qresource> </p>
<p class="paragraph">
<file>translations/myapp_de.qm</file> </p>
<p class="paragraph">
<file>translations/myapp_fr.qm</file> </p>
<p class="paragraph">
<file>translations/myapp_zh.qm</file> </p>
<p class="paragraph">
<file>translations/qt_de.qm</file> </p>
<p class="paragraph">
<file>translations/qt_fr.qm</file> </p>
<p class="paragraph">
<file>translations/qt_zh.qm</file> </p>
<p class="paragraph">
</qresource> </p>
<p class="paragraph">
</RCC> </p>
<p class="paragraph">
Файл .pro будет иметь следующий элемент: </p>
<p class="paragraph">
RESOURCES = myapp.qrc </p>
<p class="paragraph">
Наконец, в функции main() мы должны указать :/translations в качестве пути к файлам переводов. Начальное двоеточие говорит о том, что это путь к ресурсу, а не к файлу, размещенному в файловой системе. </p>
<p class="paragraph">
Теперь нами рассмотрено все, что необходимо для обеспечения перевода приложения на другие языки. Но язык и направление записи не единственное, что отличает различные страны и культуры. Интернационализация программы должна также учитывать местные форматы дат и времени, денежных единиц, чисел и упорядоченность букв. Qt содержит класс QLocale, обеспечивающий локализованные форматы чисел и даты/времени. Для получения другой информации, характерной для данной местности, мы можем использовать стандартные функции С++ setlocale() и localeconv(). </p>
<p class="paragraph">
Поведение некоторых классов и функций Qt зависит от локализации: </p>
<p class="paragraph">
• сравнение, которое осуществляет функция QString::localeAwareCompare(), зависит от локализации. Этой функцией удобно пользоваться для упорядочивания элементов, которые видит пользователь; </p>
<p class="paragraph">
• функция toString() для объектов QDate, QTime и QDateTime возвращает строку в локализованном формате, если вызывается с аргументом Qt::LocalDate; </p>
<p class="paragraph">
• по умолчанию виджеты QDateEdit и QDateTimeEdit представляют даты в локализованном формате. </p>
<p class="paragraph">
Наконец, в переведенном приложении может потребоваться применение пиктограмм, отличных от используемых в оригинальной версии приложения. Например, стрелки влево и вправо на кнопках Back и Forward (назад и вперед) веб-браузера необходимо поменять местами для языка с записью справа налево. Мы можем это сделать следующим образом: </p>
<p class="paragraph">
if (QApplication::isRightToLeft()) </p>
<p class="paragraph">
{ </p>
<p class="paragraph">
backAction->setIcon(forwardIcon); </p>
<p class="paragraph">
forwardAction->setIcon(backIcon); </p>
<p class="paragraph">
} else { </p>
<p class="paragraph">
backAction->setIcon(backIcon); </p>
<p class="paragraph">
forwardAction->setIcon(forwardIcon); </p>
<p class="paragraph">
} </p>
<p class="paragraph">
Обычно приходится переводить пиктограммы, содержащие буквы алфавита. Например, буква «I» на кнопке панели инструментов, отображающая опцию Italic (курсив) текстового процессора, должна быть заменена буквой «С» для испанского языка (Cursivo) и буквой «К» для языков датского, голландского, немецкого, норвежского и шведского (Kursiv). Ниже показано, как это можно просто сделать: </p>
<p class="paragraph">
if (tr("Italic")[0] == 'C') { </p>
<p class="paragraph">
italicAction->setIcon(iconC); </p>
<p class="paragraph">
} else if (tr("Italic")[0] == 'K') { </p>
<p class="paragraph">
italicAction->setIcon(iconK); </p>
<p class="paragraph">
} else { </p>
<p class="paragraph">
italicAction->setIcon(iconI); </p>
<p class="paragraph">
} </p>
<p class="paragraph">
Можно поступить по-другому и использовать средства ресурсной системы, обеспечивающие поддержку нескольких локализаций. В файле .qrc мы можем определять локализацию для ресурса, используя атрибут lang. Например: </p>
<p class="paragraph">
<qresource> </p>
<p class="paragraph">
<file>italic.png</file> </p>
<p class="paragraph">
</qresource> </p>
<p class="paragraph">
<qresource lang="es"> </p>
<p class="paragraph">
<file alias="italic.png">cursivo.png</file> </p>
<p class="paragraph">
</qresource> </p>
<p class="paragraph">
<qresource lang="sv"> </p>
<p class="paragraph">
<file alias="italic.png'">kursiv.png</file> </p>
<p class="paragraph">
</qresource> </p>
<p class="paragraph">
Если пользовательской локализацией является es (Espanol), :/italic.png становится ссылкой на изображение cursivo.png. Если пользовательской локализацией является sv (Svenska), используется изображение kursiv.png. Для других локализаций используется italic.png. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Динамическое переключение языков</p>
<p class="paragraph">
Для большинства приложений вполне удовлетворительный результат обеспечивают определение предпочитаемого пользователем языка в функции main() и загрузка там соответствующих файлов .qm. Но в некоторых ситуациях пользователям необходимо иметь возможность динамического переключения языка. Если приложение постоянно используется попеременно различными пользователями, может возникнуть необходимость в изменении языка без перезапуска приложения. Например, это часто требуется для приложений, применяемых операторами центров заказов, синхронными переводчиками и операторами компьютеризованных кассовых аппаратов. </p>
<p class="paragraph">
Обеспечение в приложении возможности динамического переключения языков требует немного большего, чем просто загрузка одного файла перевода при запуске приложения, но это нетрудно сделать. </p>
<p class="paragraph">
Порядок действий должен быть следующим: </p>
<p class="paragraph">
• предусмотрите средство, с помощью которого пользователь сможет переключаться с одного языка на другой; </p>
<p class="paragraph">
• для каждого виджета или диалогового окна укажите все требующие перевода строки в отдельной функции (эта функция часто называется retranslateUi()), и вызывайте эту функцию всякий раз при изменении языка. </p>
<p class="paragraph">
Давайте рассмотрим соответствующую часть исходного кода приложения «call center» (центр заказов). Приложение содержит меню Language (язык), чтобы пользователь имел возможность задавать язык во время работы приложения. По умолчанию применяется английский язык. </p>
<div>
<img src="data:image/jpg;base64,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" />
</div>
<p class="paragraph">
Рис. 17.1. Динамическое меню Language. </p>
<p class="paragraph">
Поскольку мы не знаем, какой язык захочет использовать пользователь после запуска приложения, мы теперь не будем загружать файлы перевода в функции main(). Вместо этого мы будем их загружать динамически по мере необходимости, и поэтому обеспечивающий перевод программный код должен располагаться в классах главного и диалоговых окон. </p>
<p class="paragraph">
Давайте рассмотрим подкласс QMainWindow этого приложения: </p>
<p class="paragraph">
01 MainWindow::MainWindow() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 journalView = new JournalView; </p>
<p class="paragraph">
04 setCentralWidget(journalView); </p>
<p class="paragraph">
05 qApp->installTranslator(&appTranslator); </p>
<p class="paragraph">
06 qApp->installTranslator(&qtTranslator); </p>
<p class="paragraph">
07 qmPath = qApp->applicationDirPath() + "/translations"; </p>
<p class="paragraph">
08 createActions(); </p>
<p class="paragraph">
09 createMenus(); </p>
<p class="paragraph">
10 retranslateUi(); </p>
<p class="paragraph">
11 } </p>
<p class="paragraph">
В конструкторе мы устанавливает центральный виджет JournalView как подкласс QTableWidget. Затем мы настраиваем несколько закрытых переменных—членов, имеющих отношение к переводу: </p>
<p class="paragraph">
• переменная appTranslator является объектом QTranslator, который используется для хранения текущего перевода приложения; </p>
<p class="paragraph">
• переменная qtTranslator является объектом QTranslator, который используется для хранения перевода библиотеки Qt; </p>
<p class="paragraph">
• переменная qmPath имеет тип QString и задает путь к каталогу, который содержит файлы перевода приложения. </p>
<p class="paragraph">
В конце мы вызываем закрытые функции createActions() и createMenus() для создания системы меню и также закрытую функцию retranslateUi() для первой установки значений видимых пользователем строк. </p>
<p class="paragraph">
01 void MainWindow::createActions() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 newAction = new QAction(this); </p>
<p class="paragraph">
04 connect(newAction, SIGNAL(triggered()), this, SLOT(newFile())); </p>
<p class="paragraph">
05 … </p>
<p class="paragraph">
06 aboutQtAction = new QAction(this); </p>
<p class="paragraph">
07 connect(aboutQtAction, SIGNAL(triggered()), qApp, SLOT(aboutQt())); </p>
<p class="paragraph">
08 } </p>
<p class="paragraph">
Функция createActions() создает объекты QAction как обычно, но без установки текстов пунктов меню и клавиш быстрого вызова команд. Это будет сделано в функции retranslateUi(). </p>
<p class="paragraph">
01 void MainWindow::createMenus() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 fileMenu = new QMenu(this); </p>
<p class="paragraph">
04 fileMenu->addAction(newAction); </p>
<p class="paragraph">
05 fileMenu->addAction(openAction); </p>
<p class="paragraph">
06 fileMenu->addAction(saveAction); </p>
<p class="paragraph">
07 fileMenu->addAction(exitAction); </p>
<p class="paragraph">
08 … </p>
<p class="paragraph">
09 createLanguageMenu(); </p>
<p class="paragraph">
10 helpMenu = new QMenu(this); </p>
<p class="paragraph">
11 helpMenu->addAction(aboutAction); </p>
<p class="paragraph">
12 helpMenu->addAction(aboutQtAction); </p>
<p class="paragraph">
13 menuBar()->addMenu(fileMenu); </p>
<p class="paragraph">
14 menuBar()->addMenu(editMenu); </p>
<p class="paragraph">
15 menuBar()->addMenu(reportsMenu); </p>
<p class="paragraph">
16 menuBar()->addMenu(languageMenu); </p>
<p class="paragraph">
17 menuBar()->addMenu(helpMenu); </p>
<p class="paragraph">
18 } </p>
<p class="paragraph">
Функция createMenus() создает пункты меню, но не устанавливает их текст. И снова это будет сделано в функции retranslateUi(). </p>
<p class="paragraph">
В середине функции мы вызываем createLanguageMenu() для заполнения меню Language списком поддерживаемых языков. Вскоре мы рассмотрим ее исходный код. Во-первых, давайте рассмотрим функцию retranslateUi(): </p>
<p class="paragraph">
01 void MainWindow::retranslateUi() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 newAction->setText(tr("&New")); </p>
<p class="paragraph">
04 newAction->setShortcut(tr("Ctrl+N")); </p>
<p class="paragraph">
05 newAction->setStatusTip(tr("Create a new journal")); </p>
<p class="paragraph">
06 … </p>
<p class="paragraph">
07 aboutQtAction->setText(tr("About &Qt")); </p>
<p class="paragraph">
08 aboutQtAction->setStatusTip(tr("Show the Qt library's About box")); </p>
<p class="paragraph">
09 fileMenu->setTitle(tr("&File")); </p>
<p class="paragraph">
10 editMenu->setTitle(tr("&Edit")); </p>
<p class="paragraph">
11 reportsMenu->setTitle(tr("&Reports")); </p>
<p class="paragraph">
12 languageMenu->setTitle(tr("&Language")); </p>
<p class="paragraph">
13 helpMenu->setTitle(tr("&Help")); </p>
<p class="paragraph">
14 setWindowTitle(tr("Call Center")); </p>
<p class="paragraph">
15 } </p>
<p class="paragraph">
Именно в функции retranslateUi() выполняются все вызовы tr() для класса MainWindow. Она вызывается в конце конструктора MainWindow и также при каждом изменении пользователем языка приложения при помощи меню Language. </p>
<p class="paragraph">
Мы устанавливаем для каждого пункта меню QAction его текст, клавишу быстрого вызова команды и комментарий в строке состояния. Мы также задаем заголовок окну и каждому меню QMenu. </p>
<p class="paragraph">
Рассмотренная ранее функция createMenus() вызывала функцию createLanguageMenu() для заполнения меню Language списком языков: </p>
<p class="paragraph">
01 void MainWindow::createLanguageMenu() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 languageMenu = new QMenu(this); </p>
<p class="paragraph">
04 languageActionGroup = new QActionGroup(this); </p>
<p class="paragraph">
05 connect(languageActionGroup, SIGNAL(triggered(QAction *)), </p>
<p class="paragraph">
06 this, SLOT(switchLanguage(QAction *))); </p>
<p class="paragraph">
07 QDir dir(qmPath); </p>
<p class="paragraph">
08 QStringList fileNames = dir.entryList(QStringList("callcenter_*.qm")); </p>
<p class="paragraph">
09 for (int i = 0; i < fileNames.size(); ++i) { </p>
<p class="paragraph">
10 QString locale = fileNames[i]; </p>
<p class="paragraph">
11 locale.remove(0, locale.indexOf('_') + 1); </p>
<p class="paragraph">
12 locale.truncate(locale.lastIndexOf('.')); </p>
<p class="paragraph">
13 QTranslator translator; </p>
<p class="paragraph">
14 translator.load(fileNames[i], qmPath); </p>
<p class="paragraph">
15 QString language = translator.translate("MainWindow", </p>
<p class="paragraph">
16 "English"); </p>
<p class="paragraph">
17 QAction *action = new QAction(tr("&%1 %2") </p>
<p class="paragraph">
18 .arg(i + 1).arg(language), this); </p>
<p class="paragraph">
19 action->setCheckable(true); </p>
<p class="paragraph">
20 action->setData(locale); </p>
<p class="paragraph">
21 languageMenu->addAction(action); </p>
<p class="paragraph">
22 languageActionGroup->addAction(action); </p>
<p class="paragraph">
23 if (language == "English") </p>
<p class="paragraph">
24 action->setChecked(true); </p>
<p class="paragraph">
25 } </p>
<p class="paragraph">
26 } </p>
<p class="paragraph">
Вместо жесткого кодирования поддерживаемых приложением языков мы создаем один пункт меню для каждого файла .qm, расположенного в каталоге приложения translations. Для простоты мы предполагаем, что для английского языка также имеется файл .qm. Можно поступить по-другому и вызывать функцию clear() для объектов QTranslator, когда пользователь выбирает английский язык. </p>
<p class="paragraph">
Определенную трудность составляет представление удобных названий языкам файлами .qm. Просто использование сокращений «en» для английского языка или «de» для немецкого языка, основанное на названии файла .qm, выглядит не лучшим образом и может запутать некоторых пользователей. Решение, которое используется функцией createLanguageMenu(), состоит в «переводе» строки «English» (английский язык) в контексте «MainWindow». Эта строка должна принимать значение «Deutsch» при переводе на немецкий язык, «Francais» при переводе на французский язык и «♦♦♦» при переводе на японский язык. </p>
<p class="paragraph">
Мы создаем по одному помечаемому пункту меню QAction на каждый язык и храним локальное имя в его элементе данных. Мы добавляем их в объект QActionGroup, чтобы всегда мог быть помечен только один пункт меню Language. Когда пользователь выбирает какую-то команду из группы, объект QActionGroup генерирует сигнал triggered(QAction *), который связан с switchLanguage(). </p>
<p class="paragraph">
01 void MainWindow::switchLanguage(QAction *action) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 QString locale = action->data().toString(); </p>
<p class="paragraph">
04 appTranslator.load("callcenter_" + locale, qmPath); </p>
<p class="paragraph">
05 qtTranslator.load("qt_" + locale, qmPath); </p>
<p class="paragraph">
06 retranslateUi(); </p>
<p class="paragraph">
07 } </p>
<p class="paragraph">
Слот switchLanguage() вызывается, когда пользователь выбирает язык из меню Language. Мы загружаем файлы перевода приложения и библиотеки Qt и затем вызываем функцию retranslateUi() для нового перевода всех строк главного окна. </p>
<p class="paragraph">
В системе Windows в качестве альтернативы меню Language можно использовать обработку событий LocaleChange — события этого типа генерируются Qt при обнаружении изменения среды локализации. Событие этого типа существует на всех платформах, поддерживаемых Qt, но фактически они генерируются только в системе Windows, когда пользователь изменяет системные настройки локализации (при задании параметров региона и языка на Панели управления). Для обработки событий LocaleChange мы можем переопределить функцию QWidget::changeEvent() следующим образом: </p>
<p class="paragraph">
01 void MainWindow::changeEvent(QEvent *event) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 if (event->type() == QEvent::LocaleChange) { </p>
<p class="paragraph">
04 appTranslator.load("callcenter_" </p>
<p class="paragraph">
05 + QLocale::system().name(), qmPath); </p>
<p class="paragraph">
06 qtTranslator.load("qt_" + QLocale::system().name(), qmPath); </p>
<p class="paragraph">
07 retranslateUi(); </p>
<p class="paragraph">
08 } </p>
<p class="paragraph">
09 QMainWindow::changeEvent(event); </p>
<p class="paragraph">
10 } </p>
<p class="paragraph">
Если пользователь переключается на другую локализацию во время выполнения приложения, мы пытаемся загрузить файлы перевода, соответствующие новой локализации, и вызываем функцию retranslateUi() для обновления интерфейса пользователя. Во всех случаях мы передаем событие функции базового класса changeEvent(), поскольку один из наших классов тоже может быть заинтересован в обработке событий LocaleChange или других событий. </p>
<p class="paragraph">
На этом мы закончили наш обзор программного кода класса MainWindow. Теперь мы рассмотрим программный код одного из классов—виджетов приложения, а именно класса JournalView, чтобы определить, какие изменения потребуются для обеспечения поддержки им динамического перевода. </p>
<p class="paragraph">
01 JournalView::JournalView(QWidget *parent) </p>
<p class="paragraph">
02 : QTableWidget(parent) </p>
<p class="paragraph">
03 { </p>
<p class="paragraph">
04 retranslateUi(); </p>
<p class="paragraph">
05 } </p>
<p class="paragraph">
Класс JournalView является подклассом QTableWidget. В конце конструктора мы вызываем закрытую функцию retranslateUi() для перевода строк виджета. Это напоминает то, что мы делали для класса MainWindow. </p>
<p class="paragraph">
01 void JournalView::changeEvent(QEvent *event) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 if (event->type() == QEvent::LanguageChange) </p>
<p class="paragraph">
04 retranslateUi(); </p>
<p class="paragraph">
05 QTableWidget::changeEvent(event); </p>
<p class="paragraph">
06 } </p>
<p class="paragraph">
Мы также переопределяем функцию changeEvent() для вызова retranslateUi() при генерации событий LanguageChange. Qt генерирует событие LanguageChange при изменении содержимого объекта QTranslator, который в данный момент используется в QApplication. В нашем приложении это происходит, когда мы вызываем load() для appTranslator или qtTranslator либо из функции MainWindow::switchToLanguage(), либо из функции MainWindow::changeEvent(). </p>
<p class="paragraph">
События LanguageChange не следует путать с событиями LocaleChange. Событие LocaleChange генерируется системой и говорит приложению: «Возможно, следует загрузить новый файл перевода». В отличие от него, событие LanguageChange генерируется Qt и говорит виджетам приложения: «Возможно, следует заново выполнить перевод всех ваших строк». </p>
<p class="paragraph">
При реализации нами класса MainWindow не нужно было реагировать на событие LanguageChange. Вместо этого мы просто всякий раз вызывали функцию retranslateUi() при вызове load() для QTranslator. </p>
<p class="paragraph">
01 void JournalView::retranslateUi() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 QStringList labels; </p>
<p class="paragraph">
04 labels << tr("Time") << tr("Priority") << tr("Phone Number") </p>
<p class="paragraph">
05 << tr("Subject"); </p>
<p class="paragraph">
06 setHorizontalHeaderLabels(labels); </p>
<p class="paragraph">
07 } </p>
<p class="paragraph">
Функция retranslateUi() заново создает заголовки, используя новый переведенный текст, и этим мы завершаем рассмотрение программного кода, относящегося к переводу созданного вручную виджета. Для виджетов и диалоговых окон, которые разрабатываются при помощи Qt Designer, утилита uic автоматически генерирует функцию, подобную retranslateUi(), которая автоматически вызывается в ответ на события LanguageChange. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Перевод приложений</p>
<p class="paragraph">
Перевод приложения Qt, которое содержит вызовы tr(), состоит из трех этапов: </p>
<p class="paragraph">
1. Выполнение утилиты lupdate для извлечения из исходного кода приложения всех видимых пользователем строк. </p>
<p class="paragraph">
2. Перевод приложения при помощи Qt Linguist. </p>
<p class="paragraph">
3. Выполнение утилиты lrelease для получения двоичных файлов .qm, которые приложение может загружать при помощи объекта QTranslator. </p>
<p class="paragraph">
Этапы 1 и 3 выполняются разработчиками приложения. Этап 2 выполняется переводчиками. Эта последовательность действий может выполняться любое количество раз в ходе разработки приложения и на протяжении всего его жизненного цикла. </p>
<p class="paragraph">
В качестве примера мы продемонстрируем перевод приложения Электронная таблица из . Приложение уже содержит вызовы tr() для всех видимых пользователем строк. </p>
<p class="paragraph">
Во-первых, мы должны немного модифицировать файл приложения .pro, указав языки, которые мы собираемся поддерживать. Например, если бы мы хотели поддерживать кроме английского также немецкий и французский, мы бы добавили следующий элемент TRANSLATIONS в файл spreadsheet.pro: </p>
<p class="paragraph">
TRANSLATIONS = spreadsheet_de.ts </p>
<p class="paragraph">
\ spreadsheet_fr.ts </p>
<p class="paragraph">
Здесь мы указали два файла переводов: один для немецкого языка и второй для французского языка. </p>
<p class="paragraph">
Эти файлы будут созданы при первом выполнении утилиты lupdate, и затем они будут обновляться при каждом последующем выполнении lupdate. </p>
<p class="paragraph">
Эти файлы обычно имеют расширение .ts. Они имеют простой формат XML и не столь компактны, как двоичные файлы .qm, которые «понимают» объекты типа QTranslator. В задачу утилиты lrelease входит преобразование предназначенных для людей файлов .ts в эффективное машинное представление в виде файлов .qm. Между прочим, сокращение .ts означает файл «translation source» (файл с исходным текстом перевода), а .qm — файл «Qt message» (файл сообщений Qt). </p>
<p class="paragraph">
Предположим, что мы находимся в каталоге, который содержит исходный код приложения Электронная таблица, и тогда мы можем выполнить утилиту lupdate для spreadsheet.pro, задавая в командной строке следующую команду: </p>
<p class="paragraph">
lupdate -verbose spreadsheet.pro </p>
<p class="paragraph">
Опция —verbose указывает утилите lupdate на необходимость более интенсивной обратной связи, чем та, которая обеспечивается при нормальном режиме работы. Ниже приводятся сообщения, получения которых следует ожидать в результате работы утилиты: </p>
<p class="paragraph">
Updating 'spreadsheet_de.ts'... </p>
<p class="paragraph">
Found 98 source texts (98 new and 0 already existing) </p>
<p class="paragraph">
Updating 'spreadsheet_fr.ts'... </p>
<p class="paragraph">
Found 98 source texts (98 new and 0 already existing) </p>
<p class="paragraph">
Все строки, которые задаются в вызовах функции tr() в исходном коде приложения, хранятся в файлах .ts (в том числе и псевдоперевод). Сюда также включаются строки из файлов приложения .ui. </p>
<p class="paragraph">
По умолчанию утилита lupdate предполагает, что передаваемые функции tr() строки используют кодировку Latin-1. Если это не так, мы должны добавить элемент CODECFORTR в файл .pro. Например: </p>
<p class="paragraph">
CODECFORTR = EUC-JP </p>
<p class="paragraph">
Это должно быть сделано в дополнение к вызову QTextCodec::setCodecForTr() из функции приложения main(). </p>
<p class="paragraph">
Затем в файлы spreadsheet_de.ts и spreadsheet_fr.ts необходимо добавить перевод, выполненный при помощи Qt Linguist. </p>
<p class="paragraph">
Для запуска Qt Linguist выберите пункт Qt by Trolltech v4.x.y | Linguist в меню Start в системе Windows, введите linguist в командной строке в системе Unix или дважды щелкните по Linguist в системе Mac OS X Finder. Для добавления перевода в файл .ts выберите пункт меню File | Open и укажите файл для перевода. </p>
<p class="paragraph">
С левой стороны главного окна утилиты Qt Linguist отображается список всех контекстов переводимого на другие языки приложения. Для приложения Электронная таблица этими контекстами являются «FindDialog», «GoToCellDialog», «MainWindow», «SortDialog» и «Spreadsheet». Справа вверху выводится список всех исходных строк для текущего контекста. Каждая исходная строка сопровождается переводом и флажком Done (готово). Справа по центру находится область, где мы можем вводить перевод текущей исходной строки. Справа внизу отображаются подсказки по переводу, которые автоматически генерируются Qt Linguist. </p>
<p class="paragraph">
После создания нами файла переводов .ts необходимо его преобразовать в двоичный файл .qm, чтобы он был понятен для QTranslator. Для этого в Qt Linguist выберите пункт меню File | Release. Обычно мы начинаем с перевода только нескольких строк и затем выполняем приложение с применением файла .qm, чтобы убедиться, что все работает правильно. </p>
<div>
<img src="data:image/jpg;base64,iVBORw0KGgoAAAANSUhEUgAAAWgAAAEKCAMAAAAIBz+2AAAACXBIWXMAAAsTAAALEwEAmpwYAAAKT2lDQ1BQaG90b3Nob3AgSUNDIHByb2ZpbGUAAHjanVNnVFPpFj333vRCS4iAlEtvUhUIIFJCi4AUkSYqIQkQSoghodkVUcERRUUEG8igiAOOjoCMFVEsDIoK2AfkIaKOg6OIisr74Xuja9a89+bN/rXXPues852zzwfACAyWSDNRNYAMqUIeEeCDx8TG4eQuQIEKJHAAEAizZCFz/SMBAPh+PDwrIsAHvgABeNMLCADATZvAMByH/w/qQplcAYCEAcB0kThLCIAUAEB6jkKmAEBGAYCdmCZTAKAEAGDLY2LjAFAtAGAnf+bTAICd+Jl7AQBblCEVAaCRACATZYhEAGg7AKzPVopFAFgwABRmS8Q5ANgtADBJV2ZIALC3AMDOEAuyAAgMADBRiIUpAAR7AGDIIyN4AISZABRG8lc88SuuEOcqAAB4mbI8uSQ5RYFbCC1xB1dXLh4ozkkXKxQ2YQJhmkAuwnmZGTKBNA/g88wAAKCRFRHgg/P9eM4Ors7ONo62Dl8t6r8G/yJiYuP+5c+rcEAAAOF0ftH+LC+zGoA7BoBt/qIl7gRoXgugdfeLZrIPQLUAoOnaV/Nw+H48PEWhkLnZ2eXk5NhKxEJbYcpXff5nwl/AV/1s+X48/Pf14L7iJIEyXYFHBPjgwsz0TKUcz5IJhGLc5o9H/LcL//wd0yLESWK5WCoU41EScY5EmozzMqUiiUKSKcUl0v9k4t8s+wM+3zUAsGo+AXuRLahdYwP2SycQWHTA4vcAAPK7b8HUKAgDgGiD4c93/+8//UegJQCAZkmScQAAXkQkLlTKsz/HCAAARKCBKrBBG/TBGCzABhzBBdzBC/xgNoRCJMTCQhBCCmSAHHJgKayCQiiGzbAdKmAv1EAdNMBRaIaTcA4uwlW4Dj1wD/phCJ7BKLyBCQRByAgTYSHaiAFiilgjjggXmYX4IcFIBBKLJCDJiBRRIkuRNUgxUopUIFVIHfI9cgI5h1xGupE7yAAygvyGvEcxlIGyUT3UDLVDuag3GoRGogvQZHQxmo8WoJvQcrQaPYw2oefQq2gP2o8+Q8cwwOgYBzPEbDAuxsNCsTgsCZNjy7EirAyrxhqwVqwDu4n1Y8+xdwQSgUXACTYEd0IgYR5BSFhMWE7YSKggHCQ0EdoJNwkDhFHCJyKTqEu0JroR+cQYYjIxh1hILCPWEo8TLxB7iEPENyQSiUMyJ7mQAkmxpFTSEtJG0m5SI+ksqZs0SBojk8naZGuyBzmULCAryIXkneTD5DPkG+Qh8lsKnWJAcaT4U+IoUspqShnlEOU05QZlmDJBVaOaUt2ooVQRNY9aQq2htlKvUYeoEzR1mjnNgxZJS6WtopXTGmgXaPdpr+h0uhHdlR5Ol9BX0svpR+iX6AP0dwwNhhWDx4hnKBmbGAcYZxl3GK+YTKYZ04sZx1QwNzHrmOeZD5lvVVgqtip8FZHKCpVKlSaVGyovVKmqpqreqgtV81XLVI+pXlN9rkZVM1PjqQnUlqtVqp1Q61MbU2epO6iHqmeob1Q/pH5Z/YkGWcNMw09DpFGgsV/jvMYgC2MZs3gsIWsNq4Z1gTXEJrHN2Xx2KruY/R27iz2qqaE5QzNKM1ezUvOUZj8H45hx+Jx0TgnnKKeX836K3hTvKeIpG6Y0TLkxZVxrqpaXllirSKtRq0frvTau7aedpr1Fu1n7gQ5Bx0onXCdHZ4/OBZ3nU9lT3acKpxZNPTr1ri6qa6UbobtEd79up+6Ynr5egJ5Mb6feeb3n+hx9L/1U/W36p/VHDFgGswwkBtsMzhg8xTVxbzwdL8fb8VFDXcNAQ6VhlWGX4YSRudE8o9VGjUYPjGnGXOMk423GbcajJgYmISZLTepN7ppSTbmmKaY7TDtMx83MzaLN1pk1mz0x1zLnm+eb15vft2BaeFostqi2uGVJsuRaplnutrxuhVo5WaVYVVpds0atna0l1rutu6cRp7lOk06rntZnw7Dxtsm2qbcZsOXYBtuutm22fWFnYhdnt8Wuw+6TvZN9un2N/T0HDYfZDqsdWh1+c7RyFDpWOt6azpzuP33F9JbpL2dYzxDP2DPjthPLKcRpnVOb00dnF2e5c4PziIuJS4LLLpc+Lpsbxt3IveRKdPVxXeF60vWdm7Obwu2o26/uNu5p7ofcn8w0nymeWTNz0MPIQ+BR5dE/C5+VMGvfrH5PQ0+BZ7XnIy9jL5FXrdewt6V3qvdh7xc+9j5yn+M+4zw33jLeWV/MN8C3yLfLT8Nvnl+F30N/I/9k/3r/0QCngCUBZwOJgUGBWwL7+Hp8Ib+OPzrbZfay2e1BjKC5QRVBj4KtguXBrSFoyOyQrSH355jOkc5pDoVQfujW0Adh5mGLw34MJ4WHhVeGP45wiFga0TGXNXfR3ENz30T6RJZE3ptnMU85ry1KNSo+qi5qPNo3ujS6P8YuZlnM1VidWElsSxw5LiquNm5svt/87fOH4p3iC+N7F5gvyF1weaHOwvSFpxapLhIsOpZATIhOOJTwQRAqqBaMJfITdyWOCnnCHcJnIi/RNtGI2ENcKh5O8kgqTXqS7JG8NXkkxTOlLOW5hCepkLxMDUzdmzqeFpp2IG0yPTq9MYOSkZBxQqohTZO2Z+pn5mZ2y6xlhbL+xW6Lty8elQfJa7OQrAVZLQq2QqboVFoo1yoHsmdlV2a/zYnKOZarnivN7cyzytuQN5zvn//tEsIS4ZK2pYZLVy0dWOa9rGo5sjxxedsK4xUFK4ZWBqw8uIq2Km3VT6vtV5eufr0mek1rgV7ByoLBtQFr6wtVCuWFfevc1+1dT1gvWd+1YfqGnRs+FYmKrhTbF5cVf9go3HjlG4dvyr+Z3JS0qavEuWTPZtJm6ebeLZ5bDpaql+aXDm4N2dq0Dd9WtO319kXbL5fNKNu7g7ZDuaO/PLi8ZafJzs07P1SkVPRU+lQ27tLdtWHX+G7R7ht7vPY07NXbW7z3/T7JvttVAVVN1WbVZftJ+7P3P66Jqun4lvttXa1ObXHtxwPSA/0HIw6217nU1R3SPVRSj9Yr60cOxx++/p3vdy0NNg1VjZzG4iNwRHnk6fcJ3/ceDTradox7rOEH0x92HWcdL2pCmvKaRptTmvtbYlu6T8w+0dbq3nr8R9sfD5w0PFl5SvNUyWna6YLTk2fyz4ydlZ19fi753GDborZ752PO32oPb++6EHTh0kX/i+c7vDvOXPK4dPKy2+UTV7hXmq86X23qdOo8/pPTT8e7nLuarrlca7nuer21e2b36RueN87d9L158Rb/1tWeOT3dvfN6b/fF9/XfFt1+cif9zsu72Xcn7q28T7xf9EDtQdlD3YfVP1v+3Njv3H9qwHeg89HcR/cGhYPP/pH1jw9DBY+Zj8uGDYbrnjg+OTniP3L96fynQ89kzyaeF/6i/suuFxYvfvjV69fO0ZjRoZfyl5O/bXyl/erA6xmv28bCxh6+yXgzMV70VvvtwXfcdx3vo98PT+R8IH8o/2j5sfVT0Kf7kxmTk/8EA5jz/GMzLdsAAAAgY0hSTQAAeiUAAICDAAD5/wAAgOkAAHUwAADqYAAAOpgAABdvkl/FRgAAAwBQTFRFAAAA////zMzMd3d3AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA8TfRUAAANJlJREFUeNrsXddiKzmurCLO//8xWPcBBAl2kOU0ln1XZ9djS60ODAgFoEACAPHhlxj/X3/GX6LqWTWvIT440/GdPFc5QocTCdxPL4oCANRfIQDjj8vXo8/mERRFzB/7L/Oe8u91eYCMH27jMfKacffieGs9jVseVm6hDOjxbbf55rhAHu12Hmi38r7GdXmcrG0GwYtZ0rwrrQuDpzsfX2W991gsOas5VHy0SB4sxLxJAqQDgMFhpwPnUzsMnu8ejnv8vtW/rRy9v+z0gW3Xvf5mvGvqh7cF+vwtLiw6DGVNgopVCrdxxLZGx0obO8thbqc7mO/kL+sQ83wGCSCb4fe/7M03YPbWEVef2em/+S9+5Ef5wy4v2wjyL4zzq027HQbc+O8zivD/81BWMXYUKAYZWloDDgA0sv9v2N7/akWrmpoO+qHYMRQAsf1vzD7/op8tHpJOggwhUgbarL2lIv73WhLYL2yu/JSkBAc0P1QrcoXFIrPPDrj93WF2wH2zL61YHrGktVs5hlbGefsymo1DY6VfGIG2vbdPjYGtvtPihI/Mrcdr6PIe7OpWvn2KzbdbHy6Wpamh6YkKAFwAHP8OLt1QoOpo8z1eehMAhhptMUXaXZVWJZcJJjdt+llPP9qNR5ZaB1ZWyeEi3/K68azKHFMQRE4f8N90AHXy7NtmuJhbHhduEmAD6hiPZulE+5grmBhONQhv857iTPv4oHigiRi4QR0WG3F6gOniAapuGET4mL59f37xIO/zaHnXvoMmHG53PncrA2shf+YKYlWngskhEzsEwQTIBfepdZ0YH5RpdoPLICzBIYPcAXgFcgR3yNHyt/iwQTHC8JgFEyhr8B368GmxChDo/9lyPg87AQ+/2w3GfaA9lnCdFN/OHiMDwkDPN4g2J5hwOZVriROKAuWML8SG0A7DhcQjzEB43JlgoAGkxX5IMylhOVjcxdnIor9HKn1W03viMQfQRyAhm/eyVrQ7WW+8AFfDxWcsY3SfPr13aunaM+wzpXxZ0e49tKXG0T5uVsPlUgBdnpoECGNpzADhYKz67Wm1RqCXRfM9i3o+jeVQ7ws+BYfl2miXu8JpDRN7iiXnLjjHfNIQIx/yNMGVaiDCE4E05Z6gOWUWYgrErrwJyMSBWZo5ZICzGWg2Rp0uGMZpqkOsvDeYtW8HFqZM9qFwbFkSHJt9gOC52G6m3tpuBxZLq7X1TrEfbTzl3UYb28DubDADrBWLbZ7yeF6zS0vO1u183g34lHtuMGvD4ht3224H+u5mrdkjXNU+tWU/MD5m/9Wo2jsGOrFUm27Iv/cqV79Cv8+29Tdo9K/6xofdlKehj7mxljwF/4fefc/aX6EZBxDi9n+vb7C0OxxO73PLsc1lPiM06w9bxt0Gm9gGNJzll+168s+s02cfyKouD5iC7PPbM2BMhQuphEfCSRA2j4blWyqOzuNfliQb5macl8r0gPLbvMA4ZH68oJt63IjxX8RY58fx15YPkM7T9tb87vzjUho/dozya3Q0IwULh1x4dLJTQJ97kP4DeLm+7qC3Drv6XOMxFD/qw6wsjZKogjqfz+FfA8vQgEn9EZxWkzIOty5Jujn8GUzuTe2NJ1Mp9Oa5dHd+AgSnb789LOMx94+Kx6y4cPFKdJhRLjBzSm/FGXl5T2XSNyGTDnLew5MOGS+n7mJwvsbB+9Tk8/TJyI1SnQjmB1rbfJv+lo6CyE4CzsM2IjtJ0UFuEPX4go7rYCyRq/Htmb3UCTAcet4cTXY+gQ9FXO7BhDKv/NTw843FMR5XIbtHTtPK5tL4c+R1zcU5RIclDjpuraHmX3mT0BjjUxTgUEdky+clIlXECa539mFxMuAPAiIJdwK8ONobfJyFnMcAh4F1ymPrk4cppscDtYvJ1/WY6k6ArtEUIFKUOHPHxmiLQ9fG4h4/4Sk6XBABJ7rD6ePGV34epzmoccLxlzvgzt4BOhyIL7ujA3RHrwpT5jJ4B5wdbmOUY0S6D8wql8/AB+kOIQxSuvfD4pQ5DaT37ui+qyJ0urP7eLg6hjwMqaaI5dV6J6dMj0Ny0hcUPD7SfJO5oyxFh0EQ3KAZ/6gGGASoGWTWmSeM2zIDDW6maj1bMwfkMNlhQ3Lgeg61cSkb822y7bG9w6DmIxBDw2VyYEBoM/HND77wuBog2bzvqQXL+lYOs+7X+3wGHVWJimodwnk/w251aKLW9Wbjez6AP+aKFgEX3QNR9ebu7glKj3P4aTN6Qkd0n14N5UcTx9Hm7XoAR26Gpua+JwQ7zGDWmp9cJ0kGa6nydU5SLqNOTHOAD8T5YRAvznkUU37EoxU4sW/ngXfSOgHIOW8JoGzulAEn5SB3N/RuUMT/uN+wO2DWc9jdAe+2LbMVrddasm5wkB22mTcWwa4hunVy5synZOcD7acHGpEP9OWzhhbZYXOWvOWUasPjDqHbNYsqBmG6WyuqcmXDR7SVQ4to7BJsaVRDDk6lkgngmbV94WES6fVdD4LDvjm+9WCQ0zMUc7rbxT221pouTX1vJ8tu98yv5lzm7Rkbmy61k0snnRZUHHfzhM3VBAyzCU94dPr64AwFcmxF6P4yWT1x6eaGoqVufeUnnOPzIdTjExA/tjw/8OqYK/rgrVVpHrbh2SDmc+N8J9n4yLMBrrbKaSI+vfb4TcceFmwTZn50mn4DMWEK6tB+KlUg2opwNNG7NdissPcEZSq0VgBA7s72wnE47SbNcVXW66ikxM6Tpx1cyiFWXc7BKmNBfEL8z6qdWfCzqYD62PW9InN255GYusdhMkKwdKWZKOK958vnZNIGyiw/gFozyglzplXFCh2MA/jg2tv2Y90G4uY+XMijcX7GQ4//rCkb/+WYuALeztUWF8Gsdtl9m3p8k5jKMB9yfWN3aJX+0KWp+KQCmcL+8OiPwd45ehUPvzGy+FBHfFrPldF8j4ShwIFHPxSFY4J5xNwOilp884JrlT8r3/iVUpjvFsO8tA30TtnesfBonb/Mmv+xpIkOi0q7HtUt+shnh44bJPlRnUTwvWGJixrEq8F/3+xrgQxrUK8uwrWiyc4e/+FEW7m7VwsUP5xJuvRg36sI9CyurUtJwSsH/MLHnhu5VgXviLzetaMelVNIW/Gpu2dq+8jb3FYgWYDvowuj3BIqKKs+g9NrWZl6uDG07Sph2qo17JnHjgeZN7cBNcPv1fCbeDFTx4cK8DcAgpa5xhe3OYQHh9ndihuts1RWDXJexkviOW/Mbl4gDnosw58MWk4MjBcF1jrUV/OwjHlU5XnvtQpevPSholQXdFODzruVS/6mNbNboLbfQwFqdSsZMujAI0SZS9Pd3blsDHfUYIDOPj5vE5W0AOb9fgyQoBOCNAVhiSwoFgePqty3iOISmJxRxAKw+BYzrDsklYj28TlE8jzjx2s+F466P2zFPsQMHeiwet1REdsl0fgQUmvwC8xTqdy57iTq/XQY5gX4L9Xum0ks1UBswIHFU5venmKYWB0jmwXiY6BLFHgpM5LQSECVBNsVaYwpp0QYebcrV5Vr0lMudjh5CjmDdLeRrTjHbbIi3GtGCZCxLMW1FPJPKWNNnLD8iIyVkdpXPi/N1d0x4h4YwXou1XzdmYDZCjY95i22f85RzhwrH0TRhiPASq59NpFzLRUjVbm7wJM43s0GTL0KmxoESW/KYF3Zu+K6Zk51rGawjXFcuMIK8ZOkwzHx2XpqrezysbYmTJSnTK92/NLjkguPXuhd4AnYqDuwpMeg7BjRL86v1F27+TBK3RKhPnY0LRdP7KN6TAP5r0VLi97kMSiQYMXuU2hHbw46V2nQag+WEMk2cQAs18MO/DVlzSHr4+DKNSjQu5bZ/6yCdY2plvsrh/fuHrGo4qcU8SXf4mqcsmjm8R8gbYO7m9AN2m0jcoE+euTxiuCg6ygY01w4E2+aMtG9hO1YBDBjG8MsqnVWhURiYHMPW8nkmEk0KvOHEsAwGP6hVKRtC3SbTIGgKdIElKGYBZkVd3GOyp4IMT6ryQQpggzMhVwW9LRt7yOlxMZQc4JiOPIvAqFKSe1WzzjBSi6z1ht3VPAqnpHwEosLSrhNdVA2gEkNcHehTT/QkZZBJpUX7eXx2V4ixSrfrt0mkugdQ3dpc5JM8BFB3LOhUuLzBhshIDmOFlxRlKoOwUjDGIG7bedraM0RTLYqA0720byv6pwOXRgLhXOPy0nBnWyZ4bayxDxyktjdDoHpIyq59OfIKsrhY7Uo4rPI5mj0AyZiVJaC0tEuQB2GRaYrvIe0e78wlVc1cquhsKfckWCKtnmXkSWzJPC0bct6qnazSctEGesptNpQhitLt4+CWA+LJKmHMgUgZiz+uwB8Ttnjpl37nCorIzdk7b0pRzpwjBGyQoPHTTJ4riTeOYjVt9S+mYea2h0/BdI2uZj29IqDTN+iGhjMTFr4XnEiO8BwwZeBkcXLy5bLB11BjD2ivHKVHW1WIldXZH+jQZVVhA6Li/EaqxMvicn2jXHtrrOCkuLms19n+k4aNMdN1Jy7ZVSnwE07dKyViBHBWXCKQWbZnDZTiSlbHDDHNgtjJkeRtukIdsTkOmDbyOiZUC7v4Q7uuvMy0X2U6GILOKiO98TNmBXuyrFZY7CwkiKEuO8EgCP/DUcNcFzRU21eVOCLaj7q7nUCaxiF9ga3crEDcDMob4Y7+QVh7POK3He4yvOmXLAZTLy4R3orkQ4H2nanC9rRCY3iGYGay1N1Rc/56bYLhiOZ4kU8SAxpUmTXM6Hht8NLH4888Srfp5idJb3ukKE/F3hK3KsxxIIp9VYIhqorujPN3+MyWXtgrw/ZTiq+fzCpz43p1N4PZ6mWt1wVPezDeBxM8O7uDkShV08xa2dioNus9eER40OBiELBhgTgHp/ijujyQdL8gzSPdw7zybC6QbePECeuR7ImMxdz55Aor6OrdIb5tygSWfypNuGrLUP9HIimJpKiNM+0W0iqftpbGVj6UFyFz1Rl6BTwk7DhnfOBV2gkS7KWBz32cklB3+srCnq8q+QamJr7jmy+06MUtIB6dhtn3kPRyw/thplyoXekd91oMa5sl4sl8gqpY1N02AJ5dMIc5yLiArbHL1nRoJEoKe4ypbDrsma7rLqT2CZ8IF/KVSdmUuuoAKV6ydoLjuSWmRaU4BbHq4DL+UbWb2woeR6C+WHFFOb7rBg7z1U1gUKxKSyu+Syr4EsfVU4zYYsPlCCPwqlMYc050nb6A/DBWRnFt4TRVdbGbfR7fMbj4N7WNp2uwB3HHHb0TG5LNuqC5ersEB/iWkrQeKt23THlC2+MRy1+kAApjRIiT8nBqr8PEmgmUh+zIJc1t+UFrmzAddKCpm/04ounu3KulVTumQM2b3qZd0YILV33zU47TfPUC/X/71jzHzDTqFO89XF+gvi8gtU30tQchzLRuyxiO9sqFbAhJwpbKz1U6xfvJ0Ar5LXvCGIFwQ43URJAeD8wK2g9QX4Vx/B8R9I5v0ZvzI7OWTbaKuI1wL3ADakRCFaSVw3jo9ZrkodY3EpkHUHEElMrPg03SO580xwJBSNk2EdgUgLhXoITWzpAm2uEutwb4wszqzbNfbFaZgt5Uo3knjbcLr90WBBH2H8zb0h0794JEo0RnmRiaXF5b10iW2bWkESLwqlE0Tkj+FU+LjEMneMQO/bsk3kNTnYrj+TWCiheNY6vALDzUoRQiWVSVTfyUKawqoofyb2qVmeMiivOnPWAIUlLEfgI907moT64LMm5on0aG06PpAB471F5OgpF1/bRinXVeKCqlOEh0SLNSR+wtczd1FeU1pyiR2lu753dO8lOxJz0Eb7RxXIWyAgoRVBNS0ktr2Tsa+XxBwtsbqUCzAUMSSnqZCllxWyqRK7Y9YhfJz+sFI/Yp8D5BwLWYR2AN8sAqpubAuwqCAdXxj5Ltwdm5sTKa6N4hhBsjvSkipzLx9yCzzQoyCwJMJm5Hm5W2R3AkiIzMfiS5455q1ohWk4Bd0Bs5kMQtcMHdXbieAa012+WiRi17GCtaMpbsv2PKDFqxVVeVNy2lrZBDRdGNd2JZxqEQAabm/lWvSzzxVsz9qS1cS2zupGZcYgEZzJLXqK0JkHTK5lQzhJwrPkvVMlC1hRDEdXOjP+APUVlbUd8ONKi4qIm2Tgf3ayDIWAshtMA89YzjmXmMO9w88E3Wgtbhmxe0Mgs7NBBfpxS7PpUt25SjPTQtp2AeYdFAoh85ejFenZD9+LH5OCw5HWEP6Gzr8lTsFMlsWJzrPKMKOum0NGMwZ6hY1R+AcFJjJH2Jlm6jZlN2nHYJROjoC68FFZc9og+6rHjpIMHwWXzL0hKJbusOghLOl6azqdaQX3Axb22uAspUO1ohNuwTqUOmng02gW+fVHieBUQ22TxHsEBxCuGoD3wMgrea08k8AojvgHX1zXWCOhtzhU+6biIq+xsEkRcgM/LMlwBs1F61RyzoPNRgOh94aRPBETu4wd3KdeTHYPXa/CtVfqMy6ilVcsC2wL9ehAeGPHn/m8rkapOfCXfWnj/rPSbSdk8TGSqxom1aTOnuQUIuEO2yyLnwTndKvOWuMnK6knnNYe9WDQsd1XC4AkcFnxHU4UObZfnXoj8eHLy1OSMF5HlkmVBCu2Yt/CBRfn467zPwOVTb+Fzt7X/eQ3LnouZ7hLq+T4EhULTPwi1eP7bRnrzFHkCAO8GKLdO3eiV5vtKRKhCidyVSkFrsGjtSlC07IsCJyb0xfTdWIpsscp5hwGI2fGsrOgmfCnbcrm3ra1gidkQK4syc7Y2LPtQgHz44Ii1XrypOwz8PWGjpzcc3zxTk5EfGegnEUY+twN4HWC+tioPCKSuVNGXA6DiJ85LoSXThd4ema3GjnoKjdZ9JfcOxJ0CzBd26gp+1Ru+DNcSd+V1KhDJM8+wioEEKaoGJuRTUBRt/yAd614bLkCgy6txm44zgc+4b91af494Is+TIF7jxKxDuWHFOkWjHlxoBj91P7o1Wk4EcEXOTqhIq2sSNQycaeSmaoOxS/y79yvSwmN2RAlbbmB7+uA3EQ7eK0lV6P+wqLdg6aUbNn5r3KuFjrSTtwWz50xUrWgWGRUv8ZgJnVfigEWJEE7XiBSHPO5FLNfcz61c4GwIbWlpzIuv/MiIF99tRu93hH5UdDnyWtJ6I1dwEbGMkjWsIgdRY7Mv8zbR0V20HJISVIqlRmK2ezj+izTUgT2lQ9USrxGkDl/tmcpAW18BedYKX6kOv+AmCY1Ei8zyEeN3Spt4vOCtmcnx1VyNdIc2k8MPARA+4A6Z8LGkeSPgQjzpzIQDd2JnojhiIqUwKTC5DpMiHDLzCkYLvRoZXyp5YPeKOijzcy140tQFdSLJWIIaDCIrdDuqDulgH+UB7p1OL5EvHk1kAWB3Z4c72CsR4IKQnPTeO8AkZXyL0mfUT8pIsIOdiDhBJ9k9l1ZPNjRe6f75rpY7z6jEMIB98LOSZO8WUONI7ehB0FpXRW4ks9piqhIMjropR0tqxFVFX2Y//nQTYLIgcTSYm0l77Ly2xUb2Q5bVBmfcAhxwNMvyGV85M3pgFWTgxOlNHoSDDQieyAEAOBRRDV7OHDOUy0S1a7qum+BwhCCxkSE+9UBzLIyaErdoreXN/9uDjfP2DWs5rw7ZsbQNm7rO3PUK7PIY59QWgFgVsiOU0Gv6pAkz10RD3d9Zj0tWRnNoH/i6IBpMI2t7+k246OE+CXhC0iajE2f6/2xwZyP0NIsienAobn7lKrirm7qtK3oHmncffKPumn5nSS+IKF6HBUA/Jtk9GSAvc3+4qlxGq7JtE3m0jevezGO7m6H7pT9zktGxizth1glzOlxY+V2DxNPN6SeG/INzyYwjTb7RZKItoWILKQnziEn59NknEe8htWEC/4FHU5dJ5iU3uuZ81Ia2nICabkGlfTtiV0sl72ehunqPU8qVBIGSbrR4vLQXAVy6nDx5gPmUC6Ks9F7c9ixnw4IN/Awe254u+GK0uDBzl0Y81zfuGD+vUKICB2m/h92rE29G4g23Xjfulq6CL8S1v596qCIAZXUWlraZADbvNgHjlfu5xx6EpljRj2k7H/YOWAwGW/+I53CBpEd4knSGHznqjW9dcqBcHrW1uChvo7RbWMcV9Ko5rLcrV/A55LOYylqR/Auk6LbuFSXke3SNeYaG+dRC55UBeP8YzzGS5ba/CPputBhMa/xUF9neAlTe/lwF66lWc0WgVDSDcOoSsRNEpalFHaLWZeR4B5qc02pXHxbyBrp/m1Crxoie4Tk7Dd6Q0Qcw90wcLG4UkZmlWly3nVlgeMG8Ram0yvzCF2JfpLk6K64ZHH2vcFEJnN64P3qigcYietShAukKoN0sh2s8mm+GYD9G/8cHsNKwNJu0CPNRIwSnYNxFJvV5FesuFX4LkhzO8Njk+Wgo5DTQbOynwvdWBqmB6wg+E61gW4UP10K+cqF9T5j964OR77lSBf53YO5u+w3nu41s6ufue1EeifcG8Ef1xDsDJf/ZQJ+u9G97u7mdj4mEtkEW6wbrg1I6yU7I69WYA9lTtunOjdYjNTIJVVb9x/etQ0rfs5/+FetFzc1hpyY8njQom3SmRydkrtDwDRJtEgE36rY7FJbJiQPPPRe314z0NH3LYM9LofVhkn3mUqxJq1N0tM4Gw8U4w5rkUAeQ4tmDDglQj+5kD65nIinZ27od9HP/WKJ3VavN+V0ygFAXuTJp/XOzVnNvp8MSBAV+Mc7xXJHTmUSHDYDMMluAfAvHfLOLTETTLpkVAPmosCAh0/dpNY3CnuEX2GcmDRcOC4GAodtd8y4zQLLuggezmtMBsauj+ePhC6Oi94uFv6opGtnN/NgdmCPnKyjreifjr29TYQFKsnU26EvyFlQcFgBSc3vLv4jyWApQi3VKLQaiWzQkEPLrrhejJqK3LoPbRQhWMzSF1kDomhTkK2S0FjVwQyfVnJ9d0BwpYVP7PxrnfdCxEUER9rBJtR7ZVoNGQAAaLzWEuqVlklFX2Pcs6R69njgfUB9WBiesqjos5MdmT5957Fmsr6berk7UyF7o9PSdBjEz9WlepenzInpb0aP0z76vS/jJWKg+qdj8xjlMBjt9v+OhJaS/8FKs5h0HCavzApicS71wAEyUm9W75kGNTQKAWqWDmfGzwTFm7Te1C3qnZ7hEBwWpVdplzr3bE6/oI4RFDhSz9TZwNwIIGGTDjseRo5S0BnFWCW2hgvwrA31olbhhHWa122eBeH0MLtQbWh+GwmA1hBNG9Ml1ntWSW4O4iChTq54rKiUrI3h390o2vrDnQh9K4PBLtQKPv5OrncyFOTO5Nfhmevmnh7xVpwhGU5Wd8bAW7dN6i9+HhSmw9YboKykjSdHUsq1FVmT3nFjP3oac7QhUWrmHbnbOrjwZqmi9t8wCH2WyWvQSKZdWyG7QkGbpxDDWmmZt9uTdUGZNiXuh+dXUXKHDN5nStevjMSVskMb6rJisYjXqAFvyy7dRhhtdZn16q/FHAwnzgdyv5GVa0pOLs0ayEBvJSjVnqTylW1uFjmNcZoUUVqLnjFvmDlAmT84msT7e16wX91QaysLZUSG6si+LP8BTCd9huBeFsqRe+6YX846RWFO+OjduhBU6QTVCUcXMDmuQqRPsBrfmFlUaks2lwR7LpWtKcuV5c+SGYg6XiVuQh2HztUWt42yhSevyJNCC2nSq58XiA9JFEmqrYzO9qbmB3sgqO7hx3eyEOLipYSGOh6F27krgf6AHg/Qnx5jLjqfD2C2sym4jD621cCgbyUjCamjR45PO3Ow9tgLZ1JJrrARAJtt+QJSTdGjC2I0CmjeXGlwS4leR3sYn8Q69dZKu1hVfkBpdat5kXWpq3rqk5pETGe6wS2oCtUVyEwU+juU52nQmDOQZ+I+mZDEC3VrjYpuap2qDfEICWqzmFXZvezJHUILTMfO0h9eczvRqhJfmn1IedER61aLzocaKDpKthqaxi9qAtkixSTA1uA263iaDYv2M/pyRVOFoAcs0maxBbA2jVltFYXBqjlkHvXcRnFaqroJyhx6bJWZomQ7cvC3Wi0t9XgoLREGjzn1Ipkw49UzcHFncs+tdpBBnk73VrI4i2IIvXNysjuaNzRtkzdWaJKE1zO7namiy2E8eUirIiwyy1tzaWB9jncBac7TmjWJvmOOcJNJFE+NcrXajITf+HF5gHZUEljcNcK/ZJstvteAT3JifLloNFW5PxPRGBlOLrs4z+yQrzCbT8kyRdKCJpbnDYEaIZM7ZItwGN/BMnrWkEo4PbLTMGedbVzzwkunYmrW8szbgdax3RDOsb07Cs4Ssl4V/+9BfaOLrKGMxSzyghUpVuDi4Tt3Sszqh5A/Na3iQjeO+siuti1WJV6tnsRMmvh1JOZTr7V9cAz3b34h3QQUr78+VcvGp3X0/E5XP8ZcJvHjCctxKJNcMrYz1NSZcs74abPYzi3XRIzjWYQIbb9FFo1UcueTWOr6sidxRsVEL7nuU63qUdRhB89IFqHx2MZJZ9nE/EcPma6usu4lUG/9mFWsTqCYg3h9l2sVDUGmpVHYHJwlMjEuL1dqglhZ4nk1R39rGcWOqmzZyoGmQxLdG9YpKw9SrKHglkDoz8mNDCucwxTq0J2JqBijiNoTuWh+E6C1+5Gdfju9/PQI67dRD7d/WDf4mRkbLGgBD0iLtzVtgfjPsoy9TtqWwy1jxmxvquUn9b1/+GL07CJN/h9V3FzbHCq7aLJSz/MCAxrQNcBUkQbRaeHR6v7kBk7kpqxu+d5HiDR1lfqWLzotAJbVCGx49HtVvhuKQ611ppABfkIUuZLSBBjrsZqSeI472DErbgyXxZQNuZenZLL2pveker+2zbmxP7IbIF9hYMlGpwmxmv9/Yhx4TcC1a9NYNKNdAU2swNLP2MN34K+SBwcyiGZ2bHSbWHkzN3TnbU0dzIhEni7T0Wr4k/DVpipib3cqH42ypewWSTYJEp32P5LjaZT55EU+3OVf+4QjtGu4oo++Cw6FizQ+Cybo5zI3+QFU5Mkjud7tMb+WAK8Rg9C7hrc7+iuU8pDTH/NIXBHwpuWer0/2Is+iI9iA/+DKBDxW4Ff0w/Tr/NkukWFNu8Df8sFsfpdI8dqApsszMbMqNEE22hNT6t35Y3Wi232cC+LvaWt+wW214KbqciMCxM3cE/W57fMGqdsDcTxL1fbuI50aqqyqLe+um/yqKqdW47I11Y3g5W/remSkrmrPOMDq2RcZVaRvJrbEVay0mVWo6TvWo80NM2tvinR67Esy+iW8Zeg2vlY+Qi3K4yTes+oeUMA3MK9pFzezP2de3z5LR3tx6dM+ajKmzL8vKp+LqLkqJaGrokAZsVEecwa4QDRELa74q6xVGY95F5IWdCq/wfe30kqikeJoV7fX8hUpvEflf/cMGdbWBbjQAmAkFV/iSskQ5IPgOg2agaUKu3TJBqkHoGTEZYYJymwU1XGhuNyBCTwN9KwyFStKMCI1Gu72NnZqVrRR7HavqpUpsHBvLJQriyVoav+K/c2I3aHAN6UZzNquQ5xdx7sBwTFdM0TG4C1s7goBAcr+zGxq8DY4AshvE1qN6SBdudYQp2DSyOMJ37FzwZiE2osDoUF3CQYNkoARwS0uUGdtOTDpL6bIJixZ5+ywhXsBbBuJXD89KBIcj4d3jpI0LtXM0rILJcQRG6G3vv5GGtBpIdrUwW+hqkGREQ1cE9Hj2QVdUalasd5uoplgi+KVRePIAJqbpbXZMZ0RkPVpe88jVM2XJFvYoUb9cADk1WQqrrbk6t/E+pOxg/8lK+3Ov7zM4OzIh+rW2IcwbwNbEkRhtcBOk1im7YeEj6n3GAmbL3uRJtLhxhy8uZU5+DTLlVWRaNI1kshUxx95Eaw5h5utccwVSh2j/9tET1ZS8/5Cnsw3Rkbu8HZI6hk+DNjsaQI1orkBc20iYecB61BtnPiW9zVE8LZVZp1KiooMsmy3K7vJUnYf+Q0VkcXFhbnHpLWngMErvygbjcwLksKKT6mdQvC+bjqrctFotVqLGwgAzaxjcKDccGlRmH40ohzmXYtqC6hFlXalRM6vCV4cAwvu4h7B1tGT8pDLX1qOIyYw7gtwZb+RKIeGe0XFk9TvP5SP88Y68u2aTgre2SaEqLFWuGvFNnVsfr628NbibFgOXAJ3Xne10lmYLDYlIlQE62vrCkpUbprj6bWWziU2SFSUobBfDCRbj1+Q9hgueeR0obW7eJh/edcKpypAXknDPD1k7O01hgkituq8pZhXYCP4xAl57AkXmhRV2pEXVDxZ5tDgTFiv02/KAjyX1wylZVsdMHNr4jR/KIb5TjN1risWfs912/d9ouFM3zlVuS91Ha7jT2lps4ruQJr65RvzEbtC8NW/4b1+T25Mbzd+ushflM/YOgFccsywpv1NAAVdtE/m2ofxFomNaHenCXVZ7sfFDWya/Pea13VpCQ3a2zbrb5MyyH/TIqipz8zqQSKS6DYclsDOJ7RLMubrxNgz/NyQGF8Wrrqdh9td0td7w914UWCMsvV3H/Oitbu0aO2RB9ihelq95A2+7npfpCaTj6hRfzWdwt9z5XRXmAPXv+MQXVmKmA04pGEUSURrE+caNZLC+9R46nry3JOaLRLOLGBCeipRvTejejo2dypwHXebXD3QssbpV5deZQn04fw5FTydzqo+B70HicRs1CMhnEMdezcOaz0z3PA2LnqrWIgJQf79nF1/zbyrmD03+DypcKNdGB0ezPsvmWrKgSk0CUwsM5L6DpthvclU116s0Cl9Oh2jkWSvDElqENj17X0bZog/Chd4A9PSBtHIkOwlvo3Ksk6sp36CyJL56VeeK5vSgaXatzhql3hJLBuhSWzCOxqq7kR4cUGZzPQZm/IJDYoa5FLW1Uz94sfdmKQyChVgYifwMymh2KErrvBEy9tHmcfQl7cGMHHTT/j2r2riow3tTv1nSmWqP2XU0u96vromPhONFo+kiGR8CNg1ZsDRaIUYiaMOkFW5AwNyxeJuyEV9En6VuQmtNRFsbBMO/D7NqSDi6ta8ugOayOiZZwHW2p7SxGewo0/bm3RgDN3XeUPGK23We0owBtJoppYk9maqoZ9WhiTh6uPA+wfBVwb/+8GhZ+VWtRdaycoADvZs9E27l03dRkdTV7HYFDkeHKvTRkzR7Y8wdFJK4jw3GXAfdB87nhAyCh07ps2UqIPUgptBgnYb0VYnDZdXZHjP8IWOe0sjhaW5+A2iNEd7ADp3t7Brin82ka1Y4dfHLbhB+mTG9LtEjZviziUqJ4IWobF9FgMfCtY8fdscDyQlmMP7kOL9zIz53uPpsZvvTsEfE+hr8mDr7U0PePbrS3mG/kwabb03bRuZ77vFU6nJLcXJhQeCXr6XkM/g5KCfD2yRl3qS2xVbDjI8fWvX1uIwZrrhj+bTE/te7NSEgKzlVE1OAq4jkOwRXBclHkuMHNuaXiw9NhyVxUa5AYo8GL312IVC249hcV8zP4jhh4+7l4qSa7YEHW8dIzdJW1T3r2lYc+dlB57nfmQoe/YPjHJurtYCvZjnlxPhHQhQzQaaxpPgQldA7+fVHLfSchr1RxZYwQ9TWqVeB0zex4GfxaP3oMM8VNuxZliwBrhSOyNvpDaRLRVSfSaILM8YTnU15SDv4ciE9Iiwd/yWv8qXcGHh1sBuswNMIrbaW5fBNLehATO26j+6ecXSIw25o2jkp6TjSTzbIfXJF/3REgzsjg7JjfckrycrbDhjko3DxEFXfMenRFEaFN0g7BrbeXe1V9rbKD/tOvt9NNAI/KaOZmV1C1B5zj1gD6DKQvTXAG2QdvTnv1rIKw83MN9A5XWLm0Mwck4PS+EK7NfI6ftboIKE2WKjUNNhClpEW5EKlCzp3vrAbmJ1nXcYDLxVXm7fKyLd94WteI68D+O/rKXbRkV1GNVN5rpsgi4+jju8WpgfH5ktHd1/RxAtEnTPnU2YW5oS4GlhyUT9m08aZDLlygje2KnBxeu3/inc5+0ZOSrbCi1ZbT/Jwn9ccbHsOJctrSGZ+I3nts+jdcppmc6rSLGnl3K8WMEuGS20DqPc+SvWDYztcXnOmPGhMvd7r5G2Z8FkPLhndflR0VEtXF2QmH0OlrgZCb9oQN6ELPbzqHRl0cm63Q17HD+JbPI107Vla3lLtGJ4Z7KjkTTPaqxp3LV8vdT+Hljir15H25tyqTfaoU9rQSnTYKw7G7uvAQEjbDytD1GK5wxoZZJalVqJ4f5WydifgxErX47U/zeKlXPSfr+m+WKCH3jICKxvUcliG1fGDGpE/D8x/+6tjio4ff1T+yRGuPFL/fpxDR3yqc90vHujBGNV/VkYPgm/q4QuFt3b8VSlvZ93H/Hu9Nz/RVh6yfaWYF+VzbWe/2PeaMflD54Ute7vKaP2wzGh/MVt3Mti+hmcYKt//pkIMZ9LwswZH3YPGvzjKDp/dr15kz/qfXNCtZNi+yECbALSmvySshaXC9SronQOgP64Jq/nXVPsFooOFSuCnsY7R3d5KSjAlzmYOhFauOhfrNPw3dMdpblB4Ku3nl3PKaBlaY+vorXewdw/MvPXeR7s39t5F9o4fTpF4TnREsmoooH+vcVMmAD2Arj59VTGScpO1ShzlRKbfgpDMctHXEHV0AUmAEwJ79STyyBMcMxIkB7/BGiSisYdeyuqIupRurVm31kA3GLqRaIae5Srm2Zj2F4y1r6DkwLDt53KkI8O8hWo7cbtnvSiOWef8BZKD2RhRLxLKeqGN9eWPtiIK7SVuiH8S6/CQ0S+zlKQfrTn4RsUzDY/XMe/8D8qObKH7Kubdmdjzr8hoq6WZP7+iNwOijQr7/ieGehSkj67or2XjexAp/AVJko0lXkpGT7FmI/SzNS77nXKFrdI9v8BAVy+lbTmzdLsha/ktizrtj/4KA73VHXPm/qsFmtR+b9LHLJR24uVQXS/93oObU791pL0u6leT0bDOblLrQGcfLSuiDdtvkyBbNvRryeigp28SYIrfNAhi0H+x82j9FRJoeAnG/X4Phr1x0fu+QALNW8v8b7x+XnSIwO8Imbz/0bR7iS9g3dkfHOZs1x2P9wIu+N9M2Q3CsmGp+qtZHX9uqF/Ojv6LMppbKPZFEmgMf/pleIWUsIUMXKbV87fKFnVLd9b5WsBvv/L+Bl8cG18MPH/GF1si8QXs6JTRkvleOZsVmUDwPBaGy9+wyk0aq+QVYNIoMk29IfbSnNswOrbTAbi5wc0b3dx+QbBrLWd/gRLlnTKCgPXm5rOzrk+N2QS4Bcu0/Y6sXYzop/VXiYLvKyF62ip64QJ0DG5jD17X35JMWm/zBVzw4ToV+9N3zLxYgeZB963fYA+ael/cfK3/cJJjB9Bih210Axom3+D4Tl6D4CH+DTZf88jZzYY3eoEkx357BzrKl99jVFON3YRgcPyTJauvJD1C6+hF7Oi/6YEviZxWx0/SseGoC//Oy4+m3o8iwpNe/w+u6NqI7adldNgPfrHK/8CKJhc307+X0OS2bJCOhr2TFH9rZOCMR/8k2a7IsqIjmfSpZtG/wcArP38e6+gHGT14llW4B/k786XdSuOtH7ejtcnoaP0z2/HyN49ziOkXwjrKimZp7BNcgH30DPqd3krpQ/DzVoeWxUkQpuhQ0ThENul37Ksv/ypr5KdldJAx2rKppRAV0QQwkDp9Pe/+fy6jfz442wlkY05p+7GozvpvTP/Y3LCftqOjZ8YfzTboOMjoH92V/LNYB2qu0muEsv7kivbNbWkvdU9/6mXeWuOryOgAla7aVD/eA4OnOWjoz//DsUnkePt8fB6RfUXG/y5Otj4aH5df5/nLGSJFYrFI/2zMsGWzXZ+qugz6iT3exxF1YpL8f1lVMy/EN6G0mNERWSI+jtqueTTR4JPjydxwPtR3wuJ1sj7yfzqs//xAK6OwOJDAF/r3xceG2VchGsNlv+9VBKo8Zv6tleCkA04V67FulCO9zerVskryBqE9uM4Zdv7qFC9MZvtXGeiCYxz7D1ZZoZ0G6NRYKIdYW46CRgv2OZoajP0Hccmj7TW7+BUGouwCUttsnPIyD2143PoY6J9PCSs3KIj9grWbqxffPrybyIgmCKx9cdrqsn1s2bkl8AloM8vPDaXvJA7ZgADYG+DWDVFCHZdU2Y+ECDc3exkX/LRHy+jvsPRSQKtjL6HtKHZwjc3oJIetj+Pc8lCZUZVUkabSKVLM0817SjqqpsniyWRQyk0lCqbW1/78eRn9wV7RPxB34dYW9OJmbj7sL5F790TrmEci57/G4vToZvRQGb2GjP7zr/b/6WF/cjX9PKj0/+HFVwll/fVRVpp3hwZ0E4TIBq3LOFwdwS72QTElWe2mC296NtD7/yK3lozmaBQ/WxBnI8akemBWN8+ejtzcIdaW8uuLozljtXbJvc/xhQ3CclS+cWusPG/WfPKoz6xr8ymo9QBiO2Iy52aBQUtR2pY+sDsvd8HDDzV6zh4RpHlbV7vywRlPfRNZ/BGuZpVaPe+LmZxoy8Qz7o19qjmsR/izdqviSW5KW8vbaFvEhcFMEKhCCOHGrZvYLM3aWenQ/12b2TqvMtzCyaIyHciML64+8rp0HRQ9mQJiGqhobe00mxIq3c0AkpiXZW7neEuleWi2Vs1tPLu3QpyISZvzKBVM5wC5KHEwSOSU3bPkj+U4rTEqDa22fUAtzEG7TCj7alLfrUbHOUrT946uyyzKYNt35XbE6LMao5c7LoXSWJxx0JhNZpvJ+Pb6kedacHRUyErlXrW2R7U65hbPdl5lEY7ZGx27c5jH8+aIT+BsVOWe2hQKqw2yRmMKlc7IOqlRaO1QZQ/1CdxlU4vse8GtTeRCK4nVpTewHy0EqjxnTlqi9zGGsbiig7YGWRyLMIk2uVOLiVQ2zl2xgc2O7jhtcubSnL1BZxO0FZwY9z6jF3NhhZCRNPekJntSrhue4SQwpUpu2uzEOfCaUkk053me9yiCaj/VnOopcRKKnveb6zFVQaqYtsyE7NacY8gGkI1saOQY8wlhTZOLo06oFDrNBTo2Z+LoY3RGw9VsVYwCnEtjUsWFBYNrCbJqmyJpUVXNajOtxNLXzK9hYg4dF4a3FRSVfZH9USd6z9kyVZsqH+s49cuUVz4E9IpOcAh7OEjnaJWMbHKdcqkIkVHHzjm/XFKTazgx9/msxc4JWFZAlWkzDpE7G6phJ/EIKg95v8Y/JQKXNM1W93OZsG6+MrYb53tuhrzAvLEDDJuCUTVmCEbWiasDcK+ybbTLhTm6ZFDXUgdDmqc2WJ6htkbjqYmHHGQKqWm41V0/5m0huqPnZiqykji3TpnrMmeCyw8aaglrVFPtgVOsaw8DFPvkIlwyFSgLlH+ZyzdWwVSKaXEZCNAaug9VELrIamr36FOxejmzxOEaL9FKrrbvqdvWQtr9Oc3x0d4bnmWXbnPIIhhXWt2ME6b43uLPU0SXlba1NEYZvZMXtD8kH0LOS0aWuK+P6LGabdiBqwnmJGEkbToUNRi5HJYrPnLV8MOdA3Dhc3/IMbk9bL+Ld57rY0BbbRse66sHzcIa/KlXU7U7THSbSms4MmNX+gzOtsv9s79zPwI4NzZ/yuUr2+vxgNfpvJ/0rxrn26U1dSeF2s+9DtiV70pHG2nIPPv9u6W0Wwm7Y6EJPhGbbrwQMTNGMS/BmwjA3q9+hXC/Z5x5eK7K4ql18+PvPhlaNM05UVo2/zo6NeZYzIkS7SKWS2c31KYtrFPBw8TwOGHckSc+Dess9xFbhPnrgzR1OXALtStdG4WvMfRDKnDOaQnLVjio5Jl+zPYK9SEzZ6j+r6Qj+TGbyG0S0hzfHcfVI+o/zGyj+bebvy8n7emXx7PA+v+q7v8bMJr8d06ZHdNdZnxfZ7H2bE85M//fcL47kHRwTR9ArV91E9p+8pstuCfv58u+QUH4vwEA5HQs+uOMMP8AAAAASUVORK5CYII=" />
</div>
<p class="paragraph">
Рис. 17.2. Qt Linguist в действии. </p>
<p class="paragraph">
Если мы хотим заново сгенерировать файлы .qm для всех файлов .ts, мы можем запустить утилиту lrelease из командной строки следующим образом: </p>
<p class="paragraph">
lrelease -verbose spreadsheet.pro </p>
<p class="paragraph">
Если мы выполняли перевод 19 строк на французский язык и отметили флажком Done 17 из них, утилита lrelease выдаст следующий результат: </p>
<p class="paragraph">
Updating 'spreadsheet_de.qm'... </p>
<p class="paragraph">
Generated 0 translations (0 finished and 0 unfinished) </p>
<p class="paragraph">
Ignored 98 untranslated source texts </p>
<p class="paragraph">
Updating 'spreadsheet_fr.qm"... </p>
<p class="paragraph">
Generated 19 translations (17 finished and 2 unfinished) </p>
<p class="paragraph">
Ignored 79 untranslated source texts </p>
<p class="paragraph">
Флажок Done игнорируется утилитой lrelease; он может использоваться переводчиками для идентификации законченных переводов и тех, перевод которых необходимо выполнить заново. Непереведенные строки при выполнении приложения выводятся на языке оригинала. </p>
<p class="paragraph">
Когда мы модифицируем исходный код приложения, файлы перевода могут устареть. Решение этой проблемы заключается в повторном выполнении утилиты lupdate, обеспечении перевода новых строк и повторной генерации файлов .qm. Одни группы разработчиков могут посчитать удобным частое выполнение утилиты lupdate, а другие могут захотеть это делать только для почти готового программного продукта. </p>
<p class="paragraph">
Утилиты lupdate и Qt Linguist достаточно «умные». Переводы, которые с какого-то момента не стали использоваться, сохраняются в файлах .ts на случай, если они потребуются когда-нибудь в будущем. При обновлении файлов .ts утилита lupdate использует «интеллектуальный» алгоритм слияния, позволяющий переводчикам сэкономить много времени при работе с текстом, который совпадает или подобен в различных контекстах. </p>
<p class="paragraph">
Более подробную информацию относительно Qt Linguist, lupdate и lrelease можно найти в руководстве по Qt Linguist в сети Интернет по адресу . Это руководство содержит полное описание интерфейса пользователя для Qt Linguist и учебное пособие для поэтапного обучения программистов. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Глава 18. Многопоточная обработка</p>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<div>
<img src="data:image/jpg;base64,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" />
</div>
<p class="paragraph">
Обычные приложения с графическим интерфейсом имеют один поток (thread) выполнения и производят в каждый момент времени одну операцию. Если пользователь через интерфейс пользователя вызывает продолжительную операцию, интерфейс, как правило, «застывает» до завершения операции. В («Обработка событий») даются некоторые способы решения этой проблемы. Применение многопоточной обработки — еще один способ решения данной проблемы. </p>
<p class="paragraph">
В многопоточном приложении графический пользовательский интерфейс выполняется в своем собственном потоке, а обработка осуществляется в одном или в нескольких других потоках. В результате такие приложения способны реагировать на действия пользователя даже при продолжительной обработке. Еще одним преимуществом многопоточной обработки является возможность в многопроцессорных системах одновременно выполнять несколько потоков на разных процессорах, увеличивая производительность. </p>
<p class="paragraph">
В данной главе мы сначала продемонстрируем способы создания подкласса QThread и способы применения классов QMutex, QSemaphore и QWaitCondition для синхронизации потоков. Затем мы рассмотрим способы взаимодействия вторичных потоков с главным потоком в ходе цикла обработки событий. Наконец, мы завершим главу обзором классов Qt, объясняя, какие из них могут использоваться во вторичных потоках. </p>
<p class="paragraph">
Многопоточная обработка представляет собой обширную тему, которой посвящается много книг. В данной главе предполагается, что вам уже известны принципы многопоточного программирования, поэтому основное внимание уделяется методам разработки многопоточных приложений средствами Qt, а не теме потоков выполнения в целом. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Создание потоков</p>
<p class="paragraph">
Обеспечить многопоточную обработку в приложении Qt достаточно просто: мы только создаем подкласс QThread и переопределяем его функцию run(). Чтобы показать, как это работает, мы начнем с рассмотрения программного кода очень простого подкласса QThread, который периодически выводит на консоль заданный текст: </p>
<p class="paragraph">
01 class Thread : public QThread </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 Q_OBJECT </p>
<p class="paragraph">
04 public: </p>
<p class="paragraph">
05 Thread(); </p>
<p class="paragraph">
06 void setMessage(const QString &message); </p>
<p class="paragraph">
07 void stop(); </p>
<p class="paragraph">
08 protected: </p>
<p class="paragraph">
09 void run(); </p>
<p class="paragraph">
10 private: </p>
<p class="paragraph">
11 QString messageStr; </p>
<p class="paragraph">
12 volatile bool stopped; </p>
<p class="paragraph">
12 }; </p>
<p class="paragraph">
Класс Thread наследует QThread и переопределяет функцию run(). Он содержит две дополнительные функции: setMessage() и stop(). </p>
<p class="paragraph">
Переменная stopped объявляется со спецификатором volatile (изменчивый), поскольку доступ к ней осуществляется из разных потоков, и мы хотим быть уверенными, что всегда получаем ее обновленное значение. Если мы опустим ключевое слово volatile, компилятор может оптимизировать доступ к этой переменной, что, возможно, приведет к получению неправильного результата. </p>
<p class="paragraph">
01 Thread::Thread() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 stopped = false; </p>
<p class="paragraph">
04 } </p>
<p class="paragraph">
Мы устанавливаем в конструкторе переменную stopped на значение false. </p>
<p class="paragraph">
01 void Thread::run() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 while (!stopped) </p>
<p class="paragraph">
04 cerr << qPrintable(messageStr); </p>
<p class="paragraph">
05 stopped = false; </p>
<p class="paragraph">
06 cerr << endl; </p>
<p class="paragraph">
07 } </p>
<p class="paragraph">
Функция run() вызывается для запуска потока. Пока переменная stopped имеет значение false, эта функция будет выводить на консоль заданное сообщение. Работа потока завершается, когда завершается функция run(). </p>
<p class="paragraph">
01 void Thread::stop() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 stopped = true; </p>
<p class="paragraph">
04 } </p>
<p class="paragraph">
Функция stop() устанавливает переменную stopped на значение true, тем самым указывая функции run() на необходимость прекращения вывода текстовых сообщений на консоль. Данная функция может вызываться из любого потока в любое время. В нашем примере мы предполагаем, что присваивание значения переменной типа bool является атомарной операцией. Такое предположение является разумным, учитывая, что переменная типа bool может иметь только два состояния. Позже мы рассмотрим в данном разделе способы применения класса QMutex, гарантирующего атомарность операции присваивания значения переменной. </p>
<p class="paragraph">
Класс QThread содержит функцию terminate(), которая прекращает выполнение потока, если он все еще не завершен. Функцию terminate() не рекомендуется применять, поскольку она может остановить поток в произвольной точке и не позволяет потоку выполнить очистку после себя. Всегда надежнее использовать переменную stopped и функцию stop(), как мы уже делали здесь. </p>
<div>
<img src="data:image/jpg;base64,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" />
</div>
<p class="paragraph">
Рис. 18.1. Приложение Threads. </p>
<p class="paragraph">
Теперь мы рассмотрим способы применения класса Thread в небольшом приложении Qt, которое применяет два потока, А и В, не считая главный поток. </p>
<p class="paragraph">
01 class ThreadDialog : public QDialog </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 Q_OBJECT </p>
<p class="paragraph">
04 public: </p>
<p class="paragraph">
05 ThreadDialog(QWidget *parent = 0); </p>
<p class="paragraph">
06 protected: </p>
<p class="paragraph">
07 void closeEvent(QCloseEvent *event); </p>
<p class="paragraph">
08 private slots: </p>
<p class="paragraph">
09 void startOrStopThreadA(); </p>
<p class="paragraph">
10 void startOrStopThreadB(); </p>
<p class="paragraph">
11 private: </p>
<p class="paragraph">
12 Thread threadA; </p>
<p class="paragraph">
13 Thread threadB; </p>
<p class="paragraph">
14 QPushButton *threadAButton; </p>
<p class="paragraph">
15 QPushButton *threadBButton; </p>
<p class="paragraph">
16 QPushButton *quitButton; </p>
<p class="paragraph">
17 }; </p>
<p class="paragraph">
В классе ThreadDialog объявляются две переменные типа Thread и несколько кнопок для обеспечения основных средств интерфейса пользователя. </p>
<p class="paragraph">
01 ThreadDialog::ThreadDialog(QWidget *parent) </p>
<p class="paragraph">
02 : QDialog(parent) </p>
<p class="paragraph">
03 { </p>
<p class="paragraph">
04 threadA.setMessage("А"); </p>
<p class="paragraph">
05 threadB.setMessage("B"); </p>
<p class="paragraph">
06 threadAButton = new QPushButton(tr("Start А")); </p>
<p class="paragraph">
07 threadBButton = new QPushButton(tr("Start В")); </p>
<p class="paragraph">
08 quitButton = new QPushButton(tr("Quit")); </p>
<p class="paragraph">
09 quitButton->setDefault(true); </p>
<p class="paragraph">
10 connect(threadAButton, SIGNAL(clicked()), </p>
<p class="paragraph">
11 this, SLOT(startOrStopThreadA())); </p>
<p class="paragraph">
12 connect(threadBButton, SIGNAL(clicked()), </p>
<p class="paragraph">
13 this, SLOT(startOrStopThreadB())); </p>
<p class="paragraph">
14 … </p>
<p class="paragraph">
15 } </p>
<p class="paragraph">
В конструкторе мы вызываем функцию setMessage() для периодического вывода на экран первым потоком буквы «А» и вторым потоком буквы «В». </p>
<p class="paragraph">
01 void ThreadDialog::startOrStopThreadA() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 if (threadA.isRunning()) { </p>
<p class="paragraph">
04 threadA.stop(); </p>
<p class="paragraph">
05 threadAButton->setText(tr("Start А")); </p>
<p class="paragraph">
06 } else { </p>
<p class="paragraph">
07 threadA.start(); </p>
<p class="paragraph">
08 threadAButton->setText(tr("Stop А")); </p>
<p class="paragraph">
09 } </p>
<p class="paragraph">
10 } </p>
<p class="paragraph">
Когда пользователь нажимает кнопку потока А, функция startOrStopThreadA() останавливает поток, если он выполняется, и запускает его в противном случае. Она также обновляет текст кнопки. </p>
<p class="paragraph">
01 void ThreadDialog::startOrStopThreadB() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 if (threadB.isRunning()) { </p>
<p class="paragraph">
04 threadB.stop(); </p>
<p class="paragraph">
05 threadBButton->setText(tr("Start В")); </p>
<p class="paragraph">
06 } else { </p>
<p class="paragraph">
07 threadB.start(); </p>
<p class="paragraph">
08 threadBButton->setText(tr("Stop В")); </p>
<p class="paragraph">
09 } </p>
<p class="paragraph">
10 } </p>
<p class="paragraph">
Программный код функции startOrStopThreadB() очень похож. </p>
<p class="paragraph">
01 void ThreadDialog::closeEvent(QCloseEvent *event) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 threadA.stop(); </p>
<p class="paragraph">
04 threadB.stop(); </p>
<p class="paragraph">
05 threadA.wait(); </p>
<p class="paragraph">
06 threadB.wait(); </p>
<p class="paragraph">
07 event->accept(); </p>
<p class="paragraph">
08 } </p>
<p class="paragraph">
Если пользователь выбирает пункт меню Quit или закрывает окно, мы даем команду останова для каждого выполняющегося потока и ожидаем их завершения (используя функцию QThread::wait()) прежде, чем сделать вызов CloseEvent::accept(). Это обеспечивает аккуратный выход из приложения, хотя в данном случае это не имеет значения. </p>
<p class="paragraph">
Если при выполнении приложения вы нажмете кнопку Start А, консоль заполнится буквами «А». Если вы нажмете кнопку Start В, консоль заполнится попеременно последовательностями букв «А» и «В». Нажмите кнопку Stop А, и тогда на экран будет выводиться только последовательность букв «В». </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Синхронизация потоков</p>
<p class="paragraph">
Обычным требованием для многопоточных приложений является синхронизация работы нескольких потоков. Для этого в Qt предусмотрены следующие классы: QMutex, QReadWriteLock, QSemaphore и QWaitCondition. </p>
<p class="paragraph">
Класс QMutex обеспечивает такую защиту переменной или участка программного кода, что доступ к ним в каждый момент времени может осуществлять только один поток. Этот класс содержит функцию lock(), которая закрывает мьютекс (mutex). Если мьютекс открыт, текущий поток захватывает его и немедленно закрывает; в противном случае работа текущего потока блокируется до тех пор, пока захвативший мьютекс поток не освободит его. В любом случае после вызова lock() текущий поток будет держать мьютекс до вызова им функции unlock(). Класс QMutex содержит также функцию tryLock(), которая сразу же возвращает управление, если мьютекс уже закрыт. </p>
<p class="paragraph">
Предположим, что нам нужно обеспечить защиту переменной stopped класса Thread из предыдущего раздела с помощью QMutex. Тогда мы бы добавили к классу Thread следующую переменную—член: </p>
<p class="paragraph">
private: </p>
<p class="paragraph">
QMutex mutex; </p>
<p class="paragraph">
… </p>
<p class="paragraph">
}; </p>
<p class="paragraph">
Функция run() изменилась бы следующим образом: </p>
<p class="paragraph">
01 void Thread::run() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 forever { </p>
<p class="paragraph">
04 mutex.lock(); </p>
<p class="paragraph">
05 if (stopped) { </p>
<p class="paragraph">
06 stopped = false; </p>
<p class="paragraph">
07 mutex.unlock(); </p>
<p class="paragraph">
08 break; </p>
<p class="paragraph">
09 } </p>
<p class="paragraph">
10 mutex.unlock(); </p>
<p class="paragraph">
11 cerr << qPrintable(messageStr.ascii); </p>
<p class="paragraph">
12 } </p>
<p class="paragraph">
13 cerr << endl; </p>
<p class="paragraph">
14 } </p>
<p class="paragraph">
Функция stop() стала бы такой: </p>
<p class="paragraph">
01 void Thread::stop() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 mutex.lock(); </p>
<p class="paragraph">
04 stopped = true; </p>
<p class="paragraph">
05 mutex.unlock(); </p>
<p class="paragraph">
06 } </p>
<p class="paragraph">
Блокировка и разблокировка мьютекса в сложных функциях или там, где обрабатываются исключения С++, может иметь ошибки. Qt предлагает удобный класс QMutexLocker, упрощающий обработку мьютексов. Конструктор QMutexLocker принимает в качестве аргумента объект QMutex и блокирует его. Деструктор QMutexLocker разблокирует мьютекс. Например, мы могли бы приведенные выше функции run() и stop() переписать следующим образом: </p>
<p class="paragraph">
01 void Thread::run() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 forever { </p>
<p class="paragraph">
04 { </p>
<p class="paragraph">
05 QMutexLocker locker(&mutex); </p>
<p class="paragraph">
06 if (stopped) { </p>
<p class="paragraph">
07 stopped = false; </p>
<p class="paragraph">
08 break; </p>
<p class="paragraph">
09 } </p>
<p class="paragraph">
10 } </p>
<p class="paragraph">
11 cerr << qPrintable(messageStr); </p>
<p class="paragraph">
12 } </p>
<p class="paragraph">
13 cerr << endl; </p>
<p class="paragraph">
14 } </p>
<p class="paragraph">
15 void Thread::stop() </p>
<p class="paragraph">
16 { </p>
<p class="paragraph">
17 QMutexLocker locker(&mutex); </p>
<p class="paragraph">
18 stopped = true; </p>
<p class="paragraph">
18 } </p>
<p class="paragraph">
Одна из проблем применения мьютексов возникает из-за доступности переменной только для одного потока. В программах со многими потоками, пытающимися одновременно читать одну и ту же переменную (не модифицируя ее), мьютекс может серьезно снижать производительность. В этих случаях мы можем использовать QReadWriteLock — класс синхронизации, допускающий одновременный доступ для чтения без снижения производительности. </p>
<p class="paragraph">
В классе Thread не имеет смысла заменять мьютекс QMutex блокировкой QReadWriteLock для защиты переменной stopped, потому что в лучшем случае только один поток может пытаться читать эту переменную в любой момент времени. Более подходящий пример мог бы состоять из одного или нескольких считывающих потоков, получающих доступ к некоторым совместно используемым данным, и одного или нескольких записывающих потоков, модифицирующих данные. Например: </p>
<p class="paragraph">
01 MyData data; </p>
<p class="paragraph">
02 QReadWriteLock lock; </p>
<p class="paragraph">
03 void ReaderThread::run() </p>
<p class="paragraph">
04 { </p>
<p class="paragraph">
05 … </p>
<p class="paragraph">
06 lock.lockForRead(); </p>
<p class="paragraph">
07 access_data_without_modifying_it(&data); </p>
<p class="paragraph">
08 lock.unlock(); </p>
<p class="paragraph">
09 … </p>
<p class="paragraph">
10 } </p>
<p class="paragraph">
11 void WriterThread::run() </p>
<p class="paragraph">
12 { </p>
<p class="paragraph">
13 … </p>
<p class="paragraph">
14 lock.lockForWrite(); </p>
<p class="paragraph">
15 modify_data(&data); </p>
<p class="paragraph">
16 lock.unlock(); </p>
<p class="paragraph">
17 … </p>
<p class="paragraph">
18 } </p>
<p class="paragraph">
Ради удобства мы можем использовать классы QReadLocker и QWriteLocker для блокировки и разблокировки объекта QReadWriteLock. </p>
<p class="paragraph">
Класс QSemaphore — это еще одно обобщение мьютекса, но, в отличие от блокировок чтения/записи, он может использоваться для контроля некоторого количества идентичных ресурсов. Следующие два фрагмента программного кода демонстрируют соответствие между QSemaphore и QMutex: </p>
<p class="paragraph">
• QSemaphore semaphore(1) — QMutex mutex, </p>
<p class="paragraph">
• Semaphore.acquire() — mutex.lock(), </p>
<p class="paragraph">
• Semaphore.release() — mutex.unlock(). </p>
<p class="paragraph">
Передавая 1 конструктору, мы указываем семафору на то, что он управляет работой одного ресурса. Преимущество применения семафора заключается в том, что мы можем передавать конструктору числа, отличные от 1, и затем вызывать функцию acquire() несколько раз для захвата многих ресурсов. </p>
<p class="paragraph">
Типичная область применения семафоров — это передача некоторого количества данных (DataSize) при совместном использовании циклического буфера определенного размера (BufferSize): </p>
<p class="paragraph">
const int DataSize = 100000; </p>
<p class="paragraph">
const int BufferSize = 4096; </p>
<p class="paragraph">
char buffer[BufferSize]; </p>
<p class="paragraph">
Поток, являющийся поставщиком данных, записывает данные в буфер, пока он не заполнится, и затем повторяет эту процедуру сначала, переписывая существующие данные. Поток, принимающий данные, считывает данные по мере их поступления. Это проиллюстрировано на рис. 18.2 для небольшого 16-байтового буфера. </p>
<div>
<img src="data:image/jpg;base64,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" />
</div>
<p class="paragraph">
Рис. 18.2. Модель взаимодействия двух потоков: формирующего и принимающего данные. </p>
<p class="paragraph">
Необходимость синхронизации для примера взаимодействия потоков, один из которых формирует данные, а другой их считывает, обусловлена двумя причинами: если формирующий данные поток работает слишком быстро, он станет переписывать данные, которые еще не считал поток—приемник; если поток—приемник считывает данные слишком быстро, он перегонит другой поток и станет считывать «мусор». </p>
<p class="paragraph">
Грубый способ решения этой проблемы состоит в том, чтобы сначала заполнить буфер и затем ждать, пока поток—приемник не считает буфер целиком и так далее. Однако в многопроцессорных системах это не позволит обоим потокам работать одновременно с разными частями буфера. </p>
<p class="paragraph">
Одни из эффективных способов решения этой проблемы заключается в использовании двух семафоров: </p>
<p class="paragraph">
QSemaphore freeSpace(BufferSize); </p>
<p class="paragraph">
QSemaphore usedSpace(0); </p>
<p class="paragraph">
Семафор freeSpace управляет той частью буфера, которая может заполняться потоком, формирующим данные. Семафор usedSpace управляет той областью, которую может считывать поток—приемник. Эти две области взаимно дополняют друг друга. Семафор freeSpace устанавливается на значение переменной BufferSize (4096), то есть он может захватывать именно такое количество ресурсов. Когда приложение запускается, поток, считывающий данные, начинает захватывать «свободные» байты и превращать их в «используемые» байты. Семафор usedSpace инициализируется нулевым значением, чтобы поток—приемник не мог считать «мусор» при запуске приложения. </p>
<p class="paragraph">
В этом примере каждый байт рассматривается как один ресурс. В реальном приложении мы, вероятно, использовали бы более крупные блоки памяти (например, по 64 или 256 байт) для снижения затрат, обусловленных применением семафоров. </p>
<p class="paragraph">
01 void Producer::run() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 for (int i = 0; i < DataSize; ++i) { </p>
<p class="paragraph">
04 freeSpace.acquire(); </p>
<p class="paragraph">
05 buffer[i % BufferSize] = "ACGT"[uint(rand()) % 4]; </p>
<p class="paragraph">
06 usedSpace.release(); </p>
<p class="paragraph">
07 } </p>
<p class="paragraph">
08 } </p>
<p class="paragraph">
Каждая итерация при работе потока, формирующего данные, начинается с захвата одного «свободного» байта. Если весь буфер заполнен данными, которые не считаны потоком—приемником, вызов функции acquire() заблокирует семафор до тех пор, пока поток—приемник не начнет считывать данные. Захватив байт, мы заполняем его некоторым случайным значением («А», «С», «G» или «T») и затем освобождаем байт и помечаем его как «использованный», тем самым указывая на возможность его считывания потоком—приемником. </p>
<p class="paragraph">
01 void Consumer::run() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 for (int i = 0; i < DataSize; ++i) { </p>
<p class="paragraph">
04 usedSpace.acquire(); </p>
<p class="paragraph">
05 cerr << buffer[i % BufferSize]; </p>
<p class="paragraph">
06 freeSpace.release(); </p>
<p class="paragraph">
07 } </p>
<p class="paragraph">
08 cerr << endl; </p>
<p class="paragraph">
09 } </p>
<p class="paragraph">
Работу потока—приемника мы начинаем с захвата одного «использованного» байта. Если буфер не содержит данных для чтения, вызов функции acquire() заблокирует семафор до тех пор, пока первый поток не сформирует какие-то данные. После захвата нами байта мы выводим его на экран и освобождаем байт, помечая его как «свободный», тем самым позволяя первому потоку вновь присвоить ему некоторое значение. </p>
<p class="paragraph">
01 int main() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 Producer producer; </p>
<p class="paragraph">
04 Consumer consumer; </p>
<p class="paragraph">
05 producer.start(); </p>
<p class="paragraph">
06 consumer.start(); </p>
<p class="paragraph">
07 producer.wait(); </p>
<p class="paragraph">
08 consumer.wait(); </p>
<p class="paragraph">
09 return 0; </p>
<p class="paragraph">
10 } </p>
<p class="paragraph">
Наконец, в функции main() мы запускаем оба потока. После этого происходит следующее: поток, формирующий данные, преобразует некоторое «свободное» пространство в «использованное», после чего поток—приемник может выполнить его обратное преобразование в «свободное» пространство. </p>
<p class="paragraph">
Когда программа выполняется, она выводит на консоль случайную последовательность из 100 000 букв «А», «С», «G» и «T» и затем завершает свою работу. Для того чтобы понять, что происходит на самом деле, мы можем отключить вывод указанной последовательности и вместо этого выводить на консоль букву «P» при генерации каждого байта первым потоком и букву «с» при чтении байта вторым потоком. И ради максимального упрощения ситуации мы можем использовать меньшие значения параметров DataSize и BufferSize. </p>
<p class="paragraph">
Например, при выполнении программы, когда DataSize равен 10 и BufferSize равен 4, результат может быть таким: «PcPcPcPcPcPcPcPcPcPc». В данном случае поток—приемник считывает байты сразу по мере их формирования первым потоком; оба потока работают на одной скорости. В другом случае первый поток может заполнять буфер целиком еще до начала его считывания вторым потоком: «PPPPccccPPPPccccPPcc». Существует много других вариантов. Семафоры дают большую свободу действий планировщикам потоков в специфических системах, что позволяет им, изучив поведение потоков, выбрать подходящую политику планирования их работы. </p>
<p class="paragraph">
Другой подход к решению проблемы синхронизации работы потока, формирующего данные, и потока, принимающего данные, состоит в применении классов QWaitCondition и QMutex. Класс QWaitCondition позволяет одному потоку «пробуждать» другие потоки, когда удовлетворяется некоторое условие. Этим обеспечивается более точное управление, чем путем применения только одних мьютексов. Чтобы показать, как это работает, мы переделаем пример с двумя потоками, используя условия ожидания. </p>
<p class="paragraph">
const int DataSize = 100000; </p>
<p class="paragraph">
const int BufferSize = 4096; </p>
<p class="paragraph">
char buffer[BufferSize]; </p>
<p class="paragraph">
QWaitCondition bufferIsNotFull; </p>
<p class="paragraph">
QWaitCondition bufferIsNotEmpty; </p>
<p class="paragraph">
QMutex mutex; </p>
<p class="paragraph">
int usedSpace = 0; </p>
<p class="paragraph">
Кроме буфера мы объявляем два объекта QWaitCondition, один объект QMutex и одну переменную для хранения количества «использованных» байтов в буфере. </p>
<p class="paragraph">
01 void Producer::run() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 for (int i = 0; i < DataSize; ++i) { </p>
<p class="paragraph">
04 mutex.lock(); </p>
<p class="paragraph">
05 while (usedSpace == BufferSize) </p>
<p class="paragraph">
06 bufferIsNotFull.wait(&mutex); </p>
<p class="paragraph">
07 buffer[i % BufferSize] = "ACGT"[uint(rand()) % 4]; </p>
<p class="paragraph">
08 ++usedSpace; </p>
<p class="paragraph">
09 bufferIsNotEmpty.wakeAll(); </p>
<p class="paragraph">
10 mutex.unlock(); </p>
<p class="paragraph">
11 } </p>
<p class="paragraph">
12 } </p>
<p class="paragraph">
Работу потока, формирующего данные, мы начинаем с проверки заполнения буфера. Если он заполнен, мы ждем возникновения условия «буфер не заполнен». Когда это условие удовлетворяется, мы записываем один байт в буфер, увеличиваем на единицу usedSpace и возобновляем работу любого потока, ожидающего возникновения условия «буфер не пустой». </p>
<p class="paragraph">
Мы используем мьютекс для контроля любого доступа к переменной usedSpace. Функция QWaitCondition::wait() может принимать в первом своем аргументе заблокированный мьютекс, который она открывает перед блокировкой текущего потока и затем вновь блокирует его перед выходом. </p>
<p class="paragraph">
В этом примере мы могли бы заменить цикл while </p>
<p class="paragraph">
while (usedSpace == BufferSize) </p>
<p class="paragraph">
bufferIsNotFull.wait(&mutex); </p>
<p class="paragraph">
на инструкцию if: </p>
<p class="paragraph">
if (usedSpace == BufferSize) { </p>
<p class="paragraph">
mutex.unlock(); </p>
<p class="paragraph">
bufferIsNotFull.wait(); </p>
<p class="paragraph">
mutex.lock(); </p>
<p class="paragraph">
} </p>
<p class="paragraph">
Однако это не будет правильно работать, как только мы станем использовать несколько потоков, формирующих данные, поскольку другой такой поток может захватить мьютекс сразу же после вызова функции wait() и вновь отменить условие «буфер не заполнен». </p>
<p class="paragraph">
01 void Consumer::run() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 for (int i = 0; i < DataSize; ++i) { </p>
<p class="paragraph">
04 mutex.lock(); </p>
<p class="paragraph">
05 while (usedSpace == 0) </p>
<p class="paragraph">
06 bufferIsNotEmpty.wait(&mutex); </p>
<p class="paragraph">
07 cerr << buffer[i % BufferSize]; </p>
<p class="paragraph">
08 --usedSpace; </p>
<p class="paragraph">
09 bufferIsNotFull.wakeAll(); </p>
<p class="paragraph">
10 mutex.unlock(); </p>
<p class="paragraph">
11 } </p>
<p class="paragraph">
12 cerr << endl; </p>
<p class="paragraph">
13 } </p>
<p class="paragraph">
Поток—приемник работает в точности наоборот относительно первого потока: он ожидает возникновения условия «буфер не пустой» и возобновляет работу любого потока, ожидающего условия «буфер не заполнен». </p>
<p class="paragraph">
Во всех приводимых до сих пор примерах наши потоки имеют доступ к одинаковым глобальным переменным. Но для некоторых многопоточных приложений требуется хранить в глобальных переменных неодинаковые данные для разных потоков. Эти переменные часто называют локальной памятью потока (thread-local storage — TLS) или специальными данными потока (thread-specific data — TSD). Мы можем «схитрить» и использовать отображение, в качестве ключей которого применяются идентификаторы потоков (возвращаемые функцией QThread::currentThread()), но более привлекательное решение состоит в использовании класса QThreadStorage<T>. </p>
<p class="paragraph">
Обычно класс QThreadStorage<T> используется для кэш—памяти. Имея отдельный кэш для каждого потока, мы избегаем затрат, связанных с блокировкой, разблокировкой и возможным ожиданием освобождения мьютекса. Например: </p>
<p class="paragraph">
01 QThreadStorage<QHash<int, double> *> cache; </p>
<p class="paragraph">
02 void insertIntoCache(int id, double value) </p>
<p class="paragraph">
03 { </p>
<p class="paragraph">
04 if (!cache.hasLocalData()) </p>
<p class="paragraph">
05 cache.setLocalData(new QHash<int, double>); </p>
<p class="paragraph">
06 cache.localData()->insert(id, value); </p>
<p class="paragraph">
07 } </p>
<p class="paragraph">
08 void removeFromCache(int id) </p>
<p class="paragraph">
09 { </p>
<p class="paragraph">
10 if (cache.hasLocalData()) </p>
<p class="paragraph">
11 cache.localData()->remove(id); </p>
<p class="paragraph">
12 } </p>
<p class="paragraph">
Переменная cache содержит указатель на используемое потоком отображение QHash<int, double>. (Из-за проблем с некоторыми компиляторами тип объекта, задаваемый в шаблонном классе QThreadStorage<T>, должен быть указателем.) При применении первый раз кэша в потоке функция hasLocalData() возвращает false, и мы создаем объект типа QHash<int, double>. </p>
<p class="paragraph">
Кроме кэширования класс QThreadStorage<T> может использоваться для глобальных переменных, отражающих состояние ошибки (подобных errno), чтобы модификации в одном потоке не влияли на другие потоки. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Взаимодействие с главным потоком</p>
<p class="paragraph">
При запуске приложения Qt работает только один поток — главный. Только этот поток может создать объект QApplication или QCoreApplication и вызвать для него функцию exec(). После вызова exec() этот поток либо ожидает возникновения какого-нибудь события, либо обрабатывает какое-нибудь событие. </p>
<p class="paragraph">
Главный поток может запускать новые потоки, создавая объекты подкласса QThread, как мы это делали в предыдущем разделе. Если эти новые потоки должны взаимодействовать друг с другом, они могут совместно использовать переменные под управлением мьютексов, блокировок чтения/записи, семафоров или специальных событий. Но ни один из этих методов нельзя использовать для связи с главным потоком, поскольку они будут блокировать цикл обработки событий и «заморозят» интерфейс пользователя. </p>
<p class="paragraph">
Для связи вторичного потока с главным потоком необходимо использовать межпоточные соединения сигнал—слот. Обычно механизм сигналов и слотов работает синхронно, т.е. связанный с сигналом слот вызывается сразу после генерации сигнала, используя прямой вызов функции. </p>
<p class="paragraph">
Однако когда вы связываете объекты, «живущие» в других потоках, механизм взаимодействия сигналов и слотов становится асинхронным. (Такое поведение можно изменить с помощью пятого параметра функции QObject::connect().) Внутри эти связи реализуются путем регистрации события. Слот затем вызывается в цикле обработки событий потока, в котором находится объект получателя. По умолчанию объект QObject существует в потоке, в котором он был создан; в любой момент можно изменить расположение объекта с помощью вызова функции QObject::moveToThread(). </p>
<div>
<img src="data:image/jpg;base64,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" />
</div>
<p class="paragraph">
Рис. 18.3. Приложение Image Pro. </p>
<p class="paragraph">
Для иллюстрации работы соединений сигнал—слот с разными потоками мы рассмотрим программный код приложения Image Pro — процессора изображений, обеспечивающего базовые возможности и позволяющего пользователю поворачивать, изменять размер и цвет изображения. В данном приложении используется один вторичный поток для выполнения операций над изображениями без блокировки цикла обработки событий. Это имеет существенное значение при обработке изображений очень большого размера. Вторичный поток имеет список выполняемых задач или «транзакций», и он генерирует события для главного окна, чтобы сообщать о том, как идет процесс их выполнения. </p>
<p class="paragraph">
01 ImageWindow::ImageWindow() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 imageLabel = new QLabel; </p>
<p class="paragraph">
04 imageLabel->setBackgroundRole(QPalette::Dark); </p>
<p class="paragraph">
05 imageLabel->setAutoFillBackground(true); </p>
<p class="paragraph">
06 imageLabel->setAlignment(Qt::AlignLeft | Qt::AlignTop); </p>
<p class="paragraph">
07 setCentralWidget(imageLabel); </p>
<p class="paragraph">
08 createActions(); </p>
<p class="paragraph">
09 createMenus(); </p>
<p class="paragraph">
10 statusBar()->showMessage(tr("Ready"), 2000); </p>
<p class="paragraph">
11 connect(&thread, SIGNAL(transactionStarted(const QString &)), </p>
<p class="paragraph">
12 statusBar(), SLOT(showMessage(const QString &))); </p>
<p class="paragraph">
13 connect(&thread, SIGNAL(finished()), </p>
<p class="paragraph">
14 this, SLOT(allTransactionsDone())); </p>
<p class="paragraph">
15 setCurrentFile(""); </p>
<p class="paragraph">
16 } </p>
<p class="paragraph">
Интересной частью конструктора ImageWindow являются два соединения сигнал—слот. В обоих случаях сигнал генерируется объектом TransactionThread, который мы вскоре рассмотрим. </p>
<p class="paragraph">
01 void ImageWindow::flipHorizontally() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 addTransaction(new FlipTransaction(Qt::Horizontal)); </p>
<p class="paragraph">
04 } </p>
<p class="paragraph">
Слот flipHorizontally() создает транзакцию зеркального отражения и регистрирует ее при помощи закрытой функции addTransaction(). Функции flipVertically(), resizeImage(), convertTo32Bit(), convertTo8Bit() и convertTo1Bit() реализуются аналогично. </p>
<p class="paragraph">
01 void ImageWindow::addTransaction(Transaction *transact) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 thread.addTransaction(transact); </p>
<p class="paragraph">
04 openAction->setEnabled(false); </p>
<p class="paragraph">
05 saveAction->setEnabled(false); </p>
<p class="paragraph">
06 saveAsAction->setEnabled(false); </p>
<p class="paragraph">
07 } </p>
<p class="paragraph">
Функция addTransaction() добавляет транзакцию в очередь транзакций вторичного потока и отключает команды Open, Save и Save As на время обработки транзакций. </p>
<p class="paragraph">
01 void ImageWindow::allTransactionsDone() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 openAction->setEnabled(true); </p>
<p class="paragraph">
04 saveAction->setEnabled(true); </p>
<p class="paragraph">
05 saveAsAction->setEnabled(true); </p>
<p class="paragraph">
06 imageLabel->setPixmap(QPixmap::fromImage(thread.image())); </p>
<p class="paragraph">
07 setWindowModified(true); </p>
<p class="paragraph">
08 statusBar()->showMessage(tr("Ready"), 2000); </p>
<p class="paragraph">
09 } </p>
<p class="paragraph">
Слот allTransactionsDone() вызывается, когда очередь транзакций TransactionThread становится пустой. </p>
<p class="paragraph">
Теперь давайте рассмотрим класс TransactionThread: </p>
<p class="paragraph">
01 class TransactionThread : public QThread </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 Q_OBJECT </p>
<p class="paragraph">
04 public: </p>
<p class="paragraph">
05 void addTransaction(Transaction *transact); </p>
<p class="paragraph">
06 void setImage(const QImage &image); </p>
<p class="paragraph">
07 QImage image(); </p>
<p class="paragraph">
08 signals: </p>
<p class="paragraph">
09 void transactionStarted(const QString &message); </p>
<p class="paragraph">
10 protected: </p>
<p class="paragraph">
11 void run(); </p>
<p class="paragraph">
12 private: </p>
<p class="paragraph">
13 QMutex mutex; </p>
<p class="paragraph">
14 QImage currentImage; </p>
<p class="paragraph">
15 QQueue<Transaction *> transactions; </p>
<p class="paragraph">
16 }; </p>
<p class="paragraph">
Класс TransactionThread содержит список обрабатываемых транзакций, которые выполняются по очереди в фоновом режиме. </p>
<p class="paragraph">
01 void TransactionThread::addTransaction(Transaction *transact) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 QMutexLocker locker(&mutex); </p>
<p class="paragraph">
04 transactions.enqueue(transact); </p>
<p class="paragraph">
05 if (!isRunning()) </p>
<p class="paragraph">
06 start(); </p>
<p class="paragraph">
07 } </p>
<p class="paragraph">
Функция addTransaction() добавляет транзакцию в очередь транзакций и запускает поток транзакции, если он еще не выполняется. Доступ к переменной—члену transactions защищается мьютексом, потому что главный поток мог бы ее модифицировать функцией addTransaction() во время прохода по транзакциям transactions вторичного потока. </p>
<p class="paragraph">
01 void TransactionThread::setImage(const QImage &image) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 QMutexLocker locker(&mutex); </p>
<p class="paragraph">
04 currentImage = image; </p>
<p class="paragraph">
05 } </p>
<p class="paragraph">
06 QImage TransactionThread::image() </p>
<p class="paragraph">
07 { </p>
<p class="paragraph">
08 QMutexLocker locker(&mutex); </p>
<p class="paragraph">
09 return currentImage; </p>
<p class="paragraph">
10 } </p>
<p class="paragraph">
Функции setImage() и image() позволяют главному потоку установить изображение, для которого будут выполняться транзакции, и получить обработанное изображение после завершения всех транзакций. И вновь мы защищаем доступ к переменной—члену при помощи мьютекса. </p>
<p class="paragraph">
01 void TransactionThread::run() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 Transaction *transact; </p>
<p class="paragraph">
04 forever { </p>
<p class="paragraph">
05 mutex.lock(); </p>
<p class="paragraph">
06 if (transactions.isEmpty()) { </p>
<p class="paragraph">
07 mutex.unlock(); </p>
<p class="paragraph">
08 break; </p>
<p class="paragraph">
09 } </p>
<p class="paragraph">
10 QImage oldImage = currentImage; </p>
<p class="paragraph">
11 transact = transactions.dequeue(); </p>
<p class="paragraph">
12 mutex.unlock(); </p>
<p class="paragraph">
13 emit transactionStarted(transact->message()); </p>
<p class="paragraph">
14 QImage newImage = transact->apply(oldImage); </p>
<p class="paragraph">
15 delete transact; </p>
<p class="paragraph">
16 mutex.lock(); </p>
<p class="paragraph">
17 currentImage = newImage; </p>
<p class="paragraph">
18 mutex.unlock(); </p>
<p class="paragraph">
19 } </p>
<p class="paragraph">
20 } </p>
<p class="paragraph">
Функция run() просматривает очередь транзакций и по очереди выполняет все транзакции путем вызова для них функции apply(). </p>
<p class="paragraph">
После старта транзакции мы генерируем сигнал transactionStarted() с сообщением, выводимым в строке состояния приложения. Когда обработка всех транзакций завершается, функция run() возвращает управление и QThread генерирует сигнал finished(). </p>
<p class="paragraph">
01 class Transaction </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 public: </p>
<p class="paragraph">
04 virtual ~Transaction() { } </p>
<p class="paragraph">
05 virtual QImage apply(const QImage &image) = 0; </p>
<p class="paragraph">
06 virtual QString message() = 0; </p>
<p class="paragraph">
07 }; </p>
<p class="paragraph">
Класс Transaction является абстрактным базовым классом, предназначенным для определения операций, которые пользователь может выполнять с изображением. Виртуальный деструктор необходим, потому что нам приходится удалять экземпляры подклассов Transaction через указатель transaction. (Кроме того, если мы его не предусмотрим, некоторые компиляторы выдадут предупреждение.) Transaction имеет три конкретных подкласса: FlipTransaction, ResizeTransaction и ConvertDepthTransaction. Нами будет рассмотрен только подкласс FlipTransaction; другие два подкласса имеют аналогичное определение. </p>
<p class="paragraph">
01 class FlipTransaction : public Transaction </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 public: </p>
<p class="paragraph">
04 FlipTransaction(Qt::Orientation orientation); </p>
<p class="paragraph">
05 QImage apply(const QImage &image); </p>
<p class="paragraph">
06 QString message(); </p>
<p class="paragraph">
07 private: </p>
<p class="paragraph">
08 Qt::Orientation orientation; </p>
<p class="paragraph">
09 }; </p>
<p class="paragraph">
Конструктор FlipTransaction принимает один параметр, который задает ориентацию зеркального отражения (по горизонтали или по вертикали). </p>
<p class="paragraph">
01 QImage FlipTransaction::apply(const QImage &image) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 return image.mirrored( </p>
<p class="paragraph">
04 orientation == Qt::Horizontal, orientation == Qt::Vertical); </p>
<p class="paragraph">
05 } </p>
<p class="paragraph">
Функция apply() вызывает QImage::mirrored() для объекта QImage, полученного в виде параметра, и возвращает сформированный объект QImage. </p>
<p class="paragraph">
01 QString FlipTransaction::message() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 if (orientation == Qt::Horizontal) { </p>
<p class="paragraph">
04 return QObject::tr("Flipping image horizontally..."); </p>
<p class="paragraph">
05 } else { </p>
<p class="paragraph">
06 return QObject::tr("Flipping image vertically..."); </p>
<p class="paragraph">
07 } </p>
<p class="paragraph">
08 } </p>
<p class="paragraph">
Функция messageStr() возвращает сообщение, отображаемое в строке состояния в ходе выполнения операции. Данная функция вызывается из функции transactionThread::run(), кoгдa гeнepиpyeтcя cигнaл transactionStarted(). </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Применение классов Qt во вторичных потоках</p>
<p class="paragraph">
Функция называется потокозащищенной (thread—safe), если она может спокойно вызываться одновременно из нескольких потоков. Если две такие функции вызываются из различных потоков и совместно используют одинаковые данные, результат всегда будет вполне определенным. Это определение можно расширить на класс, и тогда класс будет называться потокозащищенным, если все его функции могут вызываться одновременно из различных потоков, не мешая работе друг друга, если они даже работают с одним и тем же объектом. </p>
<p class="paragraph">
В Qt потокозащищенными являются классы QMutex, QMutexLocker, QReadWriteLock, QReadLocker, QWriteLocker, QSemaphore, QThreadStorage<T>, QWaitCondition и часть программного интерфейса QThread. Кроме того, несколько функций являются потокозащищенными, в частности QObject::connect(), QObject::disconnect(), QCoreApplication::postEvent(), QCoreApplication::removePostedEvent() и QCoreApplication::removePostedEvents(). </p>
<p class="paragraph">
Большинство классов Qt неграфического интерфейса удовлетворяют менее строгому ограничению: они являются реентерабельными (reentrant). Класс называется реентерабельным, если разные его экземпляры могут одновременно использоваться разными потоками. Однако одновременный доступ к одному реентерабельному объекту при многопоточной обработке недостаточно надежен и должен контролироваться при помощи мьютекса. Реентерабельность классов отмечается в справочной документации Qt. Обычно любой класс С++, который не использует глобальные переменные (или, другими словами, совместно используемые данные), является реентерабельным. </p>
<p class="paragraph">
Класс QObject — реентерабельный, однако не следует забывать о трех ограничениях: </p>
<p class="paragraph">
• Дочерние объекты QObject должны создаваться их родительским потоком. В частности, это означает, что созданные во вторичном потоке объекты нельзя создавать с указанием в качестве родительского объекта QThread, потому что этот объект был создан в другом потоке (либо в главном потоке, либо в другом вторичном потоке). </p>
<p class="paragraph">
• Все объекты QObject, созданные во вторичном потоке, должны быть удалены до удаления соответствующего объекта QThread. Это можно обеспечить путем создания объектов в стеке функцией QThread::run(). </p>
<p class="paragraph">
• Объекты QObject должны удаляться в том потоке, в котором они были созданы. Если требуется удалить объект QObject, существующий в другом потоке, мы должны вызвать потокозащищенную функцию QObject::deleteLater(), которая регистрирует событие «отсроченное удаление». </p>
<p class="paragraph">
Такие подклассы QObject неграфического интерфейса, как QTimer, QProcess и сетевые классы, являются реентерабельными. Мы можем использовать их в любом потоке, содержащем цикл обработки событий. Во вторичных потоках цикл обработки событий начинается с вызова QThread::exec() или таких удобных функций, как QProcess::waitForFinished() и QAbstractSocket::waitForDisconnected(). </p>
<p class="paragraph">
Из-за ограничений, унаследованных от низкоуровневых библиотек, на основе которых построена поддержка графического пользовательского интерфейса в Qt, QWidget и его подклассы нереентерабельны. Одним из следствий этого является невозможность прямого вызова функций виджета из вторичного потока. Если мы, например, хотим изменить текст QLabel из вторичного потока, мы можем генерировать сигнал, связанный с QLabel::setText(), или вызвать из этого потока функцию QMetaObject::invokeMethod(). Например: </p>
<p class="paragraph">
void MyThread::run() </p>
<p class="paragraph">
{ </p>
<p class="paragraph">
… </p>
<p class="paragraph">
QMetaObject::invokeMethod(label, SLOT(setText(const QString &)), </p>
<p class="paragraph">
Q_ARG(QString, "Hello")); </p>
<p class="paragraph">
… </p>
<p class="paragraph">
} </p>
<p class="paragraph">
Многие из классов Qt неграфического интерфейса, включая QImage, QString и классы—контейнеры, применяют оптимизацию неявного совместного использования данных. Хотя такая оптимизация делает класс нереентерабельным, в Qt не возникает проблем, потому что Qt использует атомарные инструкции языка ассемблер для реализации потокозащищенного подсчета ссылок, делая реентерабельными Qt—классы, применяющие неявное совместное использование данных. </p>
<p class="paragraph">
Модуль QtSql также может использоваться в многопоточных приложениях, но он имеет свои ограничения, которые отличаются для разных баз данных. Более подробную информацию вы найдете в сети Интернет по адресу . Полный список предостережений, относящихся к многопоточной обработке, находится на веб-странице . </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Глава 19. Создание подключаемых модулей</p>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<div>
<img src="data:image/jpg;base64,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" />
</div>
<p class="paragraph">
Динамические библиотеки (называемые также совместно используемыми библиотеками или библиотеками DLL) — это независимые модули, хранимые в отдельном файле на диске, доступ к которым могут получать несколько приложений. Как правило, необходимые для программы динамические библиотеки определяются на этапе сборки, в таких случаях эти библиотеки автоматически загружаются при запуске приложения. При таком подходе обычно в файл приложения .pro добавляются библиотека и, возможно, путь доступа к ней, а в исходные файлы включаются соответствующие заголовочные файлы. Например: </p>
<p class="paragraph">
LIBS += -ldb_cxx </p>
<p class="paragraph">
INCLUDEPATH += /usr/local/BerkeleyDB.4.2/include </p>
<p class="paragraph">
Альтернативный подход заключается в динамической загрузке библиотеки по мере необходимости и затем разрешении ее символов, которые будут нами использоваться. Qt предоставляет класс QLibrary для решения этой задачи независимым от платформы способом. Получая основную часть имени библиотеки, QLibrary выполняет поиск соответствующего файла в стандартном для платформы месте. Например, если задано имя mimetype, будет выполняться поиск файла mimetype.dll в Windows, mimetype.so в Linux и mimetype.dylib в Mac OS X. </p>
<p class="paragraph">
Часто можно расширять функциональные возможности современных приложений с графическим пользовательским интерфейсом за счет применения подключаемых модулей. Подключаемый модуль (plugin) — это динамическая библиотека, которая реализует специальный интерфейс для обеспечения дополнительной функциональности. Например, в мы создали подключаемый модуль для интеграции пользовательского виджета в Qt Designer. </p>
<p class="paragraph">
Qt распознает свой собственный набор интерфейсов подключаемых модулей, относящихся к различным областям, включая форматы изображений, драйверы баз данных, стили виджетов, текстовые кодировки и условия доступа. Первый раздел данной главы показывает, как можно расширить возможности Qt с помощью подключаемых модулей. </p>
<p class="paragraph">
Кроме того, можно создавать подключаемые модули, предназначенные для конкретных Qt—приложений. Писать такие подключаемые модули в Qt достаточно просто с использованием фреймворка Qt для подключаемых модулей, который повышает безопасность и удобство применения класса QLibrary. В последних двух разделах данной главы мы покажем, как обеспечить в приложении поддержку подключаемых модулей и как создавать пользовательские подключаемые модули для приложения. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Расширение Qt с помощью подключаемых модулей</p>
<p class="paragraph">
Qt можно расширять, используя различные типы подключаемых модулей, среди которых наиболее распространенными являются драйверы баз данных, форматы изображений, стили и текстовые кодировки. Каждый тип подключаемых модулей обычно требует наличия по крайней мере двух классов: класса—оболочки, который реализует общие функции программного интерфейса подключаемых модулей, и одного или более классов—обработчиков, которые реализуют программный интерфейс для конкретного типа подключаемых модулей. Обработчики вызываются из класса—оболочки. </p>
<p class="paragraph">
Ниже приведен список Qt—классов подключаемых модулей и обработчиков, исключая Qtopia Core (рис. 19.1): </p>
<p class="paragraph">
• QAccessibleBridgePlugin — QAccessibleBridge, </p>
<p class="paragraph">
• QAccessiblePlugin — QAccessibleIntertace, </p>
<p class="paragraph">
• QIconEnginePlugin — QIconEngine, </p>
<p class="paragraph">
• QImageIOPlugin — QImageIOHandler, </p>
<p class="paragraph">
• QInputContextPlugin — QInputContext, </p>
<p class="paragraph">
• QPictureFormatPlugin — нет обработчика, </p>
<p class="paragraph">
• QSqlDriverPlugin — QSqlDriver, </p>
<p class="paragraph">
• QStylePlugin — QStyle, </p>
<p class="paragraph">
• QTextCodecPlugin — QTextCodec. </p>
<p class="paragraph">
В демонстрационных целях мы реализуем подключаемый модуль, способный считывать в Windows монохромные файлы курсоров (файлы .cur). Эти файлы могут содержать несколько изображений разного размера для одного курсора. После построения и установки этого подключаемого модуля Qt сможет считывать файлы .cur и получать доступ к отдельным курсорам (например, с помощью классов QImage, QImageReader или QMovie); также можно будет преобразовывать эти курсоры в любой другой формат файлов изображений, воспринимаемый Qt (например, BMP, JPEG и PNG). Кроме того, подключаемый модуль может разворачиваться совместно с Qt—приложениями, поскольку они автоматически проверяют стандартные места расположения подключаемых модулей Qt и загружают все найденные модули. </p>
<p class="paragraph">
Новые классы—оболочки подключаемых модулей должны быть подклассом QImageIOPlugin и должны обеспечить реализацию нескольких виртуальных функций: </p>
<p class="paragraph">
01 class CursorPlugin : public QImageIOPlugin </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 public: </p>
<p class="paragraph">
04 QStringList keys() const; </p>
<p class="paragraph">
05 Capabilities capabilities(QIODevice *device, </p>
<p class="paragraph">
06 const QByteArray &format) const; </p>
<p class="paragraph">
07 QImageIOHandler *create(QIODevice *device, </p>
<p class="paragraph">
08 const QByteArray &format) const; </p>
<p class="paragraph">
09 }; </p>
<p class="paragraph">
Функция keys() возвращает список форматов изображений, которые поддерживает подключаемый модуль. Можно считать, что параметр format функций capabilities() и create() имеет значение из этого списка. </p>
<p class="paragraph">
01 QStringList CursorPlugin::keys() const </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 return QStringList() << "cur"; </p>
<p class="paragraph">
04 } </p>
<p class="paragraph">
Наш подключаемый модуль поддерживает один формат изображений, поэтому возвращается список, содержащий только одно название. В идеале это название должно совпадать с расширением файла, используемым данным форматом. Если форматы имеют несколько расширений (например, .jpg и .jpeg для JPEG), мы можем возвращать список с несколькими элементами, относящимися к одному формату, — по одному элементу на каждое расширение. </p>
<p class="paragraph">
01 QImageIOPlugin::Capabilities </p>
<p class="paragraph">
02 CursorPlugin::capabilities(QIODevice *device, </p>
<p class="paragraph">
03 const QByteArray &format) const </p>
<p class="paragraph">
04 { </p>
<p class="paragraph">
05 if (format == "cur") </p>
<p class="paragraph">
06 return CanRead; </p>
<p class="paragraph">
07 if (format.isEmpty()) { </p>
<p class="paragraph">
08 CursorHandler handler; </p>
<p class="paragraph">
09 handler.setDevice(device); </p>
<p class="paragraph">
10 if (handler.canRead()) </p>
<p class="paragraph">
11 return CanRead; </p>
<p class="paragraph">
12 } </p>
<p class="paragraph">
13 return 0; </p>
<p class="paragraph">
14 } </p>
<p class="paragraph">
Функция capabilities() возвращает объект, который показывает, что может делать с данным форматом изображений обработчик изображений. Существует три возможных действия (CanRead, CanWrite и CanReadIncremental), а возвращаемое значение объединяет допустимые варианты порязрадной логической операцией ИЛИ. </p>
<p class="paragraph">
Если формат «cur», наша реализация возвращает CanRead. Если формат не задан, мы создаем обработчик курсора и проверяем его способность чтения данных с заданного устройства. Функция canRead() только просматривает данные и проверяет возможность распознавания файла, не изменяя указатель файла. Возвращение 0 означает, что данный обработчик не может ни считывать, ни записывать файл. </p>
<p class="paragraph">
01 QImageIOHandler *CursorPlugin::create(QIODevice *device, </p>
<p class="paragraph">
02 const QByteArray &format) const </p>
<p class="paragraph">
03 { </p>
<p class="paragraph">
04 CursorHandler *handler = new CursorHandler; </p>
<p class="paragraph">
05 handler->setDevice(device); </p>
<p class="paragraph">
06 handler->setFormat(format); </p>
<p class="paragraph">
07 return handler; </p>
<p class="paragraph">
08 } </p>
<p class="paragraph">
Когда файл курсора открыт (например, с помощью класса QImageReader), будет вызвана функция оболочки подключаемого модуля create() с передачей указателя устройства и формата «cur». Мы создаем экземпляр CursorHandler для заданного устройства и формата. Вызывающая программа становится владельцем обработчика и удалит его, когда он не станет нужен. Если приходится считывать несколько файлов, для каждого из них создается новый обработчик. </p>
<p class="paragraph">
Q_EXPORT_PLUGIN2(cursorplugin, CursorPlugin) </p>
<p class="paragraph">
В конце файла .cpp мы используем макрос Q_EXPORT_PLUGIN2(), чтобы гарантировать распознавание в Qt подключаемого модуля. В первом параметре задается произвольное имя, используемое нами для подключаемого модуля. Второй параметр содержит имя класса подключаемого модуля. </p>
<p class="paragraph">
Подкласс QImageIOPlugin создается достаточно просто. Реальная работа подключаемого модуля делается обработчиком. Обработчики форматов изображений должны создать подкласс QImageIOHandler и переопределить некоторые или все его открытые функции. Сначала рассмотрим заголовочный файл: </p>
<p class="paragraph">
01 class CursorHandler : public QImageIOHandler </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 public: </p>
<p class="paragraph">
04 CursorHandler(); </p>
<p class="paragraph">
05 bool canRead() const; </p>
<p class="paragraph">
06 bool read(QImage *image); </p>
<p class="paragraph">
07 bool jumpToNextImage(); </p>
<p class="paragraph">
08 int currentImageNumber() const; </p>
<p class="paragraph">
09 int imageCount() const; </p>
<p class="paragraph">
10 private: </p>
<p class="paragraph">
11 enum State { BeforeHeader, BeforeImage, AfterLastImage, Error }; </p>
<p class="paragraph">
12 void readHeaderIfNecessary() const; </p>
<p class="paragraph">
13 QBitArray readBitmap(int width, int height, QDataStream &in) const; </p>
<p class="paragraph">
14 void enterErrorState() const; </p>
<p class="paragraph">
15 mutable State state; </p>
<p class="paragraph">
16 mutable int currentImageNo; </p>
<p class="paragraph">
17 mutable int numImages; </p>
<p class="paragraph">
18 }; </p>
<p class="paragraph">
Открытые функции имеют фиксированную сигнатуру. Здесь нет некоторых функций, которые не надо переопределять в обработчике, обеспечивающем только чтение, в частности отсутствует функция write(). Переменные—члены объявляются с ключевым словом mutable, потому что они изменяются внутри константных функций. </p>
<p class="paragraph">
01 CursorHandler::CursorHandler() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 state = BeforeHeader; </p>
<p class="paragraph">
04 currentImageNo = 0; </p>
<p class="paragraph">
05 numImages = 0; </p>
<p class="paragraph">
06 } </p>
<p class="paragraph">
После создания обработчика мы сначала настраиваем его параметры. Номер текущего изображения курсора устанавливается на первый курсор, но поскольку переменная количества изображений numImages принимает значение 0, ясно, что у нас пока еще нет изображений. </p>
<p class="paragraph">
01 bool CursorHandler::canRead() const </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 if (state == BeforeHeader) { </p>
<p class="paragraph">
04 return device()->peek(4) == QByteArray("\0\0\2\0", 4); </p>
<p class="paragraph">
05 } else { </p>
<p class="paragraph">
06 return state != Error; </p>
<p class="paragraph">
07 } </p>
<p class="paragraph">
08 } </p>
<p class="paragraph">
Функция canRead() может вызываться в любой момент для определения возможности считывания обработчиком изображений дополнительных данных с устройства. Если функция вызывается до чтения данных в состоянии BeforeHeader, выполняется проверка конкретной метки, по которой опознаются файлы курсоров в Windows. Вызов QIODevice::peek() считывает первые четыре байта без изменения указателя файла на данном устройстве. Если функция canRead() вызывается позже, мы возвращаем true при отсутствии ошибки. </p>
<p class="paragraph">
01 int CursorHandler::currentImageNumber() const </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 return currentImageNo; </p>
<p class="paragraph">
04 } </p>
<p class="paragraph">
Эта простая функция возвращает номер курсора, на который позиционирован указатель файла устройства. </p>
<p class="paragraph">
После создания обработчика пользователь может вызвать любую его открытую функцию, причем последовательность вызовов функций может быть произвольной. В этом кроется потенциальная проблема, поскольку необходимо исходить из того, что файл можно читать только последовательно, поэтому сначала надо один раз считать заголовок файла и затем выполнять какие-то другие действия. Эту проблему решаем путем вызова readHeaderIfNecessary() в тех функциях, для которых требуется предварительное считывание заголовка файла. </p>
<p class="paragraph">
01 int CursorHandler::imageCount() const </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 readHeaderIfNecessary(); </p>
<p class="paragraph">
04 return numImages; </p>
<p class="paragraph">
05 } </p>
<p class="paragraph">
Эта функция возвращает количество изображений, содержащихся в файле. Для правильного файла, при чтении которого не возникает ошибок, она возвращает по крайней мере 1. </p>
<div>
<img src="data:image/jpg;base64,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" />
</div>
<p class="paragraph">
Рис. 19.2. Формат файла .cur. </p>
<p class="paragraph">
Следующая функция довольно сложная, поэтому мы рассмотрим ее по частям: </p>
<p class="paragraph">
01 bool CursorHandler::read(QImage *image) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 readHeaderIfNecessary(); </p>
<p class="paragraph">
04 if (state != BeforeImage) </p>
<p class="paragraph">
05 return false; </p>
<p class="paragraph">
Функция read() считывает данные изображения, начинающегося в текущей позиции указателя устройства. Если успешно считан заголовок файла или указатель устройства после чтения изображения находится в начале другого изображения, можно считывать следующее изображение. </p>
<p class="paragraph">
06 quint32 size; </p>
<p class="paragraph">
07 quint32 width; </p>
<p class="paragraph">
08 quint32 height; </p>
<p class="paragraph">
09 quint16 numPlanes; </p>
<p class="paragraph">
10 quint16 bitsPerPixel; </p>
<p class="paragraph">
11 quint32 compression; </p>
<p class="paragraph">
12 QDataStream in(device()); </p>
<p class="paragraph">
13 in.setByteOrder(QDataStream::LittleEndian); </p>
<p class="paragraph">
14 in >> size; </p>
<p class="paragraph">
15 if (size != 40) { </p>
<p class="paragraph">
16 enterErrorState(); </p>
<p class="paragraph">
17 return false; </p>
<p class="paragraph">
18 } </p>
<p class="paragraph">
19 in >> width >> height >> numPlanes >> bitsPerPixel >> compression; </p>
<p class="paragraph">
20 height /= 2; </p>
<p class="paragraph">
21 if (numPlanes != 1 || bitsPerPixel != 1 || compression != 0) { </p>
<p class="paragraph">
22 enterErrorState(); </p>
<p class="paragraph">
23 return false; </p>
<p class="paragraph">
24 } </p>
<p class="paragraph">
25 in.skipRawData((size - 20) + 8); </p>
<p class="paragraph">
Мы создаем объект QDataStream для чтения устройства. Необходимо установить порядок байтов в соответствии с тем, который определен спецификацией формата файла .cur. Задавать версию потока QDataStream нет необходимости, поскольку форматы целых чисел и чисел с плавающей запятой не зависят от версии потока данных. Затем считываем элементы заголовка курсора и пропускаем неиспользуемые части заголовка и 8-байтовую таблицу цветов с помощью функции QDataStream::skipRawData(). </p>
<p class="paragraph">
Необходимо учитывать все характерные особенности формата, например, уменьшая вдвое высоту изображения, потому что она в формате .cur в два раза превышает высоту реального изображения. Переменные bitsPerPixel и compression всегда имеют значения 1 и 0 в монохромных файлах .cur. При возникновении каких-либо проблем вызываем функцию enterErrorState() и возвращаем false. </p>
<p class="paragraph">
26 QBitArray xorBitmap = readBitmap(width, height, in); </p>
<p class="paragraph">
27 QBitArray andBitmap = readBitmap(width, height, in); </p>
<p class="paragraph">
28 if (in.status() != QDataStream::Ok) { </p>
<p class="paragraph">
29 enterErrorState(); </p>
<p class="paragraph">
30 return false; </p>
<p class="paragraph">
31 } </p>
<p class="paragraph">
Следующими элементами файла являются две битовые маски: одна XOR—маска, а другая AND—маска. Мы их считываем в массивы QBitArray, а не в QBitmap. Класс QBitmap предназначен для выполнения с ним операций рисования и вывода рисунка на экран, а нам нужен простой массив битов. </p>
<p class="paragraph">
Завершив чтение файла, проверяем состояние потока QDataStream. Так можно поступать, потому что, если QDataStream переходит в состояние ошибки, это состояние сохраняется в дальнейшем и последующие операции чтения могут выдать только нули. Например, если чтение первого массива бит завершается неудачей, попытка чтения второго массива в результате даст пустой массив QBitArray. </p>
<p class="paragraph">
32 *image = QImage(width, height, QImage::Format_ARGB32); </p>
<p class="paragraph">
33 for (int i = 0; i < int(height); ++i) { </p>
<p class="paragraph">
34 for (int j = 0; j < int(width); ++j) { </p>
<p class="paragraph">
35 QRgb color; </p>
<p class="paragraph">
36 int bit = (i * width) + j; </p>
<p class="paragraph">
37 if (andBitmap.testBit(bit)) { </p>
<p class="paragraph">
38 if (xorBitmap.testBit(bit)) { </p>
<p class="paragraph">
39 color = 0x7F7F7F7F; </p>
<p class="paragraph">
40 } else { </p>
<p class="paragraph">
41 color = 0x00FFFFFF; </p>
<p class="paragraph">
42 } </p>
<p class="paragraph">
43 } else { </p>
<p class="paragraph">
44 if (xorBitmap.testBit(bit)) { </p>
<p class="paragraph">
45 color = 0xFFFFFFFF; </p>
<p class="paragraph">
46 } else { </p>
<p class="paragraph">
47 color = 0xFF000000; </p>
<p class="paragraph">
48 } </p>
<p class="paragraph">
50 } </p>
<p class="paragraph">
51 image->setPixel(j, i, color); </p>
<p class="paragraph">
52 } </p>
<p class="paragraph">
53 } </p>
<p class="paragraph">
Мы конструируем новый объект QImage с правильными размерами и устанавливаем на него указатель изображения. Затем проходим по каждому пикселю битовых массивов XOR и AND и преобразуем их в 32-битовый цветовой формат ARGB. С помощью массивов битов AND и XOR цвет каждого пикселя курсора всегда получается в соответствии со следующей таблицей: </p>
<div>
<img src="data:image/jpg;base64,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" />
</div>
<p class="paragraph">
С получением черного, белого и прозрачного пикселей нет проблем, однако нельзя получить инвертированный пиксель фона, используя цветовой формат ARGB, если не знаешь цвет исходного пикселя фона. В качестве замены используем полупрозрачный серый цвет (0x7F7F7F7F). </p>
<p class="paragraph">
54 ++currentImageNo; </p>
<p class="paragraph">
55 if (currentImageNo == numImages) </p>
<p class="paragraph">
56 state = AfterLastImage; </p>
<p class="paragraph">
57 return true; </p>
<p class="paragraph">
58 } </p>
<p class="paragraph">
Завершив чтение изображения, мы обновляем текущий номер изображения и обновляем состояние, если прочитано последнее изображение. В конце функции устройство будет указывать на начало следующего изображения или на конец файла. </p>
<p class="paragraph">
01 bool CursorHandler::jumpToNextImage() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 QImage image; </p>
<p class="paragraph">
04 return read(&image); </p>
<p class="paragraph">
05 } </p>
<p class="paragraph">
Функция jumpToNextImage() используется для пропуска изображения. Для простоты мы всего лишь вызываем read() и игнорируем полученный QImage. В более эффективной реализации использовалась бы информация, содержащаяся в заголовке файла .cur, для непосредственного смещения по файлу на соответствующее значение. </p>
<p class="paragraph">
01 void CursorHandler::readHeaderIfNecessary() const </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 if (state != BeforeHeader) </p>
<p class="paragraph">
04 return; </p>
<p class="paragraph">
05 quint16 reserved; </p>
<p class="paragraph">
06 quint16 type; </p>
<p class="paragraph">
07 quint16 count; </p>
<p class="paragraph">
08 QDataStream in(device()); </p>
<p class="paragraph">
09 in.setByteOrder(QDataStream::LittleEndian); </p>
<p class="paragraph">
10 in >> reserved >> type >> count; </p>
<p class="paragraph">
11 in.skipRawData(16 * count); </p>
<p class="paragraph">
12 if (in.status() != QDataStream::Ok || reserved != 0 </p>
<p class="paragraph">
13 || type != 2 || count == 0) { </p>
<p class="paragraph">
14 enterErrorState(); </p>
<p class="paragraph">
15 return; </p>
<p class="paragraph">
16 } </p>
<p class="paragraph">
17 state = BeforeImage; </p>
<p class="paragraph">
18 currentImageNo = 0; </p>
<p class="paragraph">
19 numImages = int(count); </p>
<p class="paragraph">
20 } </p>
<p class="paragraph">
Закрытая функция readHeaderIfNecessary() вызывается из imageCount() и read(). Если заголовок файла уже был прочитан, состояние не будет иметь значение BeforeHeader (перед заголовком) и сразу же делается возврат управления. В противном случае открываем на устройстве поток данных, считываем некоторые общие данные (в частности, количество курсоров, содержащихся в файле) и устанавливаем состояние в значение BeforeImage (перед изображением). В конце указатель файла данного устройства устанавливается перед первым изображением. </p>
<p class="paragraph">
01 void CursorHandler::enterErrorState() const </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 currentImageNo = 0; </p>
<p class="paragraph">
04 numImages = 0; </p>
<p class="paragraph">
05 state = Error; </p>
<p class="paragraph">
06 } </p>
<p class="paragraph">
При возникновении ошибки считаем, что файл не содержит изображений требуемого формата, и устанавливаем состояние в значение Error. В дальнейшем такое состояние обработчика не может быть изменено. </p>
<p class="paragraph">
01 QBitArray CursorHandler::readBitmap(int width, int height, </p>
<p class="paragraph">
02 QDataStream &in) const </p>
<p class="paragraph">
03 { </p>
<p class="paragraph">
04 QBitArray bitmap(width * height); </p>
<p class="paragraph">
05 quint8 byte; </p>
<p class="paragraph">
06 quint32 word; </p>
<p class="paragraph">
07 for (int i = 0; i < height; ++i) { </p>
<p class="paragraph">
08 for (int j = 0; j < width; ++j) { </p>
<p class="paragraph">
09 if ((j % 32) == 0) { </p>
<p class="paragraph">
10 word = 0; </p>
<p class="paragraph">
11 for (int k = 0; k < 4; ++k) { </p>
<p class="paragraph">
12 in >> byte; </p>
<p class="paragraph">
13 word = (word << 8) | byte; </p>
<p class="paragraph">
14 } </p>
<p class="paragraph">
15 } </p>
<p class="paragraph">
16 bitmap.setBit(((height - i - 1) * width) + j, </p>
<p class="paragraph">
17 word & 0x80000000); </p>
<p class="paragraph">
18 word <<= 1; </p>
<p class="paragraph">
19 } </p>
<p class="paragraph">
20 } </p>
<p class="paragraph">
21 return bitmap; </p>
<p class="paragraph">
22 } </p>
<p class="paragraph">
Функция readBitmap() используется для чтения масок курсора AND и XOR. Эти маски обладают двумя необычными свойствами. Во-первых, строки в них располагаются, начиная с нижних, вместо обычного расположения строк сверху вниз. Во-вторых, оказывается, что используемый здесь порядок байтов отличается от порядка байтов любых других данных в файлах .cur. В связи с этим нам приходится инвертировать координату у в вызове setBit() и считывать маски побайтно, сдвигая биты и используя маску для получения правильных значений. </p>
<p class="paragraph">
Этим завершается реализация класса CursorHandler — подключаемого модуля, предназначенного для работы с изображениями курсоров. Подключаемые модули для изображений других форматов могли бы создаваться аналогично, хотя в некоторых случаях может потребоваться реализация дополнительных функций программного интерфейса QImageIOHandler, в частности функций, используемых для записи изображений. Подключаемые модули другого вида, например кодировки текста или драйверы баз данных, создаются по тому же самому образцу: реализуются класс—оболочка, обеспечивающий общий программный интерфейс подключаемых модулей, который может использоваться приложением, и обработчик, обеспечивающий базовую функциональность. </p>
<p class="paragraph">
Файл .pro для подключаемых модулей отличается от файлов .pro, используемых для приложений, поэтому мы покажем его состав: </p>
<p class="paragraph">
TEMPLATE = lib </p>
<p class="paragraph">
CONFIG += plugin </p>
<p class="paragraph">
HEADERS = cursorhandler.h \ </p>
<p class="paragraph">
cursorplugin.h </p>
<p class="paragraph">
SOURCES = cursorhandler.cpp \ </p>
<p class="paragraph">
cursorplugin.cpp </p>
<p class="paragraph">
DESTDIR = $(QTDIR)/plugins/imageformats </p>
<p class="paragraph">
По умолчанию файлы .pro используют шаблон app, но здесь мы должны указать шаблон lib, потому что подключаемый модуль является библиотекой, а не автономным приложением. Строка с элементом CONFIG указывает Qt на то, что у нас не простая библиотека, а библиотека подключаемого модуля. Элемент DESTDIR определяет каталог размещения подключаемого модуля. Каждый подключаемый модуль Qt должен находиться в соответствующем подкаталоге каталога plugins, и поскольку наш подключаемый модуль обеспечивает новый формат изображений, помещаем его в plugins/imageformats. Список имен каталогов и типов подключаемых модулей приводится на веб-странице . В данном случае мы предполагаем, что переменная среды QTDIR определяет каталог, в котором находится Qt. </p>
<p class="paragraph">
Для Qt в рабочем (release) и отладочном (debug) режимах создаются различные подключаемые модули, поэтому, если установлены обе версии Qt, имеет смысл указать в файле .pro ту из них, которая будет использоваться, добавляя строку </p>
<p class="paragraph">
CONFIG += release </p>
<p class="paragraph">
Приложения, использующие подключаемые модули Qt, должны разворачиваться совместно со своими подключаемыми модулями. Подключаемые модули Qt должны располагаться в конкретных подкаталогах (например, в imageformats для форматов изображений). Приложения Qt ищут подключаемые модули в каталоге plugins, который располагается в каталоге размещения исполняемого модуля приложения, поэтому поиск подключаемых модулей изображений будет выполняться в application_dir/plugins/imageformats. Если требуется развернуть подключаемые модули Qt в другом каталоге, можно установить дополнительный путь поиска, используя функцию QCoreApplication::addLibraryPath(). </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Как обеспечить в приложении возможность подключения модулей</p>
<p class="paragraph">
Подключаемый к приложению модуль является динамической библиотекой, которая реализует какой-нибудь один или несколько интерфейсов. Интерфейс — это класс, содержащий только чисто виртуальные функции. Связь между приложением и подключаемыми модулями осуществляется через виртуальную таблицу интерфейса. В этом разделе мы основное внимание уделим способам взаимодействия приложения Qt с подключаемым модулем через его интерфейсы, а в следующем разделе покажем, как можно реализовать подключаемый модуль. </p>
<p class="paragraph">
Чтобы продемонстрировать конкретный пример, создадим простое приложение Text Art (искусство отображения текста), показанное на рис. 19.3. Специальные эффекты отображения текста обеспечиваются подключаемыми модулями; приложение получает список текстовых эффектов, создаваемых каждым подключаемым модулем, и проходит в цикле по этому списку, показывая результат каждого эффекта в соответствующем элементе списка QListWidget. </p>
<div>
<img src="data:image/jpg;base64,iVBORw0KGgoAAAANSUhEUgAAARgAAADJCAMAAADPRd2AAAAACXBIWXMAAAsTAAALEwEAmpwYAAAKT2lDQ1BQaG90b3Nob3AgSUNDIHByb2ZpbGUAAHjanVNnVFPpFj333vRCS4iAlEtvUhUIIFJCi4AUkSYqIQkQSoghodkVUcERRUUEG8igiAOOjoCMFVEsDIoK2AfkIaKOg6OIisr74Xuja9a89+bN/rXXPues852zzwfACAyWSDNRNYAMqUIeEeCDx8TG4eQuQIEKJHAAEAizZCFz/SMBAPh+PDwrIsAHvgABeNMLCADATZvAMByH/w/qQplcAYCEAcB0kThLCIAUAEB6jkKmAEBGAYCdmCZTAKAEAGDLY2LjAFAtAGAnf+bTAICd+Jl7AQBblCEVAaCRACATZYhEAGg7AKzPVopFAFgwABRmS8Q5ANgtADBJV2ZIALC3AMDOEAuyAAgMADBRiIUpAAR7AGDIIyN4AISZABRG8lc88SuuEOcqAAB4mbI8uSQ5RYFbCC1xB1dXLh4ozkkXKxQ2YQJhmkAuwnmZGTKBNA/g88wAAKCRFRHgg/P9eM4Ors7ONo62Dl8t6r8G/yJiYuP+5c+rcEAAAOF0ftH+LC+zGoA7BoBt/qIl7gRoXgugdfeLZrIPQLUAoOnaV/Nw+H48PEWhkLnZ2eXk5NhKxEJbYcpXff5nwl/AV/1s+X48/Pf14L7iJIEyXYFHBPjgwsz0TKUcz5IJhGLc5o9H/LcL//wd0yLESWK5WCoU41EScY5EmozzMqUiiUKSKcUl0v9k4t8s+wM+3zUAsGo+AXuRLahdYwP2SycQWHTA4vcAAPK7b8HUKAgDgGiD4c93/+8//UegJQCAZkmScQAAXkQkLlTKsz/HCAAARKCBKrBBG/TBGCzABhzBBdzBC/xgNoRCJMTCQhBCCmSAHHJgKayCQiiGzbAdKmAv1EAdNMBRaIaTcA4uwlW4Dj1wD/phCJ7BKLyBCQRByAgTYSHaiAFiilgjjggXmYX4IcFIBBKLJCDJiBRRIkuRNUgxUopUIFVIHfI9cgI5h1xGupE7yAAygvyGvEcxlIGyUT3UDLVDuag3GoRGogvQZHQxmo8WoJvQcrQaPYw2oefQq2gP2o8+Q8cwwOgYBzPEbDAuxsNCsTgsCZNjy7EirAyrxhqwVqwDu4n1Y8+xdwQSgUXACTYEd0IgYR5BSFhMWE7YSKggHCQ0EdoJNwkDhFHCJyKTqEu0JroR+cQYYjIxh1hILCPWEo8TLxB7iEPENyQSiUMyJ7mQAkmxpFTSEtJG0m5SI+ksqZs0SBojk8naZGuyBzmULCAryIXkneTD5DPkG+Qh8lsKnWJAcaT4U+IoUspqShnlEOU05QZlmDJBVaOaUt2ooVQRNY9aQq2htlKvUYeoEzR1mjnNgxZJS6WtopXTGmgXaPdpr+h0uhHdlR5Ol9BX0svpR+iX6AP0dwwNhhWDx4hnKBmbGAcYZxl3GK+YTKYZ04sZx1QwNzHrmOeZD5lvVVgqtip8FZHKCpVKlSaVGyovVKmqpqreqgtV81XLVI+pXlN9rkZVM1PjqQnUlqtVqp1Q61MbU2epO6iHqmeob1Q/pH5Z/YkGWcNMw09DpFGgsV/jvMYgC2MZs3gsIWsNq4Z1gTXEJrHN2Xx2KruY/R27iz2qqaE5QzNKM1ezUvOUZj8H45hx+Jx0TgnnKKeX836K3hTvKeIpG6Y0TLkxZVxrqpaXllirSKtRq0frvTau7aedpr1Fu1n7gQ5Bx0onXCdHZ4/OBZ3nU9lT3acKpxZNPTr1ri6qa6UbobtEd79up+6Ynr5egJ5Mb6feeb3n+hx9L/1U/W36p/VHDFgGswwkBtsMzhg8xTVxbzwdL8fb8VFDXcNAQ6VhlWGX4YSRudE8o9VGjUYPjGnGXOMk423GbcajJgYmISZLTepN7ppSTbmmKaY7TDtMx83MzaLN1pk1mz0x1zLnm+eb15vft2BaeFostqi2uGVJsuRaplnutrxuhVo5WaVYVVpds0atna0l1rutu6cRp7lOk06rntZnw7Dxtsm2qbcZsOXYBtuutm22fWFnYhdnt8Wuw+6TvZN9un2N/T0HDYfZDqsdWh1+c7RyFDpWOt6azpzuP33F9JbpL2dYzxDP2DPjthPLKcRpnVOb00dnF2e5c4PziIuJS4LLLpc+Lpsbxt3IveRKdPVxXeF60vWdm7Obwu2o26/uNu5p7ofcn8w0nymeWTNz0MPIQ+BR5dE/C5+VMGvfrH5PQ0+BZ7XnIy9jL5FXrdewt6V3qvdh7xc+9j5yn+M+4zw33jLeWV/MN8C3yLfLT8Nvnl+F30N/I/9k/3r/0QCngCUBZwOJgUGBWwL7+Hp8Ib+OPzrbZfay2e1BjKC5QRVBj4KtguXBrSFoyOyQrSH355jOkc5pDoVQfujW0Adh5mGLw34MJ4WHhVeGP45wiFga0TGXNXfR3ENz30T6RJZE3ptnMU85ry1KNSo+qi5qPNo3ujS6P8YuZlnM1VidWElsSxw5LiquNm5svt/87fOH4p3iC+N7F5gvyF1weaHOwvSFpxapLhIsOpZATIhOOJTwQRAqqBaMJfITdyWOCnnCHcJnIi/RNtGI2ENcKh5O8kgqTXqS7JG8NXkkxTOlLOW5hCepkLxMDUzdmzqeFpp2IG0yPTq9MYOSkZBxQqohTZO2Z+pn5mZ2y6xlhbL+xW6Lty8elQfJa7OQrAVZLQq2QqboVFoo1yoHsmdlV2a/zYnKOZarnivN7cyzytuQN5zvn//tEsIS4ZK2pYZLVy0dWOa9rGo5sjxxedsK4xUFK4ZWBqw8uIq2Km3VT6vtV5eufr0mek1rgV7ByoLBtQFr6wtVCuWFfevc1+1dT1gvWd+1YfqGnRs+FYmKrhTbF5cVf9go3HjlG4dvyr+Z3JS0qavEuWTPZtJm6ebeLZ5bDpaql+aXDm4N2dq0Dd9WtO319kXbL5fNKNu7g7ZDuaO/PLi8ZafJzs07P1SkVPRU+lQ27tLdtWHX+G7R7ht7vPY07NXbW7z3/T7JvttVAVVN1WbVZftJ+7P3P66Jqun4lvttXa1ObXHtxwPSA/0HIw6217nU1R3SPVRSj9Yr60cOxx++/p3vdy0NNg1VjZzG4iNwRHnk6fcJ3/ceDTradox7rOEH0x92HWcdL2pCmvKaRptTmvtbYlu6T8w+0dbq3nr8R9sfD5w0PFl5SvNUyWna6YLTk2fyz4ydlZ19fi753GDborZ752PO32oPb++6EHTh0kX/i+c7vDvOXPK4dPKy2+UTV7hXmq86X23qdOo8/pPTT8e7nLuarrlca7nuer21e2b36RueN87d9L158Rb/1tWeOT3dvfN6b/fF9/XfFt1+cif9zsu72Xcn7q28T7xf9EDtQdlD3YfVP1v+3Njv3H9qwHeg89HcR/cGhYPP/pH1jw9DBY+Zj8uGDYbrnjg+OTniP3L96fynQ89kzyaeF/6i/suuFxYvfvjV69fO0ZjRoZfyl5O/bXyl/erA6xmv28bCxh6+yXgzMV70VvvtwXfcdx3vo98PT+R8IH8o/2j5sfVT0Kf7kxmTk/8EA5jz/GMzLdsAAAAgY0hSTQAAeiUAAICDAAD5/wAAgOkAAHUwAADqYAAAOpgAABdvkl/FRgAAAwBQTFRFAAAA////xMTEe3t7AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAaXNP7QAAG3dJREFUeNrsXdli27gOxSHy/39MnvuAhSBFOW7cSZteq9Np4kUiQewrIO/rdH0I/gxoCJGu8dv8KX7dXnn66vrwm9c3u56fB31jx+HSZv+8IXElpSNcVESk+89dRFR6/PhPIogQfaV0tONmlQgKJHqAbvv2TwaE9BMiKGFvOCnF22p/RUQcBG1iDkX+GRHWc8e23d67dBHpoG92AUzvCxhERJDsmRuQfzhkugOob/LKzx7tDpbwX+IOHf8SXJKtJuo4/+y+X96Ka33ilX9ZXE/A6Ftwl6u9FbwrPaiItA8RUWO0oAgIClxUCyEsrxD5SnnBfyP23+u354tV6WZ5nv1lvrp88nLFLT/b7vzE6adFcWnlR3RR5D59abbHFEuyCCmh+NvCXz4UXoyly13wyQ1w+yE8+jY+eUI5d3sMXSrRvkKBIL4b2+cCZkyBdrvlh8s7gWPeiw+BhPsjSSyv30fcg48BDyxbA1yBsxtQtnsz34pb8g4CuBwtH6INNlxnYmPqTzjegue7YR5gvTMPn+d1ueDh7kFZJAiStOXZC3Zr/2P3zPfLjViXsCx1/tnWR9IWnnyCwaHynstu8va87jTfZd3b/MZlBbywB/sfyPkzWm+TvJ5iYsEinS0ZHhsPXbluJUBhMtvT3f22CwY65U8eWPh4PDGeeWIa85fC4MuL+1cJ+vNab0DrjeCf8lf9bZdhTOvtQ7qdGGR89Wbgdy9/f2LBxVA6Trg51QzmL8SCM6CJPig0MI1vfJHm0omthaB+XwsfZsMTitX/z4Vg3GgMmntfVSSahQC+UWb6ZzgdVW/OWy1rUET4cZB+YNqv347GuITMyFdu1/XXbwGK4CPMSRdXfbJm06N1vEau4K9gI8zr3J+3uKcNyePt+vSrnBjtrantGMNJYp+YbTcAoNz7Avi8Yvg1tzIGhdJOt1OKjI7zdw7H3psvq62nop8azmeMRWtnuNzDFU3a75cm+ytDRPRmE6rXg9C4UZNdXGtAR0X0xvnx/EE/8h8dfChf9rPeHIw+UtM4zlKJEJGwlaQ4M0cbMj2ZT3hFbvYDPCY04rIyagW0TuZb/VtzXeVVat9pCV0oEFLirfh8u/VzKu328iHay/6rR6P+DEzmPt1on/s4iQfujIPYY/VjtVGkiy17uICgKCkeXdYuSumCDdAQHa1LY4Tc7f0Gix3pEO3jIFwo4kH9z8RyrktGSA4V+nPgiNHIo0xa7kOhuAULkWcVggyv93nWXRmI1e3eo2/8t7t2z5C6EFHpw5ITVASivTfempOGcI+YfqygtwBoj4OdnA0H0HOFFg2KcDFOPPQCYYeLiAzICHLDwgvZTl/vFo/uTkQ6hojaiVKEPDJm8/l2O8kHGF+QrSP4AKa3nPOf9fYQd3Giqk6FFPlQ9WLRbSpkZKE09aB6G1fWS2dUWkClYiGADlBGv2KEoXEzaOOoHC+EadbDELEj6w1dRFpixRUwriMSWBWxMQyMeE5L8v1nGsZEGeMUbCpdpIsuVOGstxk5jMLfx+giKp0Y23di3T2iBCdSX86pMQzOFkvtq0550jv30IJF3IoL/Rm4OFTHcFzp67MYR6I6dgnjyNbFKcYERpfWGoYoKDJ4YzG1+AJ3HNbFCl/3rhdwAEeNm8u7rKoLngRJiCggldHCTpSV6+3aJUSNjTAUKsgICu68k6SGCj20MFzYVtWfWis6lKsbVQrwlkdMWNBiMsmZ8VngsSLwGP3y/BmmOpkDrHHLfjlVxSluHxLM9BjBlc24gA9sPC256gAX/3TKYsx3V8nxnLOjn0wsLos8hyaVBh4T0z1De2E59aP/P/bxYYJ3FdgMAXR66I3qcWPARkgnXPioevFTaswlIfIaSwSvahoKZnGuG8LP/AV0t4P2UzRiYky1NYNtuATv5RmXewgY0WPC4V4xBk+a7jtcHBHCGDYe0zExIRB9uNfAmaSrMqifO2ahlh1zW2RlZlQRUVLoV2WcHZ85IigsasyKlp85VFFYgqI1tKaqwnpOI1Tsi8GmppWjCQCBXjwIejJ+Q+bRSInrkRvGFGHaG1kMpqlyPaAFRAxcZhy02gCQz2J8vLjVunH8qgqbXqfjZNXPdbaBXGvhMQfCHR5cbtMDsWNMDX0PAEC31D23kdp6c2yGNS12T8sPEFR+LGdd+YgxTrVojWb7rcnGuQLtDZt217W11rSpAEE2FK1acMPZsrW4EnZmVjHOGNgYZjEp59uaGjp5DX5PwSx0D8Zuaz82lQJjmttpPe0tf12LjQCI9IHFHOgySHKQKZwmj6CRe/nO4g/wuNKJC+ZRVA1cGTYdi4uAF38UbqI1++E8k0qwfqkFwiSpQyhdONqqxAjq2QKZuJR+OJxKTPzsPK4kB+ZbtH2dFMgkdHtdy5cfJO3QXUaFep533dfVN84M7fBqQVRGa0XNg8jgqCvoph726bWj9Ab07QxTRGcaSHu4UEyrZ1U/4jbEr2fl3Qvs1jW5i9mNRZ/D5D0tfnJ2jMWbUng7JmJPO2Xs2rtIc6u35Mc0eSVO8t8HnD5zFj6rFlU5ev1OM37Yevt4PkbyRy++/IHD506ctbly0YxPQd5B2tD6pqMKp1TG/9OrL87wN7qs4RMJn+/7WhQgps/3TUbVHWo2WZtU9b7cugY1MOZ9FalUogSCd/pzdYtB0+XDNzFteszHqxymiQzsnq5vu1r4WmEOfb66jEwc+sBrt4LQ06nNT/K9Bhd6AwQD6KIC873jlTUoQ/PlrxobR/MtXMz9e3kVlEPQBaItkh76q2sozvD7groncC8c3F16+LS+2ezW9BoN6V31NxFpf43JKIf5jvQmOfI/tbl7g0hvEp5v/q6TsbjSS2vzcL9eIuDfAZgmpDlRwBaRq1cXAWY664t+EgpfZVQvHIudTSmrfPWekjzmk7q/b2QYn9UB/yau9MQHPv7bRfzyakvBqIdUo5Yy68L3Mnj/WK155FLnBrl8lqVKUzYfpwe50XqzYM34K1BlL5H+npIGSDgbKEJpPXNe/rRJwL1wGuXsz3RwTEHCl6CypXpALIPRsYl/npQ8bvz5ZyGPM7Nw/ysCFqdPeFhueLEo8KcBgy98YGu2sO+8fuL+Vqh8pRaIWxoI/3SUgPxkA1zz4Rz7WdgAJr/OUwYq+1oaPaxdH3hhbophOT7AX0BK9y8fjhkLOObPuRHPsbjFtDOiEY4x+nTC7beCaAs9cjXoi2450+FZ0AgCyMoiMMunHjEyh6sxXwT2oQnQIE2aFRS95tqzfKZfhcZ6srjHnLvDn0TXm1xKg/CANTu90pmvJGRb53Y1vsA6YWleT9iyKASBjVzKivfbj3bd9AJQz3a5FfUbcJEapWJY/qQBZpzstCcQ44wWwLOyjvfwxXLmSz+bQa+twD0fgpTy6ZRVfCDXC485pHz/ksqEu9o/EwxHqKFB0BZ1jjdsEqU8pvSbKWxoKmK44Bb3/3Ov9Vj2yCWPK0H4dX/GyXEWxzRwxJEls9SS9Az54GELTmWscNTsscQtqz8bfawZPC7AS2+m0NzyNR6YbwMLKYk0amvxXmvtk4Y7iZvtyo0w6wB4/lrr2BTfwuPaPH9JTjXTPyMps0mAaxfjcxk0XmeZm5D7bBrv00XBx9aJh0Ser6Wwmm0lXdTRrCXGtU5NnL7x33VleDwRCYtT3Yw01FOLM+uEVKp7aikkMqe2i9KrovbGRVU7pBenTwkO4ar0LMrAR5goS5eilSsi6wlsH1n610W6NNeJDhwC0aRmGoRLK7DNRgwkjjpDS6QVjfVl1mhfuWFvjMJ3nvk4CEiXrqkbT+4ELlXzec4ATfO9rjA2MfNqjaqbN8Mz2qGfAfaGphARP6XeCrlLRD4xQ6AoPBkUUe/A1i1buCUqMFClLPhQQ1y4jkQd/yyfwdUttrD7aSs90JQCLuZ87+G4kCGZVhoqQx87hzF2iLWpHukFjQSkd+67KS9kyUAXQZQcBj55OEB1ipyzMgjBCgU+0jMc6bxNyiNto7scV5VaFBk1iAzk7dpO30UmY3ttlwlpt850NuLbGu8FSnvN30x4D4pi1GVPA5PBOeRTV3TvcuxEFytoU7LfeIUjD3wMBv7VIgyNvnm9jUNTEfNUz+QBQRu9i5KkoHvp3U3fvm77jnI0zk7mhMDeT6piainX06lCiFZzqI5ip6aNhjFdjs0EcqH+9FHwp2rDqW/pwRwIXs6iPHVRjGEcTx9GHMyRhmz4OBWXVioR4IWn6b66lqRd/BeAWEj3bEQaxqgLBz5W3xqddpYVRoj32jcbFEoXrdqAaQlRCCU3PaXdWWTL7j2LCLDuFFVueuNF2zaPuI8idL32jTzXNyeP8ZqrMyklpvTDW8pbjzEIqkaubI/tnh9wzb69LplrxRo3ye8nzdJTAuc98cKcF5cZZkH67nLG7iMU9T+bb8gP/wT3rXhLZ2UkT/rSLuaDVaiqtqZq4wDQz+YbJiLgBO/VaMTm7OEuwzM5cW9WeSg19j+q0lmaCtyejekd5OoxbNWpyEKRaVo4HJfK2zQx18I6LirptDIFRwfgWluXjk856skR1H/kVFcR6eQYYwiFrVX94j5yMbU3J38sMs0+3heTcp65RDtoEw3JZ8pza/m/17MVc/Nosq4mnIaVcQaPYcypk+9qhtuKRx8ro+htJfRNoHX0ISO12+xcEKigUvF3o2db1BhpAdgPTs+1HhppcVDOfrHaRYILhXGLd7OK671/zkpXVsgGWIkbsHShMJzBpY2/4YNK03D4WAMfLl0meqX27IarqtY/VlNxabMSkypyzcHF1GNqCO9GgcMp2LK+ZnGlrcB1tZVcjw/UyVQu6xfRmCy21lRzshmvM7WyDqR7Ag1oyfggS+V6PN8+qy1XpWEzZcOWNhoj0a2E4oiDK2/HsUksWJw3FHjiEO/l9Obc1FlUxSQmymZFmjGsXAmyYRUGJMOwY/jpsPRUkaZN1fhvqDPTP1Vn+khwKeyCKH/vJSbFqf+sfCAEdMOJx+gtZHTEm/TXexaP9brGgQoCQHqXwTFr7Wg2Wn594lj4vhBBW3Mwmd9MBNTWNDmDpheXxSA4KBBUt37C0UA3CnjCJpVh7o6FzVhfhPnx8OmZZaTp8mihI2KQrL4qcFH40SkKa3kxNZyu6JvH27hn9G4sEXecrOFm3LNx9c2dAiwz4QO8D+AidQ0v/ZOtOhy7D6m2glm1CF839jDnPpwhzV5WR3lBkM2Txohl1AEA0ZW8pgB4IgDnt+TcJVMKi98eNQ0BWre1pgDNV/VJoIOP2yZ9LbecvAm44RgAwk3Q7BJZeRyFe+zDJmZc6UJKf0XoGr8W3Pv0/V3Dw2a2Jv+ecaU/kXD5VBDuEEjjLd7M93ENOmKJg/Nqwu4WZVvc1n84mu+R+PCtOIkHQ44dFztqUbhmWISX6vqbUCeuENlGlf0VaZsz7MwMAWGJsnELhrN6/SnplMODQLDg5IRgFacioeDhryAlLgbmxX5jYgh3euPmIONNeB1TC0AJUKwJZZhG5BNNbr6D+4JhtJESs1Gi/WAmp/IaJVlNprP4G8yYEyHCbP1AkVHkowOflu3wp3PwLHxgnVSewi08iYGpOh9Iiodmnxmi9d4OYp1B/7brZoBMCo3ndKRfuZo5RobgI0I/Xyjnwn890eBRL+Eu2rXnOFiL69aCkfbVZ9Y+eMAXxJIRoPWgtakyqI3V/turi/eid4gYdGJ26isVNYigfhfBl6o20JvIEM0QQ7PJtd8i4dTBEF2miOwOJaJ8ATIsrk0SX0g2Hwq4t6p7NVjrMnqXb8n9d1/MdDtrt05WFL7QfHyOXO033VmfwDnvywQvt+v8tup2GgyiTXwzR1YXd6S+MB42dEbvtfnF4oSZLkRzXgr1e+Zf9NILv7QS7HoXb/5FWkL02vzCzWIwXfS3otzlD/wnPCYk0myLNzHoFRGQ+oA+yiN+TpxG7d33qUIlKLXELD6R9c8abC6VCII/q7kDZTrRm7yMJYtSzSj9U/7AwVOP8gFexUVv3iWd+E03/Seu7Jyo0TfiDZNi5KCtYdL/d2yZwZUmpx6i/9eUFE0vNFucvK/i6mop5t6kVDkKI9XskliN/0fy8sgoshtIhj1bapARemn8/2MwLM3UPZD+bqMYBPPunHgFCxg8JsMSloqTjfv1VfUGrbWfSFBhXWdHBbIBzdqSKwZfbRz4IzGRmRlOyRYGZE2c5q+ixz/CYSIlGefS9Rr3RGsn5GFb0woOpVzy43RHw5iPJxwZUeJ2rQZlr1knXJ3HMw2FPw5nHoal5pajMqeJSLPy1ubOUK3pOOlhRwOwNmH4WYpvmgTnnHr/iCVka+aB9+ala3V2D6ROZxMAGIMU/qz+putkg8djCbtY6ZXaECsV6RiXATWWiYolUwXCH9j4FZPHPHT4ok7NgQ0WdLiwgAfFETsHtEJ+qNcUnmrG+9HTEJHeWmtjET2XkW2SLVqBH0dBF2piYMwVZxZSqXU41H6d9BQw2Yqj8AO9GXueycMdRHVbZu9fJs4RpTBqT5L7UVBBYb6fhdx0gACs8KQtEC1SiT5/arrWfx7GYOExZ8lx6ftl5SVe9tdRhy4i55L57XK0HX4oj2nT0r7RY2ZFxRjdqrgUOucbRV3CrJpes2fxE+Ei+HBO8GD5avkV3g1kxlraEEbqXqLc2FiM4LUe3t8PF9fFIqPqCpjUaak9GjzY6EEOoXp3kpvSzFIwJvhRqkzUgllXs636JIrs0oZuVjpdGz3xKZsDP2xy0+ym9+HTPh7PJWROuZbnutIXdeZniSWf3HjTM3xWYj4Fhaes1R/DYjy98iPt5J+8nd/JYrwnkmc7vMOQRVh7+XL/gd7H/1hem2avM83wfU0fTOT5vnFm9VNJ9Np8Y8yGMjH1740xG5OJNilvjJFV8feayDdcdi1u9ze9Lw91tDSd3ldSkoVPtJ+d4Z9eLW1sIBsI/myiLOPCP9Kt/ZX55rDuHEO9cy0gn3Xu/NslNXPetXx1hlv3QG0fIhR4ly7rZPWzeS9EHzYh/eT7Sqr0Ppo1SdWh6EOoP5iRZ4eA7h2gv+LMR28+ca8nwil/OJOZaZrtK+zFMcZ7YHVVr2e3JkHKnwwWk9AaPcO/cpchIsLWNQqux9/Zh+bXQOMNGz188gL+U8l/SAvKRhAfr4P433I5lAq397WwXq7ZDvybj/GbdTxIhGjlqZlyfy1kruMrYkDkLyYqczYTniNXf08tF5fO3J+WLcf6sXx0dhfCPimTdzP+1ucKDqktnBzE773fD6WZCaKVZYArvjI3yhixYSs8tQjIzHIsDWiJ39E2BaUT4jYvsWyPpdAzw0P1n5h3cvXKredgnRMjBw/2RsyUkTIYcEbnrFcm6qQQcxc7+CzfzJuPRaO9ZYCPTwhCdH9CPrHMBwK2b0Wait/Z3dVMuJR+rkC0zC32H7NfV1XjpiFcG7piegwobUP7nPU6UbsOcsLkUlxxNBFq/rqcnORs2GXJC45fKSYIiShRduTTJm/wtefAsS/r9Na3i9Ze+YYdRM/P0oBt4wgXkkK2CJ+wKZAqQ3KR03R9oAA2yJfZu/V5Nmpms/VPHVq6TTnqT3dvsW5qGAK0YRUodb7vDpcCh7mnig1luzwMGpa6vbrf9c2EykQwqYiU65iP5WGYL3bWMrTsILnelaHm4AcZAh8FlKsWHvg9s2ly0M+c/zUFgBE/WNrFIzgP57CMTKjGvnFZhpOV7sfe9S95Tq8NwWdnltJaWnJcqnsAPCU7W8MHL11YMctQ3phck7MglkTwaLdLY1jGd72eEtuHfO1O3V405zticuTZGtEb9so6F6u0fa+ti+H0lk2fN5Ws6izOQr2jmA0fIU0hmQyY5KUS38psiuY7cZrZtzJ75NJlQfgVUmht3VNTElmbfcyu1kh+n0IxHoTZeH0iKWpmU2IEZmv9flH/0AU22DFP1bCmi0AdwUmK9JFT9GIjc/Ye1XeuOTo+EolqI+piWFn9BOuB7v0cOStQTGZ6fzOCFTGSG2VLaa4d6gMaBVnW3ptlXFPQqbPey6QCgUp0/De4dm2C0TvGGA0DGFj7/MJH+rRsPxn68Dp+MYbGBWJzHmjFGU7uAEl8yOiDd1qlwct5b6o+W5VhjidhLIAlYTg6cyHajfqwgyFd5lydBbUn7ktXCkVVujbt0ji/FFPgUDLDhUtHXJafnemUWbil0XadtZKV3BLt0JPNIDqKBmlNDVXmaLZNahbmTUydyfrNSxkZQAHUO4lZcb0EHXPlyBBKF6wtz2Lg1zxGTlIK4SkVC6QwcJbhntsQ5fyoo5QjTE78C3DMfuwIbuncD9sjuU1dSBmd7Xh7sYTspjpGNHqLYYLGGOeAQJjLElkJ0bUPRAai43D3hfYo5ErtM/nEInbqcBFOU2ACZfbVJVFEdJFbwULhTVi9jyWrlpC8pEwdc2yJu1EoGlSG1DFURZTSJr6atFVjwEnSKkqqNqWoqJJq8wpcRmrKvZbPTqwoc6GzFzXj5JCDr2KdWIRY8ufAiw3HCFpgLmZjInh+wG5WmOZYzJB2Ec7ok+hNKMNqDJPvRBMYGwyg07FirJVxX0bdw7QvYlBLqxpDFPDVWBPnFIV4NfX0nCCBonw4RFzZjyGVi+kVd59cmMkuk+PGybj+6jwDIhCV2SF7zhCC/5B0Boh0oXROWpnTUVitV2KOwcDqwQsXBXOsYJ3NXpUJTlUseEn6hXzDyf3c1l7s+jQVAgtyeEWOAaoCpapDTpX95MFyFZ5lCITB0Ct9g5/59M/FGWLkj6L4ouXrGbclK5nP2n2ksork8kiHxDxbpDInmKWRoe6CqzmUz5nK4crbnClV1q29i/QuRIxS6V3QpXtncAwbOdfLHBjA9fdAFIKUYTUTVueJxmlJmRFZvWVFIBQ7N2G+etRk+Wx1OyyujMUnN5nqao8WI7reEFJNb6nOxquTYlm173B1n6VvhEXDKloCCLbubofVgr7YttNTJheXCRetlFj+k+LxKyoBiqV98WBwP5eUPbjxAPyay1WmKlH3WE1JwZAYf5pUV5QILA5QFJ1e0uCdNhNzHHFMpQ/ZJZhDgq2/SBqYZRD31Jq4sraYaZXqz03XxNOLSZWLwoXZWAh1vhJlqVo0jPklsPMGcVZHnJPldNRc3AyLG0cOtFkPdXPrHEtmHuxj9ZftD7l68NrUqXic1lRBvVgzZSzELBFlOes6eTc8EqSAZOAmixunWgMoel7KyABzeAt4rQxZ7VoW3ZKuHrgilZ0FYvCBvcQJhHBtCu4h+MyB7DGIPx6BfiUG1LpAmvh8TC+t9gmiOluTL6/m7//4hX9/i1+61Cf1pYtEinCVfdTYjKuVQJXsLy1kvgQYL68sbs3to0t4cv6+aEWo3qstmvlCMJUQyv8GAJ/ioWxYeLJWAAAAAElFTkSuQmCC" />
</div>
<p class="paragraph">
Рис. 19.3. Приложение Text Art. </p>
<p class="paragraph">
В приложении Text Art определяется один интерфейс: </p>
<p class="paragraph">
01 class TextArtInterface </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 public: </p>
<p class="paragraph">
04 virtual ~TextArtInterface() { } </p>
<p class="paragraph">
05 virtual QStringList effects() const = 0; </p>
<p class="paragraph">
06 virtual QPixmap applyEffect(const QString &effect, </p>
<p class="paragraph">
07 const QString &text, </p>
<p class="paragraph">
08 const QFont &font, </p>
<p class="paragraph">
09 const QSize &size, </p>
<p class="paragraph">
10 const QPen &pen, </p>
<p class="paragraph">
11 const QBrush &brush) = 0; </p>
<p class="paragraph">
12 }; </p>
<p class="paragraph">
13 Q_DECLARE_INTERFACE(TextArtInterface, </p>
<p class="paragraph">
14 "com.software-inc.TextArt.TextArtInterface/1.0") </p>
<p class="paragraph">
В классе интерфейса обычно объявляются виртуальный деструктор, виртуальная функция, возвращающая список QStringList, и одна или несколько других виртуальных функций. Деструктор объявляется прежде всего для того, чтобы компилятор не жаловался на отсутствие виртуального деструктора в классе, который имеет виртуальные функции. В данном примере функция effects() возвращает список текстовых эффектов, которые могут создаваться подключаемым модулем. Этот список можно рассматривать как список ключей. При каждом вызове одной из функций мы передаем эти ключи в качестве первого аргумента, позволяя реализовать в одном подключаемом модуле несколько эффектов. </p>
<p class="paragraph">
В конце мы используем макрос Q_DECLARE_INTERFACE() для назначения некоторого идентификатора интерфейсу. Этот идентификатор обычно имеет четыре компонента: инвертированное имя домена, определяющее создателя интерфейса, имя приложения, имя интерфейса и номер версии. При любом изменении интерфейса (например, при добавлении новой виртуальной функции или при изменении сигнатуры существующей функции) мы должны не забыть увеличить номер версии; в противном случае приложение может завершиться аварийно при попытке получения доступа к старой версии подключаемого модуля. </p>
<p class="paragraph">
Это приложение реализуется в виде класса TextArtDialog. Мы будем показывать только тот программный код, который связан с применением подключаемых модулей. Давайте начнем с конструктора: </p>
<p class="paragraph">
01 TextArtDialog::TextArtDialog(const QString &text, QWidget *parent) </p>
<p class="paragraph">
02 : QDialog(parent) </p>
<p class="paragraph">
03 { </p>
<p class="paragraph">
04 listWidget = new QListWidget; </p>
<p class="paragraph">
05 listWidget->setViewMode(QListWidget::IconMode); </p>
<p class="paragraph">
06 listWidget->setMovement(QListWidget::Static); </p>
<p class="paragraph">
07 listWidget->setIconSize(QSize(260, 80)); </p>
<p class="paragraph">
08 … </p>
<p class="paragraph">
09 loadPlugins(); </p>
<p class="paragraph">
10 populateListWidget(text); </p>
<p class="paragraph">
11 … </p>
<p class="paragraph">
12 } </p>
<p class="paragraph">
Конструктор создает виджет QListWidget, содержащий список доступных эффектов. Он вызывает закрытую функцию loadPlugins() для поиска и загрузки всех подключаемых модулей, реализующих интерфейс TextArtInterface, и заполняет список виджетов с помощью вызова другой закрытой функции — populateListWidget(). </p>
<p class="paragraph">
01 void TextArtDialog::loadPlugins() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 QDir pluginDir(QApplication::applicationDirPath()); </p>
<p class="paragraph">
04 #if defined(Q_OS_WIN) </p>
<p class="paragraph">
05 if (pluginDir.dirName().toLower() == "debug" </p>
<p class="paragraph">
06 || pluginDir.dirName().toLower() == "release") </p>
<p class="paragraph">
07 pluginDir.cdUp(); </p>
<p class="paragraph">
08 #elif defined(Q_OS_MAC) </p>
<p class="paragraph">
09 if (pluginDir.dirName() == "MacOS") { </p>
<p class="paragraph">
10 pluginDir.cdUp(); </p>
<p class="paragraph">
11 pluginDir.cdUp(); </p>
<p class="paragraph">
12 pluginDir.cdUp(); </p>
<p class="paragraph">
13 } </p>
<p class="paragraph">
14 #endif </p>
<p class="paragraph">
15 if (!pluginDir.cd("plugins")) </p>
<p class="paragraph">
16 return; </p>
<p class="paragraph">
17 foreach (QString fileName, pluginDir.entryList(QDir::Files)) { </p>
<p class="paragraph">
18 QPluginLoader loader(pluginDir.absoluteFilePath(fileName)); </p>
<p class="paragraph">
19 if (TextArtInterface *interface = </p>
<p class="paragraph">
20 qobject_cast<TextArtInterface *>(loader.instance())) </p>
<p class="paragraph">
21 interfaces.append(interface); </p>
<p class="paragraph">
22 } </p>
<p class="paragraph">
23 } </p>
<p class="paragraph">
В функции loadPlugins() мы пытаемся загрузить все файлы, находящиеся в каталоге приложения plugins. (В Windows исполняемый модуль приложения обычно находится в подкаталоге debug или release, поэтому поднимаемся на один каталог выше. В Mac OS X учитываем структуру группового каталога (bundle directory).) </p>
<p class="paragraph">
Если файл, который мы пытаемся загрузить, является подключаемым модулем Qt и имеет ту же саму версию Qt, какую имеет приложение, функция QPluginLoader::instance() возвратит указатель QObject *, ссылающийся на подключаемый модуль Qt. Используем qobject_cast<T>() для проверки реализации в подключаемом модуле интерфейса TextArtInterface. При всяком успешном приведении типа мы добавляем интерфейс к списку интерфейсов приложения TextArtDialog (который имеет тип QList<TextArtInterface *>). </p>
<p class="paragraph">
Для некоторых приложений может потребоваться загрузка двух или более различных интерфейсов, и в этом случае программный код по получении этих интерфейсов мог бы выглядеть следующим образом: </p>
<p class="paragraph">
01 QObject *plugin = loader.instance(); </p>
<p class="paragraph">
02 if (TextArtInterface *i = qobject_cast<TextArtInterface *>(plugin)) </p>
<p class="paragraph">
03 textArtInterfaces.append(i); </p>
<p class="paragraph">
04 if (BorderArtInterface *i = qobject_cast<BorderArtInterface *>(plugin)) </p>
<p class="paragraph">
05 borderArtInterfaces.append(i); </p>
<p class="paragraph">
06 if (TextureInterface *i = qobject_cast<TextureInterface *>(plugin)) </p>
<p class="paragraph">
07 textureInterfaces.append(i); </p>
<p class="paragraph">
Тип одного подключаемого модуля может успешно приводиться к нескольким указателям интерфейсов, поскольку подключаемые модули могут обеспечивать несколько интерфейсов, используя множественное наследование. </p>
<p class="paragraph">
01 void TextArtDialog::populateListWidget(const QString &text) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 QSize iconSize = listWidget->iconSize(); </p>
<p class="paragraph">
04 QPen pen(QColor("darkseagreen")); </p>
<p class="paragraph">
05 QLinearGradient gradient(0, 0, iconSize.width() / 2, </p>
<p class="paragraph">
06 iconSize.height() / 2); </p>
<p class="paragraph">
07 gradient.setColorAt(0.0. QColor("darkolivegreen")); </p>
<p class="paragraph">
08 gradient.setColorAt(0.8, QColor("darkgreen")); </p>
<p class="paragraph">
09 gradient.setColorAt(1.0, QColor("lightgreen")); </p>
<p class="paragraph">
10 QFont font("Helvetica", iconSize.height(), QFont::Bold); </p>
<p class="paragraph">
11 foreach (TextArtInterface *interface, interfaces) { </p>
<p class="paragraph">
12 foreach (QString effect, interface->effects()) { </p>
<p class="paragraph">
13 QListWidgetItem *item = new QListWidgetItem( </p>
<p class="paragraph">
14 effect, listWidget); </p>
<p class="paragraph">
15 QPixmap pixmap = interface->applyEffect(effect, </p>
<p class="paragraph">
16 text, font, iconSize, pen, gradient); </p>
<p class="paragraph">
17 item->setData(Qt::DecorationRole, pixmap); </p>
<p class="paragraph">
18 } </p>
<p class="paragraph">
19 } </p>
<p class="paragraph">
20 listWidget->setCurrentRow(0); </p>
<p class="paragraph">
21 } </p>
<p class="paragraph">
Функция populateListWidget() начинается с создания некоторых переменных, передаваемых функции applyEffect(), в частности пера, линейного градиента и шрифта. Затем она просматривает в цикле все интерфейсы TextArtInterface, найденные функцией loadPlugins(). Для любого эффекта, обеспечиваемого каждым интерфейсом, создается новый элемент QListWidgetItem, текст которого определяет название создаваемого им эффекта, и создается QPixmap, используя applyEffect(). </p>
<p class="paragraph">
В данном разделе мы увидели, как можно загружать подключаемые модули, вызывая в конструкторе функцию loadPlugins(), и как можно их использовать в функции populateListWidget(). Программный код элегантно обрабатывает ситуации, когда подключаемые модули вообще не обеспечивают интерфейс TextArtInterface или когда только один из них или несколько обеспечивают такой интерфейс. Более того, другие подключаемые модули могут добавляться позже. При каждом запуске приложения производится загрузка всех подключаемых модулей, имеющих нужный интерфейс. Это позволяет легко расширять функциональность приложения без изменения самого приложения. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Написание подключаемых к приложению модулей</p>
<p class="paragraph">
Подключаемый к приложению модуль является подклассом QObject и интерфейсов, которые он собирается обеспечить. Прилагаемый к этой книге компакт-диск содержит два подключаемых модуля, предназначенных для приложения Text Art, представленного в предыдущем разделе, и показывающих, что это приложение правильно работает с несколькими подключаемыми модулями. </p>
<p class="paragraph">
Здесь мы рассмотрим программный код только одного из них — Basic Effects Plugin (модуль основных эффектов). Предполагаем, что исходный код подключаемого модуля находится в каталоге basiceffectsplugin и что приложение Text Art находится в параллельном каталоге textart. Ниже приводится объявление класса подключаемого модуля: </p>
<p class="paragraph">
01 class BasicEffectsPlugin </p>
<p class="paragraph">
02 : public QObject, public TextArtInterface </p>
<p class="paragraph">
03 { </p>
<p class="paragraph">
04 Q_OBJECT </p>
<p class="paragraph">
05 Q_INTERFACES(TextArtInterface) </p>
<p class="paragraph">
06 public: </p>
<p class="paragraph">
07 QStringList effects() const; </p>
<p class="paragraph">
08 QPixmap applyEffect(const QString &effect, const QString &text, </p>
<p class="paragraph">
09 const QFont &font, const QSize &size, </p>
<p class="paragraph">
10 const QPen &pen, const QBrush &brush); </p>
<p class="paragraph">
11 }; </p>
<p class="paragraph">
Этот подключаемый модуль реализует только один интерфейс — TextArtInterface. Кроме Q_OBJECT необходимо использовать макрос Q_INTERFACES() для каждого интерфейса, для которого создается подкласс, чтобы обеспечить безболезненное восприятие компилятором moc оператора приведения типа qobject_cast<T>(). </p>
<p class="paragraph">
01 QStringList BasicEffectsPlugin::effects() const </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 return QStringList() << "Plain" << "Outline" << "Shadow"; </p>
<p class="paragraph">
04 } </p>
<p class="paragraph">
Функция effects() возвращает список текстовых эффектов, поддерживаемых подключаемым модулем. Этот подключаемый модуль обеспечивает три эффекта, поэтому возвращаем список, содержащий имена каждого из них. </p>
<p class="paragraph">
Функция applyEffect() обеспечивает функциональность подключаемого модуля и слегка запутанна, поэтому рассмотрим ее по частям: </p>
<p class="paragraph">
01 QPixmap BasicEffectsPlugin::applyEffect(const QString &effect, </p>
<p class="paragraph">
02 const QString &text, const QFont &font, const QSize &size, </p>
<p class="paragraph">
03 const QPen &pen, const QBrush &brush) </p>
<p class="paragraph">
04 { </p>
<p class="paragraph">
05 QFont myFont = font; </p>
<p class="paragraph">
06 QFontMetrics metrics(myFont); </p>
<p class="paragraph">
07 while ((metrics.width(text) > size.width() || </p>
<p class="paragraph">
08 metrics.height() > size.height()) </p>
<p class="paragraph">
09 && myFont.pointSize() > 9) { </p>
<p class="paragraph">
10 myFont.setPointSize(myFont.pointSize() - 1); </p>
<p class="paragraph">
11 metrics = QFontMetrics(myFont); </p>
<p class="paragraph">
12 } </p>
<p class="paragraph">
Мы хотим обеспечить по мере возможности достаточность указанного размера для размещения заданного текста. По этой причине используем метрики шрифта и, если текст оказывается слишком большим, входим в цикл, где уменьшаем размер, пока он не окажется подходящим или не достигнет 9 точек, что соответствует нашему минимальному размеру. </p>
<p class="paragraph">
13 QPixmap pixmap(size); </p>
<p class="paragraph">
14 QPainter painter(&pixmap); </p>
<p class="paragraph">
15 painter.setFont(myFont); </p>
<p class="paragraph">
16 painter.setPen(pen); </p>
<p class="paragraph">
17 painter.setBrush(brush); </p>
<p class="paragraph">
18 painter.setRenderHint(QPainter::Antialiasing, true); </p>
<p class="paragraph">
19 painter.setRenderHint(QPainter::TextAntialiasing, true); </p>
<p class="paragraph">
20 painter.setRenderHint(QPainter::SmoothPixmapTransform, true); </p>
<p class="paragraph">
21 painter.eraseRect(pixmap.rect()); </p>
<p class="paragraph">
Мы создаем пиксельную карту требуемого размера и рисовальщик для рисования на пиксельной карте. Также устанавливаем некоторые особенности воспроизведения, чтобы обеспечить максимальное сглаживание при выводе текста. Вызов функции eraseRect() очищает пиксельную карту, заполняя ее цветом фона. </p>
<p class="paragraph">
22 if (effect == "Plain") { </p>
<p class="paragraph">
23 painter.setPen(Qt::NoPen); </p>
<p class="paragraph">
24 } else if (effect == "Outline") { </p>
<p class="paragraph">
25 QPen pen(Qt::black); </p>
<p class="paragraph">
26 pen.setWidthF(2.5); </p>
<p class="paragraph">
27 painter.setPen(pen); </p>
<p class="paragraph">
28 } else if (effect == "Shadow") { </p>
<p class="paragraph">
29 QPainterPath path; </p>
<p class="paragraph">
30 painter.setBrush(Qt::darkGray); </p>
<p class="paragraph">
31 path.addText(((size.width() - metrics.width(text)) / 2) + 3, </p>
<p class="paragraph">
32 (size.height() - metrics.descent()) + 3, myFont, text); </p>
<p class="paragraph">
33 painter.drawPath(path); </p>
<p class="paragraph">
34 painter.setBrush(brush); </p>
<p class="paragraph">
35 } </p>
<p class="paragraph">
Для эффекта «Plain» (простой) не требуется никакой рамки. Для эффекта «Outline» (рамка) игнорируем исходное перо и создаем наше собственное перо шириной в 2.5 пикселя. Для эффекта «Shadow» (тень) сначала рисуется тень, чтобы можно было выводить текст поверх нее. </p>
<p class="paragraph">
36 QPainterPath path; </p>
<p class="paragraph">
37 path.addText((size.width() - metrics.width(text)) / 2, </p>
<p class="paragraph">
38 size.height() - metrics.descent(), myFont, text); </p>
<p class="paragraph">
39 painter.drawPath(path); </p>
<p class="paragraph">
40 return pixmap; </p>
<p class="paragraph">
41 } </p>
<p class="paragraph">
Теперь у нас имеются перо и кисти, соответствующим образом установленные для каждого текстового эффекта, а для эффекта «Shadow» нарисована тень. После этого мы готовы воспроизвести текст. Текст центрируется по горизонтали и выводится достаточно далеко от нижнего края пиксельной карты, чтобы оставить достаточно места для размещения нижних выносных элементов. </p>
<p class="paragraph">
Q_EXPORT_PLUGIN2(basiceffectsplugin, BasicEffectsPlugin) </p>
<p class="paragraph">
В конце файла .cpp используем макрос Q_EXPORT_PLUGIN2(), чтобы этот подключаемый элемент был доступен для Qt. </p>
<p class="paragraph">
Файл .pro аналогичен файлу, который мы использовали ранее в данной главе для подключаемого модуля курсоров Windows: </p>
<p class="paragraph">
TEMPLATE = lib </p>
<p class="paragraph">
CONFIG += plugin </p>
<p class="paragraph">
HEADERS = ../textart/textartinterface.h \ </p>
<p class="paragraph">
basiceffectsplugin.h </p>
<p class="paragraph">
SOURCES = basiceffectsplugin.cpp </p>
<p class="paragraph">
DESTDIR =../textart/plugins </p>
<p class="paragraph">
Если данная глава повысила ваш интерес к подключаемым к приложению модулям, вы можете изучить имеющийся в Qt более сложный пример Plug & Paint (подключи и рисуй). Приложение поддерживает три различных интерфейса и включает в себя полезное диалоговое окно Plugin Information (информация о подключаемых модулях), которое содержит списки подключаемых модулей и интерфейсов, доступных в приложении. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Глава 20. Возможности, зависимые от платформы</p>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<div>
<img src="data:image/jpg;base64,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" />
</div>
<p class="paragraph">
В данной главе мы рассмотрим некоторые доступные программистам Qt возможности, которые зависят от платформы. Мы начнем с рассмотрения способов доступа к таким «родным» программным интерфейсам, как Win32 API в системе Windows, Carbon в системе Mac OS X и Xlib в системе X11. Затем мы перейдем к изучению расширения ActiveQt, демонстрируя способы применения элементов управления ActiveX в приложениях Qt, работающих в системе Windows, а также способы создания приложений, выполняющих функции серверов ActiveX. В последнем разделе мы рассмотрим способы взаимодействия приложений Qt с менеджером сеансов системы X11. </p>
<p class="paragraph">
Кроме представленных здесь возможностей компания «Trolltech» предлагает несколько зависимых от платформы решений в рамках проекта Qt Solutions, в частности миграционные фреймворки Qt/Motif и Qt/MFC, позволяющие упростить перевод в Qt приложений Motif/Xt и MFC. Подобное расширение для приложений Tcl/Tk обеспечивается фирмой «Froglogic», а компанией «Klaralvdalens Datakonsult» разработан конвертор ресурсов Windows компании Microsoft. Дополнительную информацию вы найдете на следующих веб-страницах: </p>
<p class="paragraph">
• </p>
<p class="paragraph">
• </p>
<p class="paragraph">
• </p>
<p class="paragraph">
Для встроенных приложений компания «Trolltech» обеспечивает Qtopia — рабочую среду для разработки таких приложений. Она рассматривается в . </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Применение «родных» программных интерфейсов</p>
<p class="paragraph">
Всесторонний программный интерфейс Qt удовлетворяет большинству требований на всех платформах, но при некоторых обстоятельствах нам может потребоваться базовый, платформозависимый программный интерфейс. В данном разделе мы продемонстрируем способы применения «родных» программных интерфейсов различных платформ, поддерживаемых Qt, для решения конкретных задач. </p>
<p class="paragraph">
Для каждой платформы класс QWidget поддерживает функцию winId(), которая возвращает идентификатор или описатель окна. QWidget также обеспечивает статическую функцию find(), которая возвращает QWidget с идентификатором конкретного окна. Мы можем передавать этот идентификатор функциям «родного» программного интерфейса для достижения эффектов, зависимых от платформы. Например, в следующем программном коде используется функция winId() для отображения слева заголовка панели инструментов, используя «родные» функции Mac OS X: </p>
<p class="paragraph">
#ifdef Q_WS_MAC </p>
<p class="paragraph">
ChangeWindowAttributes(HIViewGetWindow(HIViewRef(toolWin.winId())), </p>
<p class="paragraph">
kWindowSideTitlebarAttribute, kWindowNoAttributes); </p>
<p class="paragraph">
#endif </p>
<div>
<img src="data:image/jpg;base64,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" />
</div>
<p class="paragraph">
Рис. 20.1. Окно панели инструментов Mac OS X с отображением заголовка сбоку. </p>
<p class="paragraph">
Ниже показано, как в системе X11 мы можем модифицировать свойство окна: </p>
<p class="paragraph">
#ifdef Q_WS_X11 </p>
<p class="paragraph">
Atom atom = XInternAtom(QX11Info::display(), "MY_PROPERTY", False); </p>
<p class="paragraph">
long data = 1; </p>
<p class="paragraph">
XChangeProperty(QX11Info::display(), window->winId(), atom, atom, </p>
<p class="paragraph">
32, PropModeReplace, reinterpret_cast<uchar *>(&data), 1); </p>
<p class="paragraph">
#endif </p>
<p class="paragraph">
Использование директив #ifdef и #endif вокруг зависимого от платформы программного кода гарантирует компиляцию приложения на других платформах. </p>
<p class="paragraph">
Приведенный ниже пример показывает, как в приложениях, предназначенных только для Windows, можно использовать вызовы GDI для рисования на виджете Qt: </p>
<p class="paragraph">
01 void GdiControl::paintEvent(QPaintEvent * /* event */) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 RECT rect; </p>
<p class="paragraph">
04 GetClientRect(winId(), &rect); </p>
<p class="paragraph">
05 HDC hdc = GetDC(winId()); </p>
<p class="paragraph">
06 FillRect(hdc, &rect, HBRUSH(COLOR_WINDOW + 1)); </p>
<p class="paragraph">
07 SetTextAlign(hdc, TA_CENTER | TA_BASELINE); </p>
<p class="paragraph">
08 TextOutW(hdc, width() / 2, height() / 2, </p>
<p class="paragraph">
09 text.utf16(), text.size()); </p>
<p class="paragraph">
10 ReleaseDC(winId(), hdc); </p>
<p class="paragraph">
11 } </p>
<p class="paragraph">
Чтобы это сработало, мы должны также переопределить функцию QPaintDevice::paintEngine() для возврата нулевого указателя и установить атрибут Qt::WA_PaintOnScreen в конструкторе виджета. </p>
<p class="paragraph">
Следующий пример показывает, как можно сочетать QPainter и GDI в обработчике события рисования, используя функции getDC() и releaseDC() класса QPaintEngine: </p>
<p class="paragraph">
01 void MyWidget::paintEvent(QPaintEvent * /* event */) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 QPainter painter(this); </p>
<p class="paragraph">
04 painter.fillRect(rect().adjusted(20, 20, -20, -20), Qt::red); </p>
<p class="paragraph">
05 #ifdef Q_WS_WIN </p>
<p class="paragraph">
06 HDC hdc = painter.paintEngine()->getDC(); </p>
<p class="paragraph">
07 Rectangle(hdc, 40, 40, width() - 40, height() - 40); </p>
<p class="paragraph">
08 painter.paintEngine()->releaseDC(); </p>
<p class="paragraph">
09 #endif </p>
<p class="paragraph">
10 } </p>
<p class="paragraph">
Подобное совмещение вызовов QPainter и GDI иногда может дать странный результат, особенно когда вызовы QPainter выполняются после вызовов GDI, потому что QPainter делает некоторые предположения о состоянии базового уровня рисования. </p>
<p class="paragraph">
Qt определяет один из следующих четырех символов оконной системы: Q_WS_WIN, Q_WS_X11, Q_WS_MAC и Q_WS_QWS (Qtopia). Мы должны обеспечить включение хотя бы одного заголовка Qt перед их использованием в приложениях. Qt также обеспечивает препроцессорные символы для идентификации операционной системы: </p>
<p class="paragraph">
• Q_OS_AIX </p>
<p class="paragraph">
• Q_OS_BSD4 </p>
<p class="paragraph">
• Q_OS_BSDI </p>
<p class="paragraph">
• Q_OS_CYGWIN </p>
<p class="paragraph">
• Q_OS_DGUX </p>
<p class="paragraph">
• Q_OS_DYNIX </p>
<p class="paragraph">
• Q_OS_FREEBSD </p>
<p class="paragraph">
• Q_OS_HPUX </p>
<p class="paragraph">
• Q_OS_HURD </p>
<p class="paragraph">
• Q_OS_IRIX </p>
<p class="paragraph">
• Q_OS_LINUX </p>
<p class="paragraph">
• Q_OS_LYNX </p>
<p class="paragraph">
• Q_OS_MAC </p>
<p class="paragraph">
• Q_OS_NETBSD </p>
<p class="paragraph">
• Q_OS_OPENBSD </p>
<p class="paragraph">
• Q_OS_OS2EMX </p>
<p class="paragraph">
• Q_OS_OSF </p>
<p class="paragraph">
• Q_OS_QNX6 </p>
<p class="paragraph">
• Q_OS_QNX </p>
<p class="paragraph">
• Q_OS_RELIANT </p>
<p class="paragraph">
• Q_OS_SCO </p>
<p class="paragraph">
• Q_OS_SOLARIS </p>
<p class="paragraph">
• Q_OS_ULTRIX </p>
<p class="paragraph">
• Q_OS_UNIXWARE </p>
<p class="paragraph">
• Q_OS_WIN32 </p>
<p class="paragraph">
• Q_OS_WIN64 </p>
<p class="paragraph">
Мы можем считать, что по крайней мере один из этих символов будет определен. Для удобства Qt также определяет Q_OS_WIN, когда обнаруживается Win32 или Win64, и Q_OS_UNIX, когда обнаруживается любая операционная система типа Unix (включая Linux и Mac OS X). Во время выполнения приложений мы можем проверить QSysInfo::WindowsVersion или QSysInfo::MacintoshVersion для установки отличий между различными версиями Windows (2000, ME и так далее) или Mac OS X (10.2, 10.3 и так далее). </p>
<p class="paragraph">
Кроме макросов операционной и оконной систем существует также ряд макросов компилятора. Например, Q_CC_MSVC определяется в том случае, если компилятором является Visual С++ компании Microsoft. Такие макросы полезны, когда приходится обходить ошибки компилятора. </p>
<p class="paragraph">
Несколько классов графического пользовательского интерфейса Qt обеспечивают зависимые от платформы функции, которые возвращают описатели (handle) базового объекта для низкоуровневой обработки. Они перечислены на рис. 20.2: </p>
<p class="paragraph">
Mас OS X: </p>
<p class="paragraph">
• ATSFontFormatRef QFont::handle(); </p>
<p class="paragraph">
• CGImageRef QPixmap::macCGHandle(); </p>
<p class="paragraph">
• GWorldPtr QPixmap::macQDAlphaHandle(); </p>
<p class="paragraph">
• GWorldPtr QPixmap::macQDHandle(); </p>
<p class="paragraph">
• RgnHandle QRegion::handle(); </p>
<p class="paragraph">
• HIViewRef QWidget::winId(); </p>
<p class="paragraph">
Windows: </p>
<p class="paragraph">
• HCURSOR QCursor::handle(); </p>
<p class="paragraph">
• HDC QPaintEngine::getDC(); </p>
<p class="paragraph">
• HDC QPrintEngine::getPrinterDC(); </p>
<p class="paragraph">
• HFONT QFont::handle(); </p>
<p class="paragraph">
• HPALETTE QColormap::hPal(); </p>
<p class="paragraph">
• HRGN QRegion::handle(); </p>
<p class="paragraph">
• HWND QWidget::winId(); </p>
<p class="paragraph">
X11: </p>
<p class="paragraph">
• Cursor QCursor::handle(); </p>
<p class="paragraph">
• Font QFont::handle(); </p>
<p class="paragraph">
• Picture QPixmap::x11PictureHandle(); </p>
<p class="paragraph">
• Picture QWidget::x11PictureHandle(); </p>
<p class="paragraph">
• Pixmap QPixmap::handle(); </p>
<p class="paragraph">
• QX11Info QPixmap::x11Info(); </p>
<p class="paragraph">
• QX11Info QWidget::x11Info(); </p>
<p class="paragraph">
• Region QRegion::handle(); </p>
<p class="paragraph">
• Screen QCursor::x11Screen(); </p>
<p class="paragraph">
• SmcConn QSessionManager::handle(); </p>
<p class="paragraph">
• Window QWidget::handle(); </p>
<p class="paragraph">
• Window QWidget::winId(); </p>
<p class="paragraph">
В системе X11 функции QPixmap::x11Info() и QWidget::x11Info() возвращают объект QX11Info, который обеспечивает различные указатели и описатели с помощью ряда функций, включая display(), screen(), colormap() и visual(). Мы можем использовать их для настройки графического контекста, например QWidget или QPixmap. </p>
<p class="paragraph">
Приложениям Qt, которым необходимо взаимодействовать с другими инструментальными средствами и библиотеками, часто приходится осуществлять доступ к низкоуровневым событиям (XEvent в системе X11, MSG в системе Windows, Eventref в системе Mac OS X, QWSEvent для Qtopia), прежде чем они будут преобразованы в события QEvent. Мы можем делать это путем создания подкласса QApplication и переопределения соответствующего зависимого от платформы фильтра событий — одну из следующих функций: x11EventFilter(), winEventFilter(), macEventFilter() и qwsEventFilter(). Мы можем поступать по-другому и осуществлять доступ к зависимым от платформы событиям, которые передаются заданному QWidget путем переопределения какой-то одной из функций winEvent(), x11Event(), macEvent() и qwsEvent(). Это может пригодиться для обработки событий определенного типа, которые Qt обычно игнорирует, например события джойстика. </p>
<p class="paragraph">
Более подробную информацию относительно применения зависимых от платформы средств, в том числе как развертывать приложения Qt на различных платформах, можно найти в сети Интернет по адресу . </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Применение ActiveX в системе Windows</p>
<p class="paragraph">
Технология ActiveX компании Microsoft позволяет приложениям включать в себя компоненты интерфейса пользователя других приложений или библиотек. Она построена на применении технологии СОМ компании Microsoft и определяет один набор интерфейсов приложений, использующих компоненты, и другой набор интерфейсов приложений и библиотек, предоставляющих компоненты. </p>
<p class="paragraph">
Версия Qt/Windows для настольных компьютеров (Desktop Edition) обеспечивает рабочую среду ActiveQt для «бесшовного соединения» ActiveX и Qt. ActiveQt состоит из двух модулей: </p>
<p class="paragraph">
• Модуль QAxContainer позволяет нам использовать объекты СОМ и встраивать элементы управления ActiveX в приложения Qt. </p>
<p class="paragraph">
• Модуль QAxServer позволяет нам экспортировать пользовательские объекты СОМ и элементы управления ActiveX, написанные с помощью средств разработки Qt. </p>
<p class="paragraph">
Наш первый пример встраивает Media Player (медиаплеер) системы Windows вприложение Qt при помощи модуля QAxContainer. Приложение Qt добавляет кнопку Open, кнопку Play/Pause, кнопку Stop и ползунок в элемент управления ActiveX Media Player системы Windows. </p>
<div>
<img src="data:image/jpg;base64,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" />
</div>
<p class="paragraph">
Рис. 20.3. Приложение Media Player. </p>
<p class="paragraph">
Главное окно приложения имеет тип PlayerWindow: </p>
<p class="paragraph">
01 class PlayerWindow : public QWidget </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 Q_OBJECT </p>
<p class="paragraph">
04 Q_ENUMS(ReadyStateConstants) </p>
<p class="paragraph">
05 public: </p>
<p class="paragraph">
06 enum PlayStateConstants { </p>
<p class="paragraph">
07 Stopped = 0, Paused = 1, Playing = 2 }; </p>
<p class="paragraph">
08 enum ReadyStateConstants { </p>
<p class="paragraph">
09 Uninitialized = 0, Loading = 1, Interactive = 3, Complete = 4 }; </p>
<p class="paragraph">
10 PlayerWindow(); </p>
<p class="paragraph">
11 protected: </p>
<p class="paragraph">
12 void timerEvent(QTimerEvent *event); </p>
<p class="paragraph">
13 private slots: </p>
<p class="paragraph">
14 void onPlayStateChange(int oldState, int newState); </p>
<p class="paragraph">
15 void onReadyStateChange(ReadyStateConstants readyState); </p>
<p class="paragraph">
16 void onPositionChange(double oldPos, double newPos); </p>
<p class="paragraph">
17 void sliderValueChanged(int newValue); </p>
<p class="paragraph">
18 void openFile(); </p>
<p class="paragraph">
19 private: </p>
<p class="paragraph">
20 QAxWidget *wmp; </p>
<p class="paragraph">
21 QToolButton *openButton; </p>
<p class="paragraph">
22 QToolButton *playPauseButton; </p>
<p class="paragraph">
23 QToolButton *stopButton; </p>
<p class="paragraph">
24 QSlider *seekSlider; </p>
<p class="paragraph">
25 QString fileFilters; </p>
<p class="paragraph">
26 int updateTimer; </p>
<p class="paragraph">
27 }; </p>
<p class="paragraph">
Класс PlayerWindow наследует QWidget. Макрос Q_ENUMS(), расположенный сразу после Q_OBJECT, необходим для указания компилятору moc, что константы ReadyStateConstants, используемые в слоте onReadyStateChange(), имеют тип enum. В закрытой секции мы объявляем переменную—член QAxWidget *. </p>
<p class="paragraph">
01 PlayerWindow::PlayerWindow() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 wmp = new QAxWidget; </p>
<p class="paragraph">
04 wmp->setControl("{22D6F312-B0F6-11D0-94AB-0080C74C7E95}"); </p>
<p class="paragraph">
Конструктор начинается с создания объекта QAxWidget для инкапсулирования элемента управления ActiveX Media Player системы Windows. Модуль QAxContainer состоит из трех классов: QAxObject инкапсулирует объект COM, QAxWidget инкапсулирует элемент управления ActiveX и QAxBase реализует основную функциональность СОМ для QAxObject и QAxWidget. </p>
<p class="paragraph">
Мы вызываем функцию setControl() для объекта QAxWidget с идентификатором класса элемента управления Media Player 6.4 системы Windows. Это создает экземпляр требуемого компонента. С этого момента все свойства, события и методы элемента управления ActiveX доступны как свойства, сигналы и методы Qt объекта QAxWidget. </p>
<div>
<img src="data:image/jpg;base64,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" />
</div>
<p class="paragraph">
Рис. 20.4. Дерево наследования для модуля QAxContainer. </p>
<p class="paragraph">
Типы данных СОМ автоматически преобразуются в соответствующие типы объектов, как показано на рис. 20.5: </p>
<p class="paragraph">
• VARIANT_BOOL — bool, </p>
<p class="paragraph">
• char, short, int, long — int, </p>
<p class="paragraph">
• unsigned char, unsigned short, unsigned int, unsigned long — uint, </p>
<p class="paragraph">
• float, double — double, </p>
<p class="paragraph">
• CY — qlonglong, qulonglong, </p>
<p class="paragraph">
• BSTR — QString, </p>
<p class="paragraph">
• DATE — QDateTime, QDate, QTime, </p>
<p class="paragraph">
• OLE_COLOR — QColor, </p>
<p class="paragraph">
• SAFEARRAY(VARIANT) — QList<QVariant>, </p>
<p class="paragraph">
• SAFEARRAY(BSTR) — QStringList, </p>
<p class="paragraph">
• SAFEARRAY(BYTE) — QByteArray, </p>
<p class="paragraph">
• VARIANT — QVariant, </p>
<p class="paragraph">
• IFontDisp * — QFont, </p>
<p class="paragraph">
• IPictureDisp * — QPixmap, </p>
<p class="paragraph">
• Тип, определяемый пользователем — QRect, QSize, QPoint. </p>
<p class="paragraph">
Например, входной параметр типа VARIANT_BOOL становится типом bool, а выходной параметр типа VARIANT_BOOL становится типом bool &. Ecли пoлyчeнный тип являeтcя клaccoм Qt (QString, QDateTime и так далее), входной параметр становится ссылкой с модификатором const (например, const QString &). </p>
<p class="paragraph">
Для получения списка всех свойств, сигналов и слотов, доступных в объектах QAxObject или QAxWidget вместе с их типами Qt, сделайте вызов функции QAxBase::generateDocumentation() или используйте утилиту командной строки Qt dumpdoc, расположенную в каталоге Qt tools\activeqt\dumpdoc. </p>
<p class="paragraph">
Теперь продолжим рассмотрение конструктора PlayerWindow: </p>
<p class="paragraph">
05 wmp->setProperty("ShowControls", false); </p>
<p class="paragraph">
06 wmp->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding); </p>
<p class="paragraph">
07 connect(wmp, SIGNAL(PlayStateChange(int, int)), </p>
<p class="paragraph">
08 this, SLOT(onPlayStateChange(int, int))); </p>
<p class="paragraph">
09 connect(wmp, SIGNAL(ReadyStateChange(ReadyStateConstants)), </p>
<p class="paragraph">
10 this, SLOT(onReadyStateChange(ReadyStateConstants))); </p>
<p class="paragraph">
11 connect(wmp, SIGNAL(PositionChange(double, double)), </p>
<p class="paragraph">
12 this, SLOT(onPositionChange(double, double))); </p>
<p class="paragraph">
После вызова QAxWidget::setControl() мы вызываем функцию QObject::setProperty() для установки свойства ShowControls (отображать элементы управления) элемента управления Media Player системы Windows на значение false, поскольку мы предоставляем свои собственные кнопки для работы с компонентом. Функция QObject::setProperty() может использоваться как для свойств СОМ, так и для обычных свойств Qt. Ее второй параметр имеет тип QVariant. </p>
<p class="paragraph">
Затем мы вызываем функцию setSizePolicy(), чтобы элемент управления ActiveX мог занять все имеющееся в менеджере компоновки пространство, и мы подсоединяем три события ActiveX компонента СОМ к трем слотам. </p>
<p class="paragraph">
13 stopButton = new QToolButton; </p>
<p class="paragraph">
14 stopButton->setText(tr("&Stop")); </p>
<p class="paragraph">
15 stopButton->setEnabled(false); </p>
<p class="paragraph">
16 connect(stopButton, SIGNAL(clicked()), wmp, SLOT(Stop())); </p>
<p class="paragraph">
17 … </p>
<p class="paragraph">
18 } </p>
<p class="paragraph">
Остальная часть конструктора PlayerWindow следует обычному образцу, за исключением того, что мы подсоединяем некоторые сигналы Qt к слотам объекта COM (Play(), Pause() и Stop()). Мы показали здесь реализацию только кнопки Stop, поскольку другие кнопки реализуются аналогично. </p>
<p class="paragraph">
01 void PlayerWindow::timerEvent(QTimerEvent *event) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 if (event->timerId() == updateTimer) { </p>
<p class="paragraph">
04 double curPos = wmp->property("CurrentPosition").toDouble(); </p>
<p class="paragraph">
05 onPositionChange(-1, curPos); </p>
<p class="paragraph">
06 } else { </p>
<p class="paragraph">
07 QWidget::timerEvent(event); </p>
<p class="paragraph">
08 } </p>
<p class="paragraph">
09 } </p>
<p class="paragraph">
Функция timerEvent() вызывается через определенные интервалы времени во время проигрывания мультимедийного клипа. Мы используем ее для продвижения ползунка. Это делается путем вызова функции property() для элемента управления ActiveX, чтобы получить значение свойства CurrentPosition (текущая позиция) в виде объекта типа QVariant и вызова функции toDouble() для преобразования его в тип double. Мы затем вызываем функцию onPositionChange() для обновления положения ползунка. </p>
<p class="paragraph">
Мы не будем рассматривать остальную часть программного кода, поскольку большая часть его не имеет непосредственного отношения к ActiveX и не содержит ничего такого, что мы уже не обсуждали ранее. Данный программный код имеется на компакт-диске. </p>
<p class="paragraph">
В файле .pro нам необходимо задать элемент для связи с модулем QAxContainer. </p>
<p class="paragraph">
CONFIG += qaxcontainer </p>
<p class="paragraph">
При работе с объектами СОМ одной из часто возникающих потребностей является необходимость непосредственного вызова метода СОМ (вместо подсоединения его к сигналу Qt). Наиболее просто это сделать путем вызова функции QAxBase::dynamicCall() с указанием имени и сигнатуры метода в первом параметре и аргументов метода в дополнительных параметрах. Например: </p>
<p class="paragraph">
wmp->dynamicCall("TitlePlay(uint)", 6); </p>
<p class="paragraph">
Функция dynamicCall() принимает до восьми параметров типа QVariant и возвращает объект типа QVariant. Если нам необходимо передавать таким образом IDispatch * или IUnknown *, мы можем инкапсулировать компонент в QAxObject и вызвать для него функцию asVariant() для преобразования его в тип QVariant. Если нам необходимо вызвать метод СОМ, который возвращает IDispatch * или IUnknown *, или если нам необходимо осуществлять доступ к свойству СОМ одного из этих типов, мы можем вместо этого использовать функцию querySubObject(): </p>
<p class="paragraph">
QAxObject *session = outlook.querySubObject('"Session"); </p>
<p class="paragraph">
QAxObject *defaultContacts = </p>
<p class="paragraph">
session->querySubObject("GetDefaultFolder(01DefaultFolders)", </p>
<p class="paragraph">
"olFolderContacts"); </p>
<p class="paragraph">
Если мы собираемся вызывать методы, которые имеют неподдерживаемые типы данных в их списке параметров, мы можем использовать QAxBase::queryInterface() для получения интерфейса СОМ и непосредственного вызова метода. Мы должны вызвать функцию Release() после завершения использования интерфейса, что является обычным при работе с СОМ. Если нам приходится часто вызывать такие методы, мы можем создать подкласс QAxObject или QAxWidget и обеспечить функции—члены, которые инкапсулируют вызовы интерфейса СОМ. Однако убедитесь, что подклассы QAxObject и QAxWidget не могут определять свои собственные свойства, сигналы и слоты. </p>
<p class="paragraph">
Теперь мы рассмотрим модуль QAxServer. Этот модуль позволяет нам превратить стандартную программу Qt в сервер ActiveX. Сервер может быть как совместно используемой библиотекой, так и автономным приложением. Серверы в виде совместно используемых библиотек часто называют внутрипроцессными серверами (in-process servers), а автономные приложения — внепроцессными серверами (out-of-process servers). </p>
<p class="paragraph">
Наш первый пример QAxServer является внутрипроцессным сервером, отображающим виджет с шариком, который может прыгать вправо и влево. Мы рассмотрим также способы встраивания этого виджета в Internet Explorer. </p>
<div>
<img src="data:image/jpg;base64,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" />
</div>
<p class="paragraph">
Рис. 20.6. Виджет AxBouncer в Internet Explorer. </p>
<p class="paragraph">
Ниже приводится начало определения класса виджета AxBouncer: </p>
<p class="paragraph">
01 class AxBouncer : public QWidget, public QAxBindable </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 Q_OBJECT </p>
<p class="paragraph">
04 Q_ENUMS(SpeedValue) </p>
<p class="paragraph">
05 Q_PROPERTY(QColor color READ color WRITE setColor) </p>
<p class="paragraph">
06 Q_PROPERTY(SpeedValue speed READ speed WRITE setSpeed) </p>
<p class="paragraph">
07 Q_PROPERTY(int radius READ radius WRITE setRadius) </p>
<p class="paragraph">
08 Q_PROPERTY(bool running READ isRunning) </p>
<p class="paragraph">
AxBouncer наследует как QWidget, так и QAxBindable. Класс QAxBindable обеспечивает интерфейс между виджетом и клиентом ActiveX. Любой QWidget может быть экспортирован как элемент управления ActiveX, но путем создания подкласса QAxBindable мы можем уведомлять клиента об изменениях значения свойства и peализовывать интерфейсы СОМ в дополнение к уже реализованным при помощи QAxServer. </p>
<p class="paragraph">
Если при использовании множественного наследования имеются классы, производные от QObject, мы должны всегда располагать производные от QObject классы первыми для того, чтобы компилятор moc мог их извлечь. </p>
<p class="paragraph">
Мы объявляем три свойства для чтения и записи и одно свойство только для чтения. Макрос Q_ENUMS() необходим для указания компилятору moc на то, что SpeedValue имеет тип enum (перечисление). Это перечисление объявляется в открытой секции класса: </p>
<p class="paragraph">
09 public: </p>
<p class="paragraph">
10 enum SpeedValue { Slow, Normal, Fast }; </p>
<p class="paragraph">
11 AxBouncer(QWidget *parent = 0); </p>
<p class="paragraph">
12 void setSpeed(SpeedValue newSpeed); </p>
<p class="paragraph">
13 SpeedValue speed() const { return ballSpeed; } </p>
<p class="paragraph">
14 void setRadius(int newRadius); </p>
<p class="paragraph">
15 int radius() const { return ballRadius; } </p>
<p class="paragraph">
16 void setColor(const QColor &newColor); </p>
<p class="paragraph">
17 QColor color() const { return ballColor; } </p>
<p class="paragraph">
18 bool isRunning() const { return myTimerId != 0; } </p>
<p class="paragraph">
19 QSize sizeHint() const; </p>
<p class="paragraph">
20 QAxAggregated *createAggregate(); </p>
<p class="paragraph">
21 public slots: </p>
<p class="paragraph">
22 void start(); </p>
<p class="paragraph">
23 void stop(); </p>
<p class="paragraph">
24 signals: </p>
<p class="paragraph">
25 void bouncing(); </p>
<p class="paragraph">
Конструктор AxBouncer является стандартным конструктором виджета с параметром parent. Макрос QAXFACTORY_DEFAULT(), который мы используем для экспорта компонента, предполагает, что у конструктора именно такая сигнатура. </p>
<p class="paragraph">
Функция createAggregate() класса QAxBindable переопределяется. Мы рассмотрим ее вскоре. </p>
<p class="paragraph">
26 protected: </p>
<p class="paragraph">
27 void paintEvent(QPaintEvent *event); </p>
<p class="paragraph">
28 void timerEvent(QTimerEvent *event); </p>
<p class="paragraph">
29 private: </p>
<p class="paragraph">
30 int intervalInMilliseconds() const; </p>
<p class="paragraph">
31 QColor ballColor; </p>
<p class="paragraph">
32 SpeedValue ballSpeed; </p>
<p class="paragraph">
33 int ballRadius; </p>
<p class="paragraph">
34 int myTimerId; </p>
<p class="paragraph">
35 int x; </p>
<p class="paragraph">
36 int delta; </p>
<p class="paragraph">
37 }; </p>
<p class="paragraph">
Защищенная и закрытая секции этого класса имеют тот же вид, как и для стандартного виджета Qt. </p>
<p class="paragraph">
01 AxBouncer::AxBouncer(QWidget *parent) </p>
<p class="paragraph">
02 : QWidget(parent) </p>
<p class="paragraph">
03 { </p>
<p class="paragraph">
04 ballColor = Qt::blue; </p>
<p class="paragraph">
05 ballSpeed = Normal; </p>
<p class="paragraph">
06 ballRadius = 15; </p>
<p class="paragraph">
07 myTimerId = 0; </p>
<p class="paragraph">
08 x = 20; </p>
<p class="paragraph">
09 delta = 2; </p>
<p class="paragraph">
10 } </p>
<p class="paragraph">
Конструктор AxBouncer инициализирует закрытые переменные этого класса. </p>
<p class="paragraph">
01 void AxBouncer::setColor(const QColor &newColor) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 if (newColor != ballColor && </p>
<p class="paragraph">
04 requestPropertyChange("color")) { </p>
<p class="paragraph">
05 ballColor = newColor; </p>
<p class="paragraph">
06 update(); </p>
<p class="paragraph">
07 propertyChanged("color"); </p>
<p class="paragraph">
08 } </p>
<p class="paragraph">
09 } </p>
<p class="paragraph">
Функция setColor() устанавливает значение свойства color (цвет). Она вызывает функцию update() для перерисовки виджета. </p>
<p class="paragraph">
Необычной частью являются вызовы функций requestPropertyChange() и propertyChanged(). Эти функции наследуются от класса QAxBindable и в идеальном случае должны вызываться при всяком изменении свойства. Функция requestPropertyChange() спрашивает у клиента разрешение на изменение свойства и возвращает true, если клиент дает такое разрешение. Функция propertyChanged() уведомляет клиента о том, что свойство изменилось. </p>
<p class="paragraph">
Устанавливающие свойства функции setSpeed() и setRadius() следуют этому же образцу, и так же работают слоты start() и stop(), поскольку они изменяют значение свойства running (приложение выполняется). </p>
<p class="paragraph">
Осталось рассмотреть еще одну интересную функцию—член класса AxBouncer: </p>
<p class="paragraph">
QAxAggregated *AxBouncer::createAggregate() </p>
<p class="paragraph">
{ </p>
<p class="paragraph">
return new ObjectSafetyImpl; </p>
<p class="paragraph">
} </p>
<p class="paragraph">
Функция createAggregate() класса QAxBindable переопределяется. Она позволяет нам реализовать интерфейсы СОМ, которые модуль QAxServer еще не реализовал, или обойти определенные по умолчанию в QAxServer интерфейсы СОМ. Ниже мы делаем это для обеспечения интерфейса IObjectSafety, который используется в Internet Explorer для доступа к свойствам безопасности компонента. Это является стандартным способом устранения непопулярного сообщения об ошибке «Object not safe for scripting» (объект небезопасен при использовании в сценарии) в Internet Explorer. </p>
<p class="paragraph">
Ниже приводится определение класса, которое реализует интерфейс IObjectSafety: </p>
<p class="paragraph">
01 class ObjectSafetyImpl : public QAxAggregated, public IObjectSafety </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 public: </p>
<p class="paragraph">
04 long queryInterface(const QUuid &iid, void **iface); </p>
<p class="paragraph">
05 QAXAGG_IUNKNOWN </p>
<p class="paragraph">
06 HRESULT WINAPI GetInterfaceSafetyOptions(REFIID riid, </p>
<p class="paragraph">
07 DWORD *pdwSupportedOptions, DWORD *pdwEnabledOptions); </p>
<p class="paragraph">
08 HRESULT WINAPI SetInterfaceSafetyOptions(REFIID riid, </p>
<p class="paragraph">
09 DWORD pdwSupportedOptions, DWORD pdwEnabledOptions); </p>
<p class="paragraph">
10 }; </p>
<p class="paragraph">
Класс ObjectSafetyImpl наследует как QAxAggregated, так и IObjectSafety. Класс QAxAggregated является абстрактным базовым классом, предназначенным для реализации дополнительных интерфейсов СОМ. Объект СОМ, который расширяет QAxAggregated, доступен при помощи функции controllingUnknown(). Этот объект СОМ создается незаметно для пользователя модулем QAxServer. </p>
<p class="paragraph">
Макрос QAXAGG_IUNKNOWN обеспечивает стандартную реализацию функций QueryInterface(), AddRef() и Release(). В этих реализациях просто делается вызов одноименных функций для управляющего объекта СОМ. </p>
<p class="paragraph">
01 long ObjectSafetyImpl::queryInterface(const QUuid &iid, void **iface) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 *iface = 0; </p>
<p class="paragraph">
04 if (iid == IID_IObjectSafety) { </p>
<p class="paragraph">
05 *iface = static_cast<IObjectSafety *>(this); </p>
<p class="paragraph">
06 } else { </p>
<p class="paragraph">
07 return E_NOINTERFACE; </p>
<p class="paragraph">
08 } </p>
<p class="paragraph">
09 AddRef(); </p>
<p class="paragraph">
10 return S_OK; </p>
<p class="paragraph">
11 } </p>
<p class="paragraph">
Функция queryInterface() — чистая виртуальная функция класса QAxAggregated. Она вызывается управляющим объектом СОМ для предоставления доступа к интерфейсу, который обеспечивается подклассом QAxAggregated. Мы должны возвращать E_NOINTERFACE для интерфейсов, которые мы не определили, и также для IUnknown. </p>
<p class="paragraph">
01 HRESULT WINAPI ObjectSafetyImpl::GetInterfaceSafetyOptions( </p>
<p class="paragraph">
02 REFIID /* riid */, DWORD *pdwSupportedOptions, </p>
<p class="paragraph">
03 DWORD *pdwEnabledOptions) </p>
<p class="paragraph">
04 { </p>
<p class="paragraph">
05 *pdwSupportedOptions = </p>
<p class="paragraph">
06 INTERFACESAFE_FOR_UNTRUSTED_DATA </p>
<p class="paragraph">
07 | INTERFACESAFE_FOR_UNTRUSTED_CALLER; </p>
<p class="paragraph">
08 *pdwEnabledOptions = *pdwSupportedOptions; </p>
<p class="paragraph">
09 return S_OK; </p>
<p class="paragraph">
10 } </p>
<p class="paragraph">
11 HRESULT WINAPI ObjectSafetyImpl::SetInterfaceSafetyOptions( </p>
<p class="paragraph">
12 REFIID /* riid */, DWORD /* pdwSupportedOptions */, </p>
<p class="paragraph">
13 DWORD /* pdwEnabledOptions */) </p>
<p class="paragraph">
14 { </p>
<p class="paragraph">
15 return S_OK; </p>
<p class="paragraph">
16 } </p>
<p class="paragraph">
Функции GetInterfaceSafetyOptions() и SetInterfaceSafetyOptions() объявляются в IObjectSafety. Мы реализуем их, чтобы уведомить всех о том, что наш объект безопасен для использования в сценариях. </p>
<p class="paragraph">
Давайте теперь рассмотрим main.cpp: </p>
<p class="paragraph">
01 #include <QAxFactory> </p>
<p class="paragraph">
02 #include "axbouncer.h" </p>
<p class="paragraph">
03 QAXFACTORY_DEFAULT(AxBouncer, </p>
<p class="paragraph">
04 "{5e2461aa-a3e8-4f7a-8b04-307459a4c08c}", </p>
<p class="paragraph">
05 "{533af11f-4899-43de-8b7f-2ddf588d1015}", </p>
<p class="paragraph">
06 "{772c14a5-a840-4023-b79d-19549ece0cd9}", </p>
<p class="paragraph">
07 "{dbce1e56-70dd-4f74-85e0-95c65d86254d}", </p>
<p class="paragraph">
08 "{3f3db5e0-78ff-4e35-8a5d-3d3b96c83e09}") </p>
<p class="paragraph">
Макрос QAXFACTORY_DEFAULT() экспортирует элемент управления ActiveX. Мы можем использовать его для серверов ActiveX, которые экспортируют только один элемент управления. В следующем примере данного раздела будет показано, как можно экспортировать много элементов управления ActiveX. </p>
<p class="paragraph">
Первым аргументом макроса QAXFACTORY_DEFAULT() является имя экспортируемого класса Qt. Такое же имя используется для экспорта элемента управления. Остальные пять аргументов следующие: идентификатор класса, идентификатор интерфейса, идентификатор интерфейса событий, идентификатор библиотеки типов и идентификатор приложения. Мы можем использовать стандартные инструментальные средства, например guidgen или uuidgen, для получения этих идентификаторов. Поскольку сервер реализован в виде библиотеки, нам не требуется иметь функцию main(). </p>
<p class="paragraph">
Ниже приводится файл .pro для внутрипроцессного сервера ActiveX: </p>
<p class="paragraph">
TEMPLATE = lib </p>
<p class="paragraph">
CONFIG += dll qaxserver </p>
<p class="paragraph">
HEADERS = axbouncer.h \ </p>
<p class="paragraph">
objectsafetyimpl.h </p>
<p class="paragraph">
SOURCES = axbouncer.cpp \ </p>
<p class="paragraph">
main.cpp \ </p>
<p class="paragraph">
objectsafetyimpl.cpp </p>
<p class="paragraph">
RC_FILE = qaxserver.rc </p>
<p class="paragraph">
DEF_FILE = qaxserver.def </p>
<p class="paragraph">
Файлы qaxserver.rc и qaxserver.def, на которые имеются ссылки в файле .pro, —стандартные файлы, которые можно скопировать из каталога Qt src\activeqt\control. </p>
<p class="paragraph">
Файл makefile или сгенерированный утилитой qmake файл проекта Visual С++ содержат правила для регистрации сервера в реестре Windows. Для регистрации сервера на машине пользователя мы можем использовать утилиту regsvr32, которая имеется во всех системах Windows. </p>
<p class="paragraph">
Мы можем затем включить компонент Bouncer в страницу HTML, используя тег <object>: </p>
<p class="paragraph">
<object id="AxBouncer" </p>
<p class="paragraph">
classid="clsid:5e2461aa-a3e8-4f7a-8b04-307459a4c08c"> </p>
<p class="paragraph">
<b>The ActiveX control is not available. Make sure you </p>
<p class="paragraph">
have built and registered the component server.</b> </p>
<p class="paragraph">
</object> </p>
<p class="paragraph">
Мы можем создать кнопку для вызова слотов: </p>
<p class="paragraph">
<input type="button" value="Start" onClick="AxBouncer.start()"> </p>
<p class="paragraph">
<input type="button" value="Stop" onClick="AxBouncer.stop()"> </p>
<p class="paragraph">
Мы можем манипулировать виджетом при помощи языков JavaScript или VBScript точно так же, как и любым другим элементом управления ActiveX (см. расположенный на компакт-диске файл demo.html, содержащий очень простую страницу, в которой используется сервер ActiveX. </p>
<p class="paragraph">
Наш последний пример — приложение Address Book (адресная книга), применяющее сценарий. Это приложение может рассматриваться в качестве стандартного приложения Qt для Windows или внепроцессного сервера ActiveX. В последнем случае мы можем создавать сценарий работы приложения, используя, например, Visual Basic. </p>
<p class="paragraph">
01 class AddressBook : public QMainWindow </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 Q_OBJECT </p>
<p class="paragraph">
04 Q_PROPERTY(int count READ count) </p>
<p class="paragraph">
05 Q_CLASSINFO("ClassID", </p>
<p class="paragraph">
06 "{588141ef-110d-4beb-95ab-ee6a478b576d}") </p>
<p class="paragraph">
07 Q_CLASSINFO("InterfaceID", </p>
<p class="paragraph">
08 "{718780ec-b30c-4d88-83b3-79b3d9e78502}") </p>
<p class="paragraph">
09 Q_CLASSINFO("ToSuperClass", "AddressBook") </p>
<p class="paragraph">
10 public: </p>
<p class="paragraph">
11 AddressBook(QWidget *parent = 0); </p>
<p class="paragraph">
12 ~AddressBook(); </p>
<p class="paragraph">
13 int count() const; </p>
<p class="paragraph">
14 public slots: </p>
<p class="paragraph">
15 ABItem *createEntry(const QString &contact); </p>
<p class="paragraph">
16 ABItem *findEntry(const QString &contact) const; </p>
<p class="paragraph">
17 ABItem *entryAt(int index) const; </p>
<p class="paragraph">
18 private slots: </p>
<p class="paragraph">
19 void addEntry(); </p>
<p class="paragraph">
20 void editEntry(); </p>
<p class="paragraph">
21 void deleteEntry(); </p>
<p class="paragraph">
22 private: </p>
<p class="paragraph">
23 void createActions(); </p>
<p class="paragraph">
24 void createMenus(); </p>
<p class="paragraph">
25 QTreeWidget *treeWidget; </p>
<p class="paragraph">
26 QMenu *fileMenu; </p>
<p class="paragraph">
27 QMenu *editMenu; </p>
<p class="paragraph">
28 QAction *exitAction; </p>
<p class="paragraph">
29 QAction *addEntryAction; </p>
<p class="paragraph">
30 QAction *editEntryAction; </p>
<p class="paragraph">
31 QAction *deleteEntryAction; </p>
<p class="paragraph">
32 }; </p>
<p class="paragraph">
Виджет AddressBook является главным окном приложения. Предоставляемые им свойства и слоты можно применять при создании сценария. Макрос Q_CLASSINFO() используется для определения идентификаторов класса и интерфейсов, связанных с классом. Они генерируются с помощью таких утилит, как guid или uuid. </p>
<p class="paragraph">
В предыдущем примере мы определяли идентификаторы класса и интерфейса при экспорте класса QAxBouncer, используя макрос QAXFACTORY_DEFAULT(). В этом примере мы хотим экспортировать несколько классов, поэтому нельзя использовать макрос QAXFACTORY_DEFAULT(). Мы можем поступать двумя способами: </p>
<p class="paragraph">
• можно создать подкласс QAxFactory, переопределить его виртуальные функции для представления информации об экспортируемых нами типах и использовать макрос QAXFACTORY_EXPORT() для регистрации фабрики классов; </p>
<p class="paragraph">
• можно использовать макросы QAXFACTORY_BEGIN(), QAXFACTORY_END(), QAXCLASS() и QAXTYPE() для объявления и регистрации фабрики классов. В этом случае потребуется использовать макрос Q_CLASSINFO() для определения идентификаторов класса и интерфейса. </p>
<p class="paragraph">
Вернемся к определению класса AddressBook. Третий вызов макроса Q_CLASSINFO() может показаться немного странным. По умолчанию элементы управления ActiveX предоставляют в распоряжение клиентов не только свои собственные свойства, сигналы и слоты, но и свои суперклассы вплоть до QWidget. Атрибут ToSuperClass позволяет определить суперкласс самого высокого уровня (в дереве наследования), который мы собираемся предоставить клиенту. Здесь мы указываем имя класса компонента («AddressBook») в качестве имени экспортируемого класса самого высокого уровня — это значит, что не будут экспортироваться свойства, сигналы и слоты, определенные в суперклассах AddressBook. </p>
<p class="paragraph">
01 class ABItem : public QObject, public QListViewItem </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 Q_OBJECT </p>
<p class="paragraph">
04 Q_PROPERTY(QString contact READ contact WRITE setContact) </p>
<p class="paragraph">
05 Q_PROPERTY(QString address READ address WRITE setAddress) </p>
<p class="paragraph">
06 Q_PROPERTY(QString phoneNumber </p>
<p class="paragraph">
07 READ phoneNumber WRITE setPhoneNumber) </p>
<p class="paragraph">
08 Q_CLASSINFO("ClassID", </p>
<p class="paragraph">
09 "{bc82730e-5f39-4e5c-96be-461c2cd0d282}") </p>
<p class="paragraph">
10 Q_CLASSINFO("InterfaceID", </p>
<p class="paragraph">
11 "{c8bc1656-870e-48a9-9937-fbe1ceff8b2e}") </p>
<p class="paragraph">
12 Q_CLASSINFO("ToSuperClass", "ABItem") </p>
<p class="paragraph">
13 public: </p>
<p class="paragraph">
14 ABItem(QTreeWidget *treeWidget); </p>
<p class="paragraph">
15 void setContact(const QString &contact); </p>
<p class="paragraph">
16 QString contact() const { return text(0); } </p>
<p class="paragraph">
17 void setAddress(const QString &address); </p>
<p class="paragraph">
18 QString address() const { return text(1); } </p>
<p class="paragraph">
19 void setPhoneNumber(const QString &number); </p>
<p class="paragraph">
20 QString phoneNumber() const { return text(2); } </p>
<p class="paragraph">
21 public slots: </p>
<p class="paragraph">
22 void remove(); </p>
<p class="paragraph">
23 }; </p>
<p class="paragraph">
Класс ABItem представляет один элемент в адресной книге. Он наследует QTreeWidgetItem и поэтому может отображаться в QTreeWidget, и он также наследует QObject и поэтому может экспортироваться как объект СОМ. </p>
<p class="paragraph">
01 int main(int argc, char *argv[]) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 QApplication app(argc, argv); </p>
<p class="paragraph">
04 if (!QAxFactory::isServer()) { </p>
<p class="paragraph">
05 AddressBook addressBook; </p>
<p class="paragraph">
06 addressBook.show(); </p>
<p class="paragraph">
07 return app.exec(); </p>
<p class="paragraph">
08 } </p>
<p class="paragraph">
09 return app.exec(); </p>
<p class="paragraph">
10 } </p>
<p class="paragraph">
В функции main() мы проверяем, в каком качестве работает приложение: как автономное приложение или как сервер. Опция командной строки —activex распознается объектом QApplication и обеспечивает работу приложения в качестве сервера. Если приложение не является сервером, мы создаем главный виджет и выводим его на экран, как мы обычно делаем для любого автономного приложения Qt. </p>
<p class="paragraph">
Кроме опции —activex серверы ActiveX «понимают» следующие опции командной строки: </p>
<p class="paragraph">
• —regserver — регистрация сервера в системном реестре; </p>
<p class="paragraph">
• —unregserver — отмена регистрации сервера в системном реестре; </p>
<p class="paragraph">
• —dumpidl файл — записывает описание сервера на языке IDL (Interface Description Language — язык описания интерфейсов) в указанный файл. </p>
<p class="paragraph">
Когда приложение выполняет функции сервера, нам необходимо экспортировать классы AddressBook и ABItem как компоненты СОМ: </p>
<p class="paragraph">
QAXFACTORY_BEGIN("{2b2b6f3e-86cf-4c49-9df5-80483b47f17b}", </p>
<p class="paragraph">
"{8e827b25-148b-4307-ba7d-23f275244818}") </p>
<p class="paragraph">
QAXCLASS(AddressBook) </p>
<p class="paragraph">
QAXTYPE(ABItem) </p>
<p class="paragraph">
QAXFACTORY_END() </p>
<p class="paragraph">
Приведенные выше макросы экспортируют фабрику классов для создания объектов СОМ. Поскольку мы собираемся экспортировать два типа объектов СОМ, мы не можем просто использовать макрос QAXFACTORY_DEFAULT(), как мы делали в предыдущем примере. </p>
<p class="paragraph">
Первым аргументом макроса QAXFACTORY_BEGIN() является идентификатор библиотеки типов; второй аргумент представляет собой идентификатор приложения. Между макросами QAXFACTORY_BEGIN() и QAXFACTORY_END() мы указываем все классы, которые могут быть инстанцированы, и все типы данных, доступные как объекты СОМ. </p>
<p class="paragraph">
Ниже приводится файл .pro для внепроцессного сервера ActiveX: </p>
<p class="paragraph">
TEMPLATE = app </p>
<p class="paragraph">
CONFIG += qaxserver </p>
<p class="paragraph">
HEADERS = abitem.h \ </p>
<p class="paragraph">
addressbook.h \ </p>
<p class="paragraph">
editdialog.h </p>
<p class="paragraph">
SOURCES = abitem.cpp \ </p>
<p class="paragraph">
addressbook.cpp \ </p>
<p class="paragraph">
editdialog.cpp \ </p>
<p class="paragraph">
main.cpp </p>
<p class="paragraph">
FORMS = editdialog.ui </p>
<p class="paragraph">
RC_FILE = qaxserver.rc </p>
<p class="paragraph">
Файл qaxserver.rc, на который имеется ссылка в файле .pro, является стандартным файлом, который может быть скопирован из каталога Qt src\activeqt\control. </p>
<p class="paragraph">
Вы можете посмотреть в каталоге примеров vb проект Visual Basic, который использует сервер Address Book. </p>
<p class="paragraph">
Этим мы завершаем наш обзор рабочей среды ActiveQt. Дистрибутив Qt включает дополнительные примеры, и в документации содержится информация о способах построения модулей QAxContainer и QAxServer и решения обычных вопросов взаимодействия. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Управление сеансами в системе X11</p>
<p class="paragraph">
Когда мы выходим из системы X11, некоторые оконные менеджеры спрашивают нас о необходимости сохранения сеанса. Если мы отвечаем утвердительно, то при следующем входе в систему работа приложений будет автоматически возобновлена с того же экрана и, в идеальном случае, с того же состояния, которое было во время выхода из системы. </p>
<p class="paragraph">
Компонент системы X11, который обеспечивает сохранение и восстановление сеанса, называется менеджером сеансов (session manager). Для того чтобы приложение Qt/X11 «осознавало» присутствие менеджера сеансов, мы должны переопределить функцию QApplication::saveState() и сохранить там состояние приложения. </p>
<div>
<img src="data:image/jpg;base64,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" />
</div>
<p class="paragraph">
Рис. 20.7. Выход из системы KDE. </p>
<p class="paragraph">
Windows 2000 и XP, а также некоторые системы Unix предлагают другой механизм, который носит название «спящих процессов» (hibernation). Когда пользователь останавливает компьютер, операционная система просто выгружает оперативную память компьютера на диск и загружает ее обратно, когда компьютер «просыпается». Приложениям ничего не надо делать, и они даже могут ничего не знать об этом. </p>
<p class="paragraph">
Когда пользователь инициирует завершение работы, мы можем перехватить управление непосредственно перед завершением путем переопределения функции QApplication::commitData(). Это позволяет нам сохранять измененные данные и при необходимости вступать в диалог с пользователем. Эта часть схемы управления сеансом поддерживается как в системе X11, так и в Windows. </p>
<p class="paragraph">
Мы рассмотрим управление сеансом через программный код приложения Tic-Tac-Toe (крестики-нолики), которое работает под управлением менеджера сеансов. Во-первых, давайте рассмотрим функцию main(): </p>
<p class="paragraph">
01 int main(int argc, char *argv[]) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 Application app(argc, argv); </p>
<p class="paragraph">
04 TicTacToe toe; </p>
<p class="paragraph">
05 toe.setObjectName("toe"); </p>
<p class="paragraph">
06 app.setTicTacToe(&toe); </p>
<p class="paragraph">
07 toe.show(); </p>
<p class="paragraph">
08 return app.exec(); </p>
<p class="paragraph">
09 } </p>
<p class="paragraph">
Мы создаем объект Application. Класс Application наследует QApplication и переопределяет две функции commitData() и saveState() для обеспечения управления сеансом. </p>
<p class="paragraph">
Затем мы создаем виджет TicTacToe, даем знать об этом объекту Application и отображаем его. Мы дали виджету TicTacToe имя «toe». Мы должны давать уникальные имена виджетам верхнего уровня, если мы хотим, чтобы менеджер сеансов мог восстановить размеры и позиции окон. </p>
<div>
<img src="data:image/jpg;base64,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" />
</div>
<p class="paragraph">
Рис. 20.8. Приложение Tic-Tac-Toe. </p>
<p class="paragraph">
Ниже приводится определение класса Application: </p>
<p class="paragraph">
01 class Application : public QApplication </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 Q_OBJECT </p>
<p class="paragraph">
04 public: </p>
<p class="paragraph">
05 Application(int &argc, char *argv[]); </p>
<p class="paragraph">
06 void setTicTacToe(TicTacToe *tic); </p>
<p class="paragraph">
07 void saveState(QSessionManager &sessionManager); </p>
<p class="paragraph">
08 void commitData(QSessionManager &sessionManager); </p>
<p class="paragraph">
09 private: </p>
<p class="paragraph">
10 TicTacToe *ticTacToe; </p>
<p class="paragraph">
11 }; </p>
<p class="paragraph">
Класс Application сохраняет указатель виджета TicTacToe в закрытой переменной. </p>
<p class="paragraph">
01 void Application::saveState(QSessionManager &sessionManager) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 QString fileName = ticTacToe->saveState(); </p>
<p class="paragraph">
04 QStringList discardCommand; </p>
<p class="paragraph">
05 discardCommand << "rm" << fileName; </p>
<p class="paragraph">
06 sessionManager.setDiscardCommand(discardCommand); </p>
<p class="paragraph">
07 } </p>
<p class="paragraph">
В системе X11 функция saveState() вызывается, когда менеджер сеансов собирается сохранить состояние приложения. Данная функция также имеется на других платформах, но никогда не вызывается. Параметр QSessionManager позволяет нам поддерживать связь с менеджером сеансов. </p>
<p class="paragraph">
Мы начинаем с попытки сохранения виджетом TicTacToe своего состояния в некоторый файл. Затем мы задаем команду для выполнения сброса состояния менеджером сеансов. Команда сброса (discard command) — это команда, которую должен выполнять менеджер сеансов для удаления любой сохраненной ранее информации, связанной с текущим состоянием. В этом примере мы задаем ее в виде </p>
<p class="paragraph">
rm файл_сеанса </p>
<p class="paragraph">
где файл_сеанса — имя файла, который содержит сохраненное состояние сеанса, a rm — стандартная команда удаления файлов в системе Unix. </p>
<p class="paragraph">
Менеджер сеансов имеет также команду рестарта (restart command). Эту команду менеджер сеансов должен выполнять для возобновления работы приложения. По умолчанию Qt обеспечивает следующую команду рестарта: </p>
<p class="paragraph">
приложение -session идентификатор_ключ </p>
<p class="paragraph">
Первая часть, приложение, извлекается из argv[0]. Идентификатор — это идентификатор сеанса, переданный менеджером сеансов; гарантированно обеспечивается его уникальность для различных приложений и различных сеансов работы одного приложения. Ключ добавляется для однозначной идентификации времени сохранения сеанса. По различным причинам менеджер сеансов может вызывать функцию saveState() несколько раз в одном сеансе, и различные состояния должны отличаться. </p>
<p class="paragraph">
Из-за ограничений существующих менеджеров сеансов нам необходимо убедиться, что каталог приложения содержится в переменной среды PATH, если мы хотим обеспечить правильный рестарт приложения. В частности, если вы сами собираетесь попробовать пример TicTacToe, вы должны установить его в каталог, например, /usr/bin и вызывать его по команде tictactoe. </p>
<p class="paragraph">
Для простых приложений, в том числе и для TicTacToe, мы могли бы для обеспечения команды рестарта сохранять состояние в дополнительном аргументе командной строки. Например: </p>
<p class="paragraph">
tictactoe -state 0X-X0-X-0 </p>
<p class="paragraph">
Это избавило бы нас от сохранения данных в файле и выдачи команды сброса состояния для удаления файла. </p>
<p class="paragraph">
01 void Application::commitData(QSessionManager &sessionManager) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 if (ticTacToe->gameInProgress() </p>
<p class="paragraph">
04 && sessionManager.allowsInteraction()) { </p>
<p class="paragraph">
05 int r = QMessageBox::warning(ticTacToe, tr("Tic-Tac-Toe"), </p>
<p class="paragraph">
06 tr("The game hasn't finished.\n" </p>
<p class="paragraph">
07 "Do you really want to quit?"), </p>
<p class="paragraph">
08 QMessageBox::Yes | QMessageBox::Default, </p>
<p class="paragraph">
09 QMessageBox::No | QMessageBox::Escape); </p>
<p class="paragraph">
10 if (г == QMessageBox::Yes) { </p>
<p class="paragraph">
11 sessionManager.release(); </p>
<p class="paragraph">
12 } else { </p>
<p class="paragraph">
13 sessionManager.cancel(); </p>
<p class="paragraph">
14 } </p>
<p class="paragraph">
15 } </p>
<p class="paragraph">
16 } </p>
<p class="paragraph">
Функция commitData() вызывается, когда пользователь выходит из системы. Мы можем переопределить ее для вывода сообщения, предупреждающего пользователя о потенциальной потере данных. В используемой по умолчанию реализации закрываются все виджеты верхнего уровня, что равносильно ситуации, когда пользователь последовательно закрывает все окна, нажимая кнопку закрытия в заголовках окон. В главе 3 мы показали, как можно переопределять функцию closeEvent(), перехватывающую этот момент и выводящую на экран сообщение. </p>
<div>
<img src="data:image/jpg;base64,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" />
</div>
<p class="paragraph">
Рис. 20.9. «Вы действительно хотите завершить работу?». </p>
<p class="paragraph">
Теперь давайте рассмотрим класс TicTacToe: </p>
<p class="paragraph">
01 class TicTacToe : public QWidget </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 Q_OBJECT </p>
<p class="paragraph">
04 public: </p>
<p class="paragraph">
05 TicTacToe(QWidget *parent = 0); </p>
<p class="paragraph">
06 bool gameInProgress() const; </p>
<p class="paragraph">
07 QString saveState() const; </p>
<p class="paragraph">
08 QSize sizeHint() const; </p>
<p class="paragraph">
09 protected: </p>
<p class="paragraph">
10 void paintEvent(QPaintEvent *event); </p>
<p class="paragraph">
11 void mousePressEvent(QMouseEvent *event); </p>
<p class="paragraph">
12 private: </p>
<p class="paragraph">
13 enum { Empty = '-', Cross = 'X', Nought = '0' }; </p>
<p class="paragraph">
14 void clearBoard(); </p>
<p class="paragraph">
15 void restoreState(); </p>
<p class="paragraph">
16 QString sessionFileName() const; </p>
<p class="paragraph">
17 QRect cellRect(int row, int column) const; </p>
<p class="paragraph">
18 int cellWidth() const { return width() / 3; } </p>
<p class="paragraph">
19 int cellHeight() const { return height() / 3; } </p>
<p class="paragraph">
20 bool threeInARow(int row1, int col1, int row3, int col3) const; </p>
<p class="paragraph">
21 char board[3][3]; </p>
<p class="paragraph">
22 int turnNumber; </p>
<p class="paragraph">
23 }; </p>
<p class="paragraph">
Класс TicTacToe наследует QWidget и переопределяет функции sizeHint(), paintEvent() и mousePressEvent(). Он также обеспечивает функции gameInProgress() и saveState(), которые мы использовали в нашем классе Application. </p>
<p class="paragraph">
01 TicTacToe::TicTacToe(QWidget *parent, const char *name) </p>
<p class="paragraph">
02 : QWidget(parent, name) </p>
<p class="paragraph">
03 { </p>
<p class="paragraph">
04 clearBoard(); </p>
<p class="paragraph">
05 if (qApp->isSessionRestored()) </p>
<p class="paragraph">
06 restoreState(); </p>
<p class="paragraph">
07 setWindowTitle(tr("Tic-Tac-Toe")); </p>
<p class="paragraph">
08 } </p>
<p class="paragraph">
В конструкторе мы стираем игровое поле и, если приложение было вызвано с опцией —session, вызываем закрытую функцию restoreState() для восстановления старого сеанса. </p>
<p class="paragraph">
01 void TicTacToe::clearBoard() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 for (int row= 0; row < 3; ++row) { </p>
<p class="paragraph">
04 for (int column = 0; column < 3; ++column) { </p>
<p class="paragraph">
05 board[row][column] = Empty; </p>
<p class="paragraph">
06 } </p>
<p class="paragraph">
07 } </p>
<p class="paragraph">
08 turnNumber = 0; </p>
<p class="paragraph">
09 } </p>
<p class="paragraph">
В функции clearBoard() мы стираем все ячейки и устанавливаем turnNumber на значение 0. </p>
<p class="paragraph">
01 QString TicTacToe::saveState() const </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 QFile file(sessionFileName()); </p>
<p class="paragraph">
04 if (file.open(QIODevice::WriteOnly)) { </p>
<p class="paragraph">
05 QTextStream out(&file); </p>
<p class="paragraph">
06 for (int row = 0; row < 3; ++row) { </p>
<p class="paragraph">
07 for (int column = 0; column < 3; ++column) { </p>
<p class="paragraph">
08 out << board[row][column]; </p>
<p class="paragraph">
09 } </p>
<p class="paragraph">
10 } </p>
<p class="paragraph">
11 } </p>
<p class="paragraph">
12 return file.fileName(); </p>
<p class="paragraph">
13 } </p>
<p class="paragraph">
В функции saveState() мы записываем состояние игрового поля на диск. Формат достаточно простой: «X» для крестиков, «0» для ноликов и «—» для пустых ячеек. </p>
<p class="paragraph">
01 QString TicTacToe::sessionFileName() const </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 return QDir::homePath() + "/.tictactoe_" </p>
<p class="paragraph">
04 + qApp->sessionId() + "_" + qApp->sessionKey(); </p>
<p class="paragraph">
05 } </p>
<p class="paragraph">
Закрытая функция sessionFileName() возвращает имя файла для текущего идентификатора сеанса и ключа сеанса. Данная функция используется как в saveState(), так и в restoreState(). Имя файла определяется на основе идентификатора сеанса и ключа сеанса. </p>
<p class="paragraph">
01 void TicTacToe::restoreState() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 QFile file(sessionFileName()); </p>
<p class="paragraph">
04 if (file.open(QIODevice::ReadOnly)) { </p>
<p class="paragraph">
05 QTextStream in(&file); </p>
<p class="paragraph">
06 for (int row = 0; row < 3; ++row) { </p>
<p class="paragraph">
07 for (int column = 0; column < 3; ++column) { </p>
<p class="paragraph">
08 in >> board[row][column]; </p>
<p class="paragraph">
09 if (board[row][column] != Empty) </p>
<p class="paragraph">
10 ++turnNumber; </p>
<p class="paragraph">
11 } </p>
<p class="paragraph">
12 } </p>
<p class="paragraph">
13 } </p>
<p class="paragraph">
14 update(); </p>
<p class="paragraph">
15 } </p>
<p class="paragraph">
В функции restoreState() мы загружаем файл восстанавливаемого сеанса и заполняем игровое поле его информацией. Мы рассчитываем значение переменной turnNumber исходя из количества крестиков и ноликов на игровом поле. </p>
<p class="paragraph">
В конструкторе TicTacToe мы вызывали restoreState(), если функция QApplication::isSessionRestored() возвращала true. В этом случае sessionId() и sessionKey() возвращают именно те значения, которые были при прошлом сохранении состояния приложения, а функция sessionFileName() возвращает имя файла того сеанса. </p>
<p class="paragraph">
Тестирование и отладка программного кода по управлению сеансами могут быть достаточно утомительным делом, поскольку нам приходится все время входить и выходить из системы. Один из способов, позволяющий избежать этого, заключается в применении стандартной утилиты xsm, предусмотренной в системе X11. При первом вызове xsm на экран выводятся окно менеджера сеансов и окно консольного режима. Все приложения, запускаемые с данного окна консольного режима, будут использовать xsm в качестве своего менеджера сеансов, а не стандартный общесистемный менеджер сеансов. Мы можем затем использовать окно xsm для завершения, рестарта или сброса сеанса и проконтролировать правильность поведения приложения. Подробное описание того, как это делается, вы найдете в сети Интернет по адресу . </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Глава 21. Программирование встроенных систем</p>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<div>
<img src="data:image/jpg;base64,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" />
</div>
<p class="paragraph">
Разработка программного обеспечения для таких мобильных устройств, как карманные компьютеры и мобильные телефоны, может представлять собой очень сложную задачу, поскольку встроенные системы обычно имеют более медленные процессоры, меньший объем постоянной памяти (на флеш-картах или на жестких дисках), меньший объем основной памяти и дисплеи меньшего размера, чем настольные компьютеры. </p>
<p class="paragraph">
Система Qtopia Core (ранее она называлась Qt/Embedded) — это версия Qt, оптимизированная для разработки встроенных систем под Linux. Qtopia Core имеет такие же утилиты и программный интерфейс, какие предусмотрены в версиях Qt для настольных компьютеров (Qt/Windows, Qt/X11 и Qt/Mac), а также дополнительно предлагает классы и утилиты, необходимые для программирования встроенных систем. Через двойное лицензирование эта система доступна как для разработок с открытым исходным кодом, так и для коммерческих разработок. </p>
<p class="paragraph">
Qtopia Core может работать на любом оборудовании, функционирующем под управлением Linux (включая архитектуры Intel x86, MIPS, ARM, StrongARM, Motorola 68000 и PowerPC). Эта система имеет буфер фреймов основной памяти, отображаемой на дисплей, и поддерживает компилятор С++. В отличие от Qt/X11, она не нуждается в системе X Window; вместо этого в ней реализуется собственная оконная система (own window system — QWS), которая приводит к значительной экономии постоянной и основной памяти. Для еще большего уменьшения расхода памяти можно перекомпилировать Qtopia Core и исключить неиспользуемые возможности. Если заранее известны используемые устройством приложения и компоненты, они могут быть скомпилированы совместно в один исполняемый модуль и собраны статически с библиотеками Qtopia Core. </p>
<p class="paragraph">
Кроме того, Qtopia Core использует преимущества многих функций, присущих также версиям Qt для настольных компьютеров, в частности широко применяется неявное совместное использование данных («копирование при записи») как метод экономии основной памяти, поддерживаются пользовательские стили виджетов с помощью класса QStyle и обеспечивается система компоновки виджетов, позволяющая максимально использовать пространство экрана. </p>
<p class="paragraph">
Qtopia Core представляет собой базовый компонент, на котором строятся другие предложения по встроенным системам компании «Trolltech»; к ним относятся Qtopia Platform, Qtopia PDA и Qtopia Phone. Они содержат классы и приложения, специально предназначенные для мобильных устройств и способные интегрироваться с некоторыми виртуальными машинами Java независимых разработчиков. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Первое знакомство с Qtopia</p>
<p class="paragraph">
Приложения Qtopia Core могут разрабатываться на любой платформе, позволяющей запускать цепочки многоплатформенных инструментальных средств. Наиболее распространено построение кросс-компилятора GNU С++ в системе Unix. Этот процесс упрощается благодаря наличию скрипта и набора пакетов обновлений Дана Кегеля (Dan Kegel), доступного на веб-странице . Поскольку Qtopia Core имеет программный интерфейс Qt, в большинстве разработках, как правило, можно использовать версию Qt для настольных компьютеров, например Qt/X11 или Qt/Windows. </p>
<p class="paragraph">
Система конфигурации Qtopia Core поддерживает кросс-компиляторы с помощью опции —embedded скрипта configure. Например, для построения ARM—архитектуры мы могли бы ввести команду </p>
<p class="paragraph">
./configure -embedded arm </p>
<p class="paragraph">
Можно создавать пользовательские конфигурации путем добавления новых файлов в каталог Qt mkspecs/qws. </p>
<p class="paragraph">
Qtopia Core рисует непосредственно в буфере фреймов системы Linux (область основной памяти, связанная с дисплеем). Для обращения к буферу фреймов, возможно, потребуется получить разрешение для записи на устройство /dev/fb0. </p>
<p class="paragraph">
Для выполнения приложений Qtopia Core сначала необходимо запустить один процесс, выполняющий функции сервера. Этот сервер отвечает за распределение между клиентами областей экрана и за генерацию событий мышки и клавиатуры. Любое приложение Qtopia Core может стать сервером, если в командной строке указать опцию —qws или в качестве третьего параметра конструктора QApplication передать QApplication::GuiServer. </p>
<p class="paragraph">
Клиентские приложения связываются с сервером Qtopia Core при помощи совместно используемой области в основной памяти. Внутренне операции рисования реализованы так, что клиенты рисуют самих себя в совместно используемой области памяти и отвечают за оформление собственных окон. Это сводит к минимуму объем данных, передаваемых между клиентами и сервером, и в результате интерфейс пользователя работает без задержек. Приложения Qtopia Core обычно используют рисовальщик QPainter для рисования самих себя, но они могут также получать непосредственный доступ к видеооборудованию, используя класс QDirectPainter. </p>
<p class="paragraph">
Клиенты могут связываться друг с другом при помощи протокола QCOP. Клиент может прослушивать именованный канал, создавая объект QCopChannel и устанавливая связь с его сигналом received(). Например: </p>
<p class="paragraph">
QCopChannel *channel = new QCopChannel("System", this); </p>
<p class="paragraph">
connect(channel, SIGNAL(received(const QString &, const QByteArray &)), </p>
<p class="paragraph">
this, SLOT(received(const QString &, const QByteArray &))); </p>
<p class="paragraph">
Сообщение QCOP состоит из имени и необязательного массива QByteArray. Статическая функция QCopChannel::send() передает в широковещательном режиме сообщение по каналу. Например: </p>
<p class="paragraph">
QByteArray data; </p>
<p class="paragraph">
QDataStream out(&data, QIODevice::WriteOnly); </p>
<p class="paragraph">
out << QDateTime::currentDateTime(); </p>
<p class="paragraph">
QCopChannel::send("System", "clockSkew(QDateTime)", data); </p>
<p class="paragraph">
Предыдущий пример иллюстрирует общий прием: для кодирования данных используется поток QDataStream, и для гарантирования правильной интерпретации получателем массива формат данных в сообщении принимает вид функции С++. </p>
<p class="paragraph">
На работу приложений Qtopia Core влияют различные переменные среды. Наиболее важными являются QWS_MOUSE_PROTO и QWS_KEYBOARD, которые определяют тип устройства мышки и клавиатуры. Полный список переменных среды приводится на веб-странице . </p>
<p class="paragraph">
Если в качестве платформы разработки используется Unix, приложение можно тестировать с использованием виртуального буфера фреймов Qtopia (qvfb) — приложения X11, которое имитирует пиксель за пикселем реальный буфер фреймов. Это значительно сокращает цикл разработки. Для включения поддержки в Qtopia Core виртуального буфера необходимо передать опцию —qvfb скрипту configure. Следует помнить, что эта опция не предназначена для промышленного применения. Приложение виртуального буфера фреймов располагается в каталоге tools/qvfb и может вызываться следующим образом: </p>
<p class="paragraph">
qvfb -width 320 -height 480 -depth 32 </p>
<p class="paragraph">
Другой опцией, работающей на большинстве платформ, является VNC (Virtual Network Computing — вычисление в виртуальной сети), которая используется для удаленного выполнения приложения. Для включения поддержки VNC в Qtopia Core передайте опцию —qt—gfx—vnc в скрипт configure. Затем запустите ваше приложение Qtopia Core с опцией командной строки —display VNC:0 и клиента VNC, ссылающегося на хост, на котором выполняется ваше приложение. Размер экрана и разрядность цвета можно установить с помощью переменных среды QWS_SIZE и QWS_DEPTH на хосте, на котором выполняются приложения Qtopia Core (например, QWS_SIZE=320x480 и QWS_DEPTH=32). </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Настройка Qtopia Core</p>
<p class="paragraph">
При установке Qtopia Core можно указать функции, которые мы хотим устранить, чтобы снизить расход памяти. В состав Qtopia Core входит сотня конфигурируемых функций, каждой из которых соответствует какой-то препроцессорный символ. Например, QT_NO_FILEDIALOG исключает класс QFileDialog из библиотеки QtGui, a QT_NO_I18N удаляет всю поддержку интернационализации. Эти функции перечислены в файле src/corelib/qfeatures.txt. </p>
<p class="paragraph">
Qtopia Core содержит пять примеров конфигурации (minimum, small, medium, large и dist), которые находятся в файлах src/corelib/qconfig_xxx.h. Эти конфигурации можно задавать, используя опции —qconfig xxx для скрипта configure, например: </p>
<p class="paragraph">
./configure -qconfig small </p>
<p class="paragraph">
Для создания пользовательских конфигураций можно вручную создать файл qconfig—xxx.h и использовать его, как будто он определяет стандартную конфигурацию. Можно поступить по-другому — использовать графическую утилиту qconfig, расположенную в подкаталоге Qt tools. </p>
<p class="paragraph">
Qtopia Core предоставляет следующие классы для интерфейса с входными и выходными устройствами и для настройки пользовательского интерфейса оконной системы: </p>
<p class="paragraph">
• QScreen — драйверы экрана, </p>
<p class="paragraph">
• QScreenDriverPlugin — подключаемые модули драйверов экрана, </p>
<p class="paragraph">
• QWSMouseHandler — драйверы мышки, </p>
<p class="paragraph">
• QMouseDriverPlugin — подключаемые модули драйверов мышки, </p>
<p class="paragraph">
• QWSKeyboardHandler — драйверы клавиатуры, </p>
<p class="paragraph">
• QKbdDriverPlugin — подключаемые модули драйверов клавиатуры, </p>
<p class="paragraph">
• QWSInputMethod — методы ввода, </p>
<p class="paragraph">
• QDecoration — стили оформления окон, </p>
<p class="paragraph">
• QDecorationPlugin — подключаемые модули стилей оформления окон. </p>
<p class="paragraph">
Для получения списка заранее определенных драйверов, методов ввода и стилей оформления экрана запустите скрипт configure с опцией —help. </p>
<p class="paragraph">
Драйвер экрана можно задать с помощью опции командной строки —display при запуске сервера Qtopia Core, как это было показано в предыдущем разделе, или путем установки переменной среды QWS_DISPLAY. Драйвер мышки и связанное с ним устройство можно задавать, используя переменную среды QWS_MOUSE_PROTO, значение которой задается в виде тип:устройство, где тип — один из поддерживаемых драйверов, а устройство — путь к устройству (например, QWS_MOUSE_PROTO=IntelliMouse:/dev/mouse). Клавиатуры задаются аналогично при помощи переменной среды QWS_KEYBOARD. Методы ввода и оформления окон устанавливаются программно в сервере при помощи функций QWSServer::setCurrentInputMethod() и QApplication::qwsSetDecoration(). </p>
<p class="paragraph">
Стили оформления окон можно задавать отдельно от стиля виджетов, который наследует класс QStyle. Например, вполне допускается установить Windows в качестве стиля оформления окон и Plastique в качестве стиля виджетов. При желании для каждого окна можно задавать свой стиль оформления. </p>
<p class="paragraph">
Класс QWSServer содержит различные функции по настройке оконной системы. Приложения, функционирующие как сервер Qtopia Core, могут получать доступ к уникальному экземпляру QWSServer через глобальную переменную qwsServer, которую инициализирует конструктор QApplication. </p>
<p class="paragraph">
Qtopia Core поддерживает следующие форматы шрифтов: TrueType (TTF), PostScript Type 1, Bitmap Distribution Format (BDF) и Qt Prerendered Fonts (QPF). </p>
<p class="paragraph">
Поскольку QPF является растровым форматом, он быстрее и компактнее, чем такие векторные форматы, как TTF и PostScript Туре 1, если требуется использовать только один или два различных размера. Утилита makeqpf позволяет воспринимать файлы TTF или PostScript Туре 1 и сохранять результат в формате QPF. Можно поступить по-другому — запустить наши приложения с опцией командной строки —savefonts. </p>
<p class="paragraph">
На момент написания книги компания «Trolltech» разрабатывает дополнительный уровень, расположенный над Qtopia Core и позволяющий еще быстрее и удобнее разрабатывать приложения для встроенных систем. Можно надеяться, что следующее издание данной книги будет содержать больше информации по этому вопросу. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
</div>
<div id="sec_8">
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Приложение А. Установка Qt</p>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="paragraph">
В данном приложении рассматривается порядок установки Qt в вашу систему с компакт-диска, который прилагается к этой книге. Компакт-диск содержит версию Qt 4.1.1 для Windows, Mac OS X и X11 (для Linux и большинства версий Unix). Все они включают SQLite — общедоступную, не нуждающуюся в сервере базу данных и драйвер SQLite. Для вашего удобства на компакт-диске представлены различные версии Qt. Для серьезных разработок программного обеспечения лучше всего загрузить из Интернета последнюю версию Qt по адресу или приобрести коммерческую версию. </p>
<p class="paragraph">
Компания «Trolltech» также обеспечивает Qtopia Core для построения приложений на базе системы Linux для таких устройств, как карманные компьютеры и мобильные телефоны. Если вы интересуетесь созданием встроенных приложений, вы можете скачать Qtopia Core с соответствующей веб-страницы сайта компании «Trolltech». </p>
<p class="paragraph">
Приложения представленных в книге примеров содержатся на компакт-диске в каталоге examples. Кроме того, Qt предоставляет много небольших приложений—примеров, которые располагаются в подкаталоге examples. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Замечание о лицензировании</p>
<p class="paragraph">
Qt выпускается в двух формах: с открытым исходным кодом и коммерческая. Версия с открытым исходным кодом распространяется бесплатно; за коммерческую версию приходится платить. </p>
<p class="paragraph">
Представленное на компакт-диске программное обеспечение пригодно для создания приложений для себя или для образовательных целей. </p>
<p class="paragraph">
Если вы собираетесь распространять созданные вами приложения с использованием версии Qt с открытым исходным кодом, вы должны соблюсти определенные условия, которые отражены в лицензиях используемого вами программного обеспечения для создания своих программ. Для версий с открытым исходным кодом такие условия включают лицензию GNU GPL (General Public License — общедоступная лицензия). Простые лицензии, подобные GPL, наделяют пользователей определенными правами, включая просмотр и модификацию исходного кода, а также распространение приложений (на тех же условиях). Если вы собираетесь распространять ваши приложения без исходного кода (и считаете ваш программный код своей собственностью) или хотите применять в отношении ваших приложений свою собственную коммерческую лицензию, вы должны приобретать коммерческие версии программного обеспечения, используемого для создания ваших программ. Коммерческие версии программного обеспечения позволяют вам продавать и распространять созданные вами приложения на ваших условиях. </p>
<p class="paragraph">
Компакт-диск содержит GPL—версии Qt для Windows, Mac OS X и X11. Полные, юридически верные тексты лицензий включены в пакеты программ компакт-диска; здесь же имеется информация о том, как получить коммерческие версии. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Установка Qt/Windows</p>
<p class="paragraph">
Когда вы вставляете компакт-диск в машину с системой Windows, автоматически запускается программа установки. Если этого не происходит, с помощью Проводника попадите в корневой каталог компакт-диска и дважды щелкните по install.exe. (Эта программа в Проводнике может выглядеть как install, что зависит от конкретной настройки вашей системы.) </p>
<p class="paragraph">
Если у вас уже установлен компилятор MinGW С++, необходимо указать каталог его размещения; в противном случае установите соответствующий переключатель для установки компилятора MinGW. Находящаяся на компакт-диске GPL—версия Qt не будет работать с Visual С++, поэтому необходимо установить компилятор MinGW, если он еще у вас не установлен. Программа установки позволяет также установить примеры, прилагаемые к книге. Стандартные примеры Qt вместе с документацией устанавливаются автоматически. </p>
<p class="paragraph">
Если вы задаете установку компилятора MinGW, может быть небольшая задержка между завершением установки компилятора MinGW и началом установки Qt. </p>
<p class="paragraph">
После установки в меню Пуск появится новая папка «Qt by Trolltech v4.1.1 (opensource)». Эта папка будет содержать ярлыки для Qt Assistant и Qt Designer, а также «Qt 4.1.1 Command Prompt», который запускает окно консоли. При запуске этого окна выполняется установка переменных среды для компиляции программ Qt с помощью MinGW. Именно в этом окне можно выполнять утилиты qmake и make для создания Qt—приложений. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Установка Qt/Mac</p>
<p class="paragraph">
До установки Qt в системе Mac OS X уже должны быть установлены утилиты Xcode компании «Apple». Эти утилиты обычно находятся на компакт-диске (или DVD-диске), поставляемом с системой Mac OS X; их можно также скачать с сайта Apple Developer Connection, . </p>
<p class="paragraph">
Если вы уже имеете Mac OS X 10.4 (Tiger) и Xcode Tools 2.x (вместе с компилятором GCC 4.0.x), можно воспользоваться установщиком, как это описано ниже. Если вы имеете более старую версию Mac OS X или более старую версию GCC, необходимо вручную установить пакет с исходными текстами. Этот пакет называется qt—mac—opensource—4.1.1.tar.gz и располагается в каталоге mac компакт-диска. После установки этого пакета следуйте инструкциям по установке Qt в системе X11, которые приводятся в следующем разделе. </p>
<p class="paragraph">
Для использования программы установки вставьте компакт-диск и дважды щелкните по пакету Qt.mpkg. Это приведет к запуску программы установки Installer.app, и Qt будет установлена со стандартными примерами, документацией и примерами, прилагаемыми к данной книге. Qt будет установлена в каталог /Developer, а примеры книги в /Developer/Examples/Qt4Book. </p>
<p class="paragraph">
Для запуска таких команд, как qmake и make, необходимо использовать окно терминала, например Terminal.app из /Applications/Utilities. Необходимо также сгенерировать проекты Xcode, используя qmake. Например, чтобы сформировать проект Xcode для примера hello, запустите консоль (например, Terminal.app), перейдите в каталог /Developer/Examples/Qt4Book/chap01/hello и введите следующую команду: </p>
<p class="paragraph">
qmake -spec macx-xcode hello.pro </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Установка Qt/X11</p>
<p class="paragraph">
Для установки Qt в системе X11 в свой стандартный каталог вам могут потребоваться полномочия root. Если у вас нет таких полномочий, используйте аргумент —prefix скрипта configure для указания каталога, в который вам разрешено записывать данные. </p>
<p class="paragraph">
1. Перейдите на временный каталог. Например: </p>
<p class="paragraph">
cd /tmp </p>
<p class="paragraph">
2. Распакуйте архивный файл, расположенный на компакт-диске: </p>
<p class="paragraph">
cp /cdrom/x11/qt-x11-opensource-src-4.1.1.tgz </p>
<p class="paragraph">
gunzip qt-x11-opensource-src-4.1.1.tgz </p>
<p class="paragraph">
tar xf qt-x11-opensource-src-4.1.1.tar </p>
<p class="paragraph">
Это создает каталог /tmp/qt—x11—opensource—src—4.1.1 при условии, что ваш компакт-диск смонтирован, как /cdrom. Для Qt требуется утилита GNU tar; в некоторых системах она называется gtar. </p>
<p class="paragraph">
3. Выполните утилиту configure в новом окне терминала, задавая предпочитаемые вами опции построения библиотеки Qt и поддерживающих ее утилит: </p>
<p class="paragraph">
cd /tmp/qt-x11-opensource-src-4.1.1 </p>
<p class="paragraph">
./configure </p>
<p class="paragraph">
Вы можете запустить ./configure —help для получения списка опций конфигурации. </p>
<p class="paragraph">
4. Для построения Qt введите </p>
<p class="paragraph">
make. </p>
<p class="paragraph">
В результате будет создана библиотека и будут скомпилированы все демонстрационные программы, примеры и утилиты. В некоторых системах make имеет имя gmake. </p>
<p class="paragraph">
5. Для установки Qt введите </p>
<p class="paragraph">
su -с "make install" </p>
<p class="paragraph">
и затем пароль root. В результате Qt будет установлена в /usr/local/Trolltech/Qt—4.1.1. Вы можете изменить место расположения Qt, используя опцию —prefix скрипта configure, и если вы имеете разрешение на запись в это место, можно просто ввести команду: </p>
<p class="paragraph">
make install </p>
<p class="paragraph">
6. Настройте определенные переменные среды для Qt. </p>
<p class="paragraph">
Если вы используете командную оболочку bash, ksh, zsh или sh, добавьте следующие строки в ваш файл .profile: </p>
<p class="paragraph">
PATH=/usr/local/Trolltech/Qt-4.1.1/bin:$РАТН </p>
<p class="paragraph">
export PATH </p>
<p class="paragraph">
Если вы используете оболочку csh или tcsh, добавьте следующую строку в ваш файл .login: </p>
<p class="paragraph">
setenv PATH /usr/local/Trolltech/Qt-4.1.1/bin:$PATH </p>
<p class="paragraph">
Если вы использовали опцию —prefix для скрипта configure, задавайте указанный вами путь вместо стандартного пути, показанного выше. Если вы используете компилятор, не поддерживающий rpath, необходимо в переменную среды LD_LIBRARY_PATH добавить также путь /usr/local/Trolltech/Qt—4.1.1/lib. Это необязательно делать в системе Linux с компилятором GCC. </p>
<p class="paragraph">
В состав Qt входит приложение qtdemo, которое демонстрирует многие возможности библиотеки. Оно служит хорошей отправной точкой, позволяющей понять, что можно сделать при помощи средств разработки Qt. Документацию Qt можно найти либо на сайте , либо запустить Qt Assistant — приложение системы помощи в Qt, которое вызывается из окна консоли по команде assistant. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
</div>
<div id="sec_9">
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Приложение Б. Введение в С++ для программистов Java и С#</p>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="paragraph">
Данное приложение представляет собой краткое введение в язык С++, предназначенное для разработчиков, знакомых с Java или C#. Предполагается, что вы знакомы с такими концепциями объектно—ориентированного программирования, как наследование и полиморфизм, и хотите обучиться программированию на С++. Чтобы эта книга не стала громоздким 1500—страничным томом, включающим в себя полный учебник по С++ для начинающих, это приложение ограничивается изложением только существенных вопросов. В нем представлены основные понятия и методы, необходимые для понимания программ, приводимых в остальной части книги, и достаточные для того, чтобы, используя Qt, начать разработку межплатформенных приложений с графическим пользовательским интерфейсом. </p>
<p class="paragraph">
На момент написания книги язык С++ представляет собой единственное реальное средство написания межплатформенных, высокопроизводительных объектно—ориентированных приложений с графическим пользовательским интерфейсом. Недоброжелатели С++ обычно отмечают, что программировать на Java или C#, который отошел от поддержки совместимости с языком С, более приятно; на самом деле Бьерн Страуструп (Bjarne Stroustrup), создатель С++, отмечал в книге «The Design and Evolution of C++» (Дизайн и эволюция С++), что «внутри С++ существует очень компактный и более аккуратный язык, изо всех сил стремящийся получить известность». </p>
<p class="paragraph">
К счастью, при программировании в рамках Qt мы обычно придерживаемся некоторого подмножества С++, которое сильно приближается к утопическому языку, о котором говорил Страуструп, что позволяет нам сконцентрировать свое внимание непосредственно на текущей проблеме. Более того, Qt в некоторых аспектах расширяет С++ благодаря своему новаторскому механизму «сигналов и слотов», поддержке кодировки Unicode и ключевому слову foreach. </p>
<p class="paragraph">
В первом разделе данного приложения мы увидим, как можно объединять несколько файлов, содержащих исходный код С++, для получения исполняемой программы. Это приведет нас к изучению таких центральных концепций С++, как единица компиляции, заголовочные файлы, объектные файлы, библиотеки, и ознакомит с препроцессором, компилятором и компоновщиком С++. </p>
<p class="paragraph">
Затем мы рассмотрим наиболее важные отличия языков С++, Java и C#, связанные с определением классов, использованием указателей и ссылок, перегрузками операторов, применением препроцессора и т.д. Несмотря на то что синтаксис С++ очень похож на синтаксис Java и C#, имеется тонкое отличие базовых концепций. В то же время язык С++, под влиянием которого coздaвaлиcь Java и C#, имеет много общего с этими двумя языками, в частности аналогичные типы данных, те же самые арифметические операторы и одинаковые основные операторы управления. </p>
<p class="paragraph">
Последней раздел посвящен стандартной библиотеке С++, которая обеспечивает функциональность, готовую к применению в любой программе на С++. Эта библиотека развивалась в течение более 30 лет и поэтому вобрала в себя многие подходы, в том числе процедурный, объектно—ориентированный и функциональный стили программирования, а также макросы и шаблоны. По сравнению с библиoтeкaми Java и C# стандартная библиотека С++ имеет довольно ограниченную область применения; она не поддерживает программирование графического пользовательского интерфейса, многопоточную обработку, базы данных, интернационализацию, работу с сетями, XML и Unicode. Для применения С++ в этих областях предполагается, что разработчики С++ должны использовать различные библиотеки (часто зависимые от платформы). </p>
<p class="paragraph">
Именно здесь приходит на помощь Qt. Сначала средства разработки Qt представляли собой межплатформенный инструментарий по созданию графического пользовательского интерфейса (набор классов, позволяющий писать переносимые приложения с графическим пользовательским интерфейсом), но затем они быстро превратились в полномасштабную рабочую среду, частично расширяющую и частично заменяющую стандартную библиотеку С++. Хотя эта книга посвящена средствам разработки Qt, полезно знать возможности стандартной библиотеки С++, поскольку вам, возможно, придется работать с программным кодом, использующим эту библиотеку. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Первое знакомство с С++</p>
<p class="paragraph">
Программа С++ состоит из одной или нескольких единиц компиляции. Каждая единица компиляции представляет собой отдельный файл исходного кода, обычно имеющий расширение .cpp (другими распространенными расширениями являются .cc и .cxx); она обрабатывается компилятором за один шаг. Для каждой единицы компиляции компилятор генерирует объектный файл с расширением .obj (в Windows) или .о (в Unix и Mac OS X). Объектный файл — это бинарный файл, содержащий машинный код для той архитектуры, на которой будет выполняться программа. </p>
<p class="paragraph">
После компиляции всех файлов .cpp мы можем собрать все объектные файлы для создания исполняемого модуля, используя специальную программу, называемую компоновщиком (linker). Компоновщик соединяет объектные файлы в единое целое и назначает адреса памяти функциям и другим символическим ссылкам, которые содержатся в единицах компиляции. </p>
<div>
<img src="data:image/jpg;base64,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" />
</div>
<p class="paragraph">
Рис. Б.1. Процесс компиляции программы на С++ (в Windows). </p>
<p class="paragraph">
При создании программы только одна единица компиляции должна иметь функцию main(), которая является точкой входа в программу. Эта функция не принадлежит никакому классу — она является глобальной функцией. </p>
<p class="paragraph">
В отличие от Java, где каждый исходный файл должен содержать точно один класс, С++ позволяет организовать единицу компиляции удобным для нас способом. Можно реализовать несколько классов в одном файле .cpp или распространить реализацию класса на несколько файлов .cpp; имена исходных файлов могут быть любыми. При внесении изменений в один конкретный файл .cpp потребуется перекомпилировать этот файл и затем повторно скомпоновать приложение для создания нового исполняемого модуля. </p>
<p class="paragraph">
Прежде чем мы пойдем дальше, давайте рассмотрим очень простую программу на С++, вычисляющую квадрат целого числа. Эта программа состоит из двух единиц компиляции: main.cpp и square.cpp. </p>
<p class="paragraph">
Ниже показан файл square.cpp: </p>
<p class="paragraph">
01 double square(double n) </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 return n * n; </p>
<p class="paragraph">
04 } </p>
<p class="paragraph">
Этот файл содержит лишь глобальную функцию с именем square(), которая возвращает квадрат своего параметра. </p>
<p class="paragraph">
Ниже показан файл main.cpp: </p>
<p class="paragraph">
01 #include <cstdlib> </p>
<p class="paragraph">
02 #include <iostream> </p>
<p class="paragraph">
03 using namespace std; </p>
<p class="paragraph">
04 double square(double); </p>
<p class="paragraph">
05 int main(int argc, char *argv[]) </p>
<p class="paragraph">
06 { </p>
<p class="paragraph">
07 if (argc != 2) { </p>
<p class="paragraph">
08 cerr << "Usage: square <number>" << endl; </p>
<p class="paragraph">
09 return 1; </p>
<p class="paragraph">
10 } </p>
<p class="paragraph">
11 double n = strtod(argv[1], 0); </p>
<p class="paragraph">
12 cout << "The square of " << argv[1] << " is " << square(n) << endl; </p>
<p class="paragraph">
13 return 0; </p>
<p class="paragraph">
14 } </p>
<p class="paragraph">
Исходный файл main.cpp содержит определение функции main(). В С++ эта функция принимает в качестве параметров int и char * (массив символьных строк). Имя программы находится в argv[0], а аргументы командной строки — в argv[1], argv[2], … argv[argc — 1]. Параметры имеют стандартные имена argc («argument count» — количество аргументов) и argv («argument values» — значения аргументов). Если программа не использует аргументы командной строки, функцию main() можно определить без параметров. </p>
<p class="paragraph">
Функция main() использует из стандартной библиотеки С++ функции strtod() («string to double» — преобразование строки в переменную двойной точности), cout (стандартный поток вывода С++) и cerr (стандартный поток вывода сообщений об ошибках С++) для преобразования аргумента командной строки в тип double и для вывода текста на консоль. Строки, числа и маркеры конца строки (endl) выводятся с помощью оператора <<, который также используется для сдвига битов. Чтобы воспользоваться этой стандартной функциональностью, необходимо включить директивы #include, расположенные в строках 1 и 2. </p>
<p class="paragraph">
Директива using namespace в строке 3 указывает компилятору на то, что мы хотим импортировать в глобальное пространство имен все идентификаторы, объявленные в пространстве имен std. Это позволяет нам пользоваться записью strtod(), cout, cerr и endl вместо указания полных имен: std::strtod(), std::cout, std::cerr и std::endl. В С++ оператор :: разделяет компоненты сложного имени. </p>
<p class="paragraph">
В строке 4 объявляется прототип функции. Он указывает компилятору на то, что существует функция с данными параметрами и возвращаемым значением. Реальное определение функции может находиться в той же или в другой единице компиляции. Без прототипа функции компилятор не позволил бы нам вызвать эту функцию в строке 12. Имена параметров функции указывать необязательно. </p>
<p class="paragraph">
Процедура компиляции программы зависит от платформы. Например, для компиляции программы в Solaris с использованием компилятора С++ компании «Sun» мы могли бы задать следующие команды: </p>
<p class="paragraph">
CC -с main.cpp </p>
<p class="paragraph">
CC -с square.cpp </p>
<p class="paragraph">
ld main.o square.o -о square </p>
<p class="paragraph">
Первые две строки вызывают компилятор, чтобы сгенерировать файлы .о для соответствующих файлов .cpp. Третья строка вызывает компоновщик и формирует исполняемый модуль с именем square, который может запускаться следующим образом: </p>
<p class="paragraph">
./square 64 </p>
<p class="paragraph">
Эта программа выводит на консоль следующее сообщение: </p>
<p class="paragraph">
The square of 64 is 4096 </p>
<p class="paragraph">
(Квадрат числа 64 равен 4096) </p>
<p class="paragraph">
Чтобы скомпилировать программу, вы, возможно, попросите помощи у местного опытного программиста С++. Если это не удастся сделать, можете прочитать остальную часть приложения, ничего не компилируя, и воспользоваться инструкциями в главе 1 по компиляции вашего первого приложения C++/Qt. В Qt предусмотрены утилиты, позволяющие легко создавать приложения на любой платформе. </p>
<p class="paragraph">
Вернемся к нашей программе. В реальном приложении, как правило, мы размещали бы прототип функции square() в отдельном файле и включали бы этот файл во все единицы компиляции, в которых вызывается эта функция. Такой файл называется заголовочным; он обычно имеет расширение .h (часто встречаются также расширения .hh, .hpp и .hxx). Если переделать наш пример, используя заголовочный файл, то можно было бы создать файл с именем square.h, который содержит следующие строки: </p>
<p class="paragraph">
1 #ifndef SQUARE_H </p>
<p class="paragraph">
2 #define SQUARE_H </p>
<p class="paragraph">
3 double square(double); </p>
<p class="paragraph">
4 #endif </p>
<p class="paragraph">
В начале и в конце заголовочного файла задаются препроцессорные директивы (#ifndef, #define и #endif). Эти директивы гарантируют однократное выполнение заголовочного файла, даже если он несколько раз включается в одну и ту же единицу компиляции (такая ситуация возникает, когда одни заголовочные файлы включают в себя другие заголовочные файлы). По принятым соглашениям используемый для этого препроцессорный символ строится на основе имени файла (в нашем примере это символ SQUARE_H). Позже в этом приложении мы вернемся к рассмотрению препроцессора. </p>
<p class="paragraph">
Новый файл main.cpp будет иметь следующий вид: </p>
<p class="paragraph">
01 #include <cstdlib> </p>
<p class="paragraph">
02 #include <iostream> </p>
<p class="paragraph">
03 #include "square.h" </p>
<p class="paragraph">
04 using namespace std; </p>
<p class="paragraph">
05 int main(int argc, char *argv[]) </p>
<p class="paragraph">
06 { </p>
<p class="paragraph">
07 if (argc != 2) { </p>
<p class="paragraph">
08 cerr << "Usage: square <number>" << endl; </p>
<p class="paragraph">
09 return 1; </p>
<p class="paragraph">
10 } </p>
<p class="paragraph">
11 double n = strtod(argv[1], 0); </p>
<p class="paragraph">
12 cout << "The square of " << argv[1] << " is " << square(n) << endl; </p>
<p class="paragraph">
13 return 0; </p>
<p class="paragraph">
14 } </p>
<p class="paragraph">
Используемая в строке 3 директива #include разворачивает содержимое файла square.h. Директивы, начинающиеся с символа #, рассматриваются препроцессором С++ до фактической компиляции. В прежние дни препроцессор являлся отдельной программой, которую программист вызывал вручную перед выполнением компилятора. В современных компиляторах этап препроцессорной обработки выполняется автоматически. </p>
<p class="paragraph">
Директивы #include в строках 1 и 2 разворачивают содержимое заголовочных файлов cstdlib и iostream, которые являются частью стандартной библиотеки С++. Стандартные заголовочные файлы не имеют суффикса .h. Угловые скобки вокруг имен файлов говорят о том, что заголовочные файлы располагаются в стандартном месте системы, в то время как кавычки заставляют компилятор просматривать текущий каталог. Директивы #include обычно собирают вместе и располагают в верхней части файла .cpp. </p>
<p class="paragraph">
В отличие от файлов .cpp, заголовочные файлы сами по себе не являются единицей компиляции и не приводят к созданию объектных файлов. Они могут только содержать объявления, позволяющие различным единицам компиляции взаимодействовать друг с другом. Следовательно, было бы неправильно помещать реализацию функции square() в какой-нибудь заголовочный файл. Если бы мы это сделали в нашем примере, ничего плохого не случилось бы, потому что square.h включается только однажды, однако если бы мы включали square.h в несколько файлов .cpp, то получили бы несколько реализаций функции square() (по одной на каждый файл .cpp, который включает этот заголовочный файл). После этого компоновщик пожаловался бы на существование нескольких (идентичных) определений функции square() и отказался бы генерировать исполняемый модуль. И наоборот, если мы объявляем функцию, но нигде ее не реализуем, компоновщик пожалуется на наличие «неразрешенного символа». </p>
<p class="paragraph">
До сих пор мы предполагали, что исполняемый модуль состоит только из объектных файлов. На практике они компонуются также с библиотеками, которые реализуют готовую функциональность. Существует два основных типа библиотек: </p>
<p class="paragraph">
• статические библиотеки непосредственно помещаются в исполняемый модуль, как будто они являются объектными файлами. Это гарантирует невозможность потери библиотеки, но увеличивает размер исполняемого модуля; </p>
<p class="paragraph">
• динамические библиотеки (называемые также совместно используемыми библиотеками или библиотеками DLL) располагаются в стандартном месте на машине пользователя и автоматически загружаются во время запуска приложения. </p>
<p class="paragraph">
Программу square мы компонуем со стандартной библиотекой С++, которая реализована как динамическая библиотека на большинстве платформ. Сами средства разработки Qt представляют собой коллекцию библиотек, которые могут создаваться как статические или как динамические библиотеки (по умолчанию они создаются как динамические библиотеки). </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Основные отличия языков</p>
<p class="paragraph">
Теперь мы более внимательно рассмотрим области, в которых С++ отличается от Java и C#. Многие языковые различия объясняются особенностями скомпилированных модулей С++ и повышенным вниманием к производительности. Так, С++ не проверяет границы массивов на этапе выполнения программы и не существует сборщика мусора, восстанавливающего неиспользуемую, динамически выделенную память. </p>
<p class="paragraph">
Для краткости не будут рассматриваться те конструкции С++, которые почти идентичны соответствующим конструкциям Java и C#. Кроме того, здесь не раскрываются некоторые темы С++, потому что их изучение необязательно при программировании с применением Qt. К ним относятся шаблонные классы и функции, определение объединений и использование исключений. Полное описание языка можно найти в таких книгах, как «The С++ Programming Language» (Язык программирования С++) , написанной Бьерном Страуструпом, или «С++ for Java Programmers» (С++ для программистов Java), написанной Марком Аленом Уайссом (Mark Allen Weiss). </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Элементарные типы данных</p>
<p class="paragraph">
Предлагаемые в С++ элементарные типы данных аналогичны тем, которые используются в Java или C#. На рис. Б.2 приводятся список элементарных типов С++ и их определение на платформах, поддерживаемых Qt 4: </p>
<p class="paragraph">
• bool — булево значение, </p>
<p class="paragraph">
• char — 8-битовый целый тип, </p>
<p class="paragraph">
• short — 16-битовый целый тип, </p>
<p class="paragraph">
• int — 32-битовый целый тип, </p>
<p class="paragraph">
• long — 32- или 64-битовый целый тип, </p>
<p class="paragraph">
• long long — 64-битовый целый тип, </p>
<p class="paragraph">
• float — 32-битовое значение числа с плавающей точкой (IEEE 754), </p>
<p class="paragraph">
• double — 64 битовое значение числа с плавающей точкой (IEEE 754). </p>
<p class="paragraph">
По умолчанию short, int, long и long long — типы данных со знаком, т.е. они могут содержать как отрицательные, так и положительные значения. Если необходимо хранить только неотрицательные целые числа, мы можем поставить ключевое слово unsigned (без знака) перед типом. Если тип short может хранить любое значение в промежутке между —32,768 и +32,767, то unsigned short — от 0 до 65 535. Оператор сдвига вправо >> имеет семантику чисел без знака («заполнить нулями»), если один из операндов является типом без знака. </p>
<p class="paragraph">
Тип bool может принимать значения true и false. Кроме того, числовые типы могут использоваться вместо типа bool; в этом случае 0 соответствует значению false, а любое ненулевое значение означает true. </p>
<p class="paragraph">
Тип char используется для хранения как символов ASCII, так и 8-битовых целых чисел (байтов). Целое число, представленное этим типом, в зависимости от платформы может иметь или не иметь знак. Типы signed char и unsigned char могут использоваться для однозначной интерпретации типа char. Qt предоставляет тип QChar, который хранит 16-битовые символы в кодировке Unicode. </p>
<p class="paragraph">
По умолчанию экземпляры встроенных типов не инициализируются. Когда создается переменная типа int, ее значение вполне могло бы быть нулевым, однако с той же вероятностью оно может равняться —209 486 515. К счастью, большинство компиляторов предупреждает нас о попытках чтения неинициализированной переменной, и мы можем использовать такие инструментальные средства, как Rational PurifyPlus и Valgrind, для обнаружения обращений к неинициализированной памяти и других связанных с памятью проблем на этапе выполнения. </p>
<p class="paragraph">
В памяти числовые типы (кроме long) имеют идентичные размеры на различных платформах, поддерживаемых Qt, но их представление меняется в зависимости от принятого в системе порядка байтов. В архитектурах с прямым порядком байтов (например, PowerPC и SPARC) 32-битовое значение 0x12345678 последовательно занимают четыре байта 0х12 0x34 0x56 0х78, в то время как в архитектурах с обратным порядком байтов (например, Intel x86) последовательность байтов будет обратной. Это следует учитывать в программах, копирующих области памяти на диск или посылающих двоичные данные по сети. Класс Qt QDataStream, представленный в («Ввод—вывод»), можно использовать для хранения двоичных данных независимым от платформы способом. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Определения класса</p>
<p class="paragraph">
Классы определяются в С++ аналогично тому, как это делается в Java и C#, однако надо иметь в виду, что существует несколько отличий. Мы рассмотрим эти отличия на нескольких примерах. Начнем с класса, представляющего пару координат (x, у): </p>
<p class="paragraph">
01 #ifndef POINT2D_H </p>
<p class="paragraph">
02 #define POINT2D_H </p>
<p class="paragraph">
03 class Point2D </p>
<p class="paragraph">
04 { </p>
<p class="paragraph">
05 public: </p>
<p class="paragraph">
06 Point2D() { </p>
<p class="paragraph">
07 xVal = 0; </p>
<p class="paragraph">
08 yVal = 0; </p>
<p class="paragraph">
09 } </p>
<p class="paragraph">
10 Point2D(double x, double у) { </p>
<p class="paragraph">
11 xVal = x; </p>
<p class="paragraph">
12 yVal = у; </p>
<p class="paragraph">
13 } </p>
<p class="paragraph">
14 void setX(double x) { xVal = x; } </p>
<p class="paragraph">
15 void setY(double у) { yVal = у; } </p>
<p class="paragraph">
16 double x() const { return xVal; } </p>
<p class="paragraph">
17 double y() const { return yVal; } </p>
<p class="paragraph">
18 private: </p>
<p class="paragraph">
19 double xVal; </p>
<p class="paragraph">
20 double yVal; </p>
<p class="paragraph">
21 }; </p>
<p class="paragraph">
22 #endif </p>
<p class="paragraph">
Представленное выше определение класса обычно оформляется в виде заголовочного файла, типичным названием которого может быть point2d.h. В этом примере проявляются следующие характерные особенности С++: </p>
<p class="paragraph">
• Определение класса разделяется на секции (открытую, защищенную и закрытую) и заканчивается точкой с запятой. Если не указано ни одной секции, по умолчанию используется закрытая секция. (Для совместимости с языком С в С++ предусмотрено ключевое слово struct, идентичное классу с тем исключением, что по умолчанию используется открытая секция). </p>
<p class="paragraph">
• Данный класс имеет два конструктора (один без параметров и другой с двумя параметрами). Если в классе вообще не объявляется конструктор, С++ автоматически добавляет конструктор без параметров и с пустым телом. </p>
<p class="paragraph">
• Функции, получающие данные, x() и y(), объявляются как константные. Это значит, что они не будут (и не смогут) модифицировать переменные—члены или вызывать неконстантные функции—члены (например, setX() и setY().) </p>
<p class="paragraph">
Указанные выше функции реализовывались бы как встроенные функции, являющиеся частью определения класса. Альтернативный подход заключается в предоставлении в заголовочном файле только прототипов функций и реализации функций в файле .cpp. В этом случае заголовочный файл имел бы следующий вид: </p>
<p class="paragraph">
01 #ifndef POINT2D_H </p>
<p class="paragraph">
02 #define POINT2D_H </p>
<p class="paragraph">
03 class Point2D </p>
<p class="paragraph">
04 { </p>
<p class="paragraph">
05 public: </p>
<p class="paragraph">
06 Point2D(); </p>
<p class="paragraph">
07 Point2D(double x, double у); </p>
<p class="paragraph">
08 void setX(double x); </p>
<p class="paragraph">
09 void setY(double у); </p>
<p class="paragraph">
10 double x() const; </p>
<p class="paragraph">
11 double y() const; </p>
<p class="paragraph">
12 private: </p>
<p class="paragraph">
13 double xVal; </p>
<p class="paragraph">
14 double yVal; </p>
<p class="paragraph">
15 }; </p>
<p class="paragraph">
16 #endif </p>
<p class="paragraph">
Реализация функций выполнялась бы в файле point2d.cpp: </p>
<p class="paragraph">
01 #include "point2d.h" </p>
<p class="paragraph">
02 Point2D::Point2D() </p>
<p class="paragraph">
03 { </p>
<p class="paragraph">
04 xVal = 0.0; </p>
<p class="paragraph">
05 yVal = 0.0; </p>
<p class="paragraph">
06 } </p>
<p class="paragraph">
07 Point2D::Point2D(double x, double у) </p>
<p class="paragraph">
08 { </p>
<p class="paragraph">
09 xVal = x; </p>
<p class="paragraph">
10 yVal = у; </p>
<p class="paragraph">
11 } </p>
<p class="paragraph">
12 void Point2D::setX(double x) </p>
<p class="paragraph">
13 { </p>
<p class="paragraph">
14 xVal = x; </p>
<p class="paragraph">
15 } </p>
<p class="paragraph">
16 void Point2D::setY(double у) </p>
<p class="paragraph">
17 { </p>
<p class="paragraph">
18 yVal = у; </p>
<p class="paragraph">
19 } </p>
<p class="paragraph">
20 double Point2D::x() const </p>
<p class="paragraph">
21 { </p>
<p class="paragraph">
22 return xVal; </p>
<p class="paragraph">
23 } </p>
<p class="paragraph">
24 double Point2D::y() const </p>
<p class="paragraph">
25 { </p>
<p class="paragraph">
26 return yVal; </p>
<p class="paragraph">
27 } </p>
<p class="paragraph">
Этот файл начинается с включения заголовочного файла point2d.h, потому что прежде чем компилятор будет выполнять синтаксический анализ реализаций функций—членов, он должен иметь определение класса. Затем идут реализации функций, перед именем которых через оператор :: указывается имя класса. </p>
<p class="paragraph">
Мы узнали, как можно реализовать встроенную функцию и как можно реализовать ее в файле .cpp. Семантически эти два подхода эквивалентны, однако при вызове встроенной функции большинство компиляторов просто разворачивают тело функции вместо формирования реального вызова функции. Обычно это ведет к получению более быстрого кода, но может увеличить размер приложения. По этой причине только очень короткие функции следует делать встроенными; длинные функции всегда следует реализовывать в файле .cpp. Кроме того, если мы забудем реализовать какую-нибудь функцию и попытаемся ее вызвать, компоновщик «пожалуется» на существование неразрешенного символа. </p>
<p class="paragraph">
Теперь попытаемся использовать этот класс. </p>
<p class="paragraph">
01 #include "point2d.h" </p>
<p class="paragraph">
02 int main() </p>
<p class="paragraph">
03 { </p>
<p class="paragraph">
04 Point2D alpha; </p>
<p class="paragraph">
05 Point2D beta(0.666, 0.875); </p>
<p class="paragraph">
06 alpha.setX(beta.y()); </p>
<p class="paragraph">
07 beta.setY(alpha.x()); </p>
<p class="paragraph">
08 return 0; </p>
<p class="paragraph">
09 } </p>
<p class="paragraph">
В С++ переменные любого типа можно объявлять без непосредственного использования оператора new. Первая переменная инициализируется с помощью стандартного конструктора Point2D (т.е. конструктора без параметров). Вторая переменная инициализируется с использованием второго конструктора. Обращение к члену объекта осуществляется с использованием оператора . (точка). </p>
<p class="paragraph">
Объявленные таким образом переменные ведут себя как элементарные типы Java и C# (такие, как int и double). Например, при использовании оператора присваивания копируется содержимое переменной, а не ссылка на объект. И если позже переменная будет модифицирована, значение всех других переменных, к которым присваивалась первая переменная, не изменится. </p>
<p class="paragraph">
С++, как объектно—ориентированный язык, поддерживает наследование и полиморфизм. Для иллюстрации этих свойств мы рассмотрим пример абстрактного класса Shape (фигура) и подкласса Circle (окружность). Начнем с базового класса: </p>
<p class="paragraph">
01 #ifndef SHAPE_H </p>
<p class="paragraph">
02 #define SHAPE_H </p>
<p class="paragraph">
03 #include "point2d.h" </p>
<p class="paragraph">
04 class Shape </p>
<p class="paragraph">
05 { </p>
<p class="paragraph">
06 public: </p>
<p class="paragraph">
07 Shape(Point2D center) { myCenter = center; } </p>
<p class="paragraph">
08 virtual void draw() = 0; </p>
<p class="paragraph">
09 protected: </p>
<p class="paragraph">
10 Point2D myCenter; </p>
<p class="paragraph">
11 }; </p>
<p class="paragraph">
12 #endif </p>
<p class="paragraph">
Определение класса создается в заголовочном файле с именем shape.h. Поскольку в этом определении делается ссылка на класс Point2D, мы включаем заголовочный файл point2d.h. </p>
<p class="paragraph">
Класс Shape не имеет базового класса. В отличие от Java и C#, в С++ не предусмотрен обобщенный класс Object, который наследуется всеми другими классами. Qt предоставляет QObject в качестве естественного базового класса для объектов всех типов. </p>
<p class="paragraph">
Объявление функции draw() имеет две интересные особенности. Она содержит ключевое слово virtual и завершается равенством = 0. Ключевое слово virtual означает, что данная функция может быть переопределена в подклассах. Подобно C# функции—члены в С++ по умолчанию не могут переопределяться. Странное приравнивание = 0 указывает на то, что данная функция — чисто виртуальная функция, которая не имеет реализации по умолчанию, и она должна быть реализована в подклассах. Концепция «интерфейса» в Java и C# соответствует в С++ классу, содержащему только чисто виртуальные функции. </p>
<p class="paragraph">
Ниже приводится определение подкласса Circle: </p>
<p class="paragraph">
01 #ifndef CIRCLE_H </p>
<p class="paragraph">
02 #define CIRCLE_H </p>
<p class="paragraph">
03 #include "shape.h" </p>
<p class="paragraph">
04 class Circle : public Shape </p>
<p class="paragraph">
05 { </p>
<p class="paragraph">
06 public: </p>
<p class="paragraph">
07 Circle(Point2D center, double radius = 0.5) </p>
<p class="paragraph">
08 : Shape(center) { </p>
<p class="paragraph">
09 myRadius = radius; </p>
<p class="paragraph">
10 } </p>
<p class="paragraph">
11 void draw() { </p>
<p class="paragraph">
12 // здесь выполняются какие-то действия </p>
<p class="paragraph">
13 } </p>
<p class="paragraph">
14 private: </p>
<p class="paragraph">
15 double myRadius; </p>
<p class="paragraph">
16 }; </p>
<p class="paragraph">
17 #endif </p>
<p class="paragraph">
Класс Circle наследует класс Shape в открытой форме, т.е. все открытые члены класса Shape остаются открытыми в Circle. С++ поддерживает также защищенное и закрытое наследование, которое ограничивает доступ к открытым и защищенным членам базового класса. </p>
<p class="paragraph">
Конструктор принимает два параметра. Второй параметр необязателен, по умолчанию он принимает значение 0.5. Конструктор передает параметр center конструктору базового класса, для чего используется специальный синтаксис списка инициализации между сигнатурой функции и телом функции. В теле функции мы инициализируем переменную—член myRadius. Инициализацию этой переменной можно было сделать в той же строке, где инициализируется конструктор базового класса: </p>
<p class="paragraph">
Circle(Point2D center, double radius = 0.5) </p>
<p class="paragraph">
: Shape(center), myRadius(radius) { } </p>
<p class="paragraph">
С другой стороны, С++ не позволяет инициализировать переменную—член в определении класса, поэтому следующий программный код неверен: </p>
<p class="paragraph">
// НЕ БУДЕТ КОМПИЛИРОВАТЬСЯ </p>
<p class="paragraph">
private: </p>
<p class="paragraph">
double myRadius = 0.5; </p>
<p class="paragraph">
}; </p>
<p class="paragraph">
Сигнатура функции draw() совпадает с сигнатурой виртуальной функции draw(), определенной в классе Shape. Она здесь переопределяется и будет вызываться полиморфно, когда draw() вызывается экземпляром Circle через ссылку или указатель на Shape. С++ не имеет ключевого слова override, доступного в C#. С++ также не имеет ключевых слов super и base, ссылающихся на базовый класс. Если требуется вызвать базовую реализацию функции, можно перед именем функции указать имя базового класса и оператор ::. Например: </p>
<p class="paragraph">
01 class LabeledCircle : public Circle </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 public: </p>
<p class="paragraph">
04 void draw() { </p>
<p class="paragraph">
05 Circle::draw(); </p>
<p class="paragraph">
06 drawLabel(); </p>
<p class="paragraph">
07 } </p>
<p class="paragraph">
08 }; </p>
<p class="paragraph">
С++ поддерживает множественное наследование, т.е. возможность создавать класс, производный сразу от нескольких других классов. При этом используется следующий синтаксис: </p>
<p class="paragraph">
class DerivedClass : public BaseClass1, public BaseClass2, …, </p>
<p class="paragraph">
public BaseClassN </p>
<p class="paragraph">
{ </p>
<p class="paragraph">
… </p>
<p class="paragraph">
}; </p>
<p class="paragraph">
По умолчанию функции и переменные, объявленные в классе, связываются с экземплярами этого класса. Мы можем объявлять статические функции—члены и статические переменные—члены, которые могут использоваться без экземпляра. Например: </p>
<p class="paragraph">
01 #ifndef TRUCK_H </p>
<p class="paragraph">
02 #define TRUCK_H </p>
<p class="paragraph">
03 class Truck </p>
<p class="paragraph">
04 { </p>
<p class="paragraph">
05 public: </p>
<p class="paragraph">
06 Truck() { ++counter; } </p>
<p class="paragraph">
07 ~Truck() { --counter; } </p>
<p class="paragraph">
08 static int instanceCount() { return counter; } </p>
<p class="paragraph">
09 private: </p>
<p class="paragraph">
10 static int counter; </p>
<p class="paragraph">
11 }; </p>
<p class="paragraph">
12 #endif </p>
<p class="paragraph">
Статическая переменная—член счетчика counter отслеживает количество экземпляров truck, которые существуют в любой момент времени. Конструктор truck его увеличивает на единицу. Деструктор, опознаваемый по префиксу ~, уменьшает счетчик на единицу. В С++ деструктор автоматически вызывается, когда статически распределенная переменная выходит из области видимости или когда удаляется переменная, память для которой выделяется при помощи оператора new. Это аналогично тому, что делается в методе finalize() в Java, за исключением того, что мы можем рассчитывать на его вызов в определенный момент времени. </p>
<p class="paragraph">
Статическая переменная—член существует в единственном экземпляре для класса — такие переменные являются «переменными класса», а не «переменными экземпляра». Каждая статическая переменная—член должна определяться в файле .cpp (но без повторения ключевого слова static). Например: </p>
<p class="paragraph">
#include "truck.h" </p>
<p class="paragraph">
int Truck::counter = 0; </p>
<p class="paragraph">
Если этого не сделать, компоновщик выдаст сообщение об ошибке из-за наличия «неразрешенного символа». Обращаться к статической функции instanceCount() можно за пределами класса, указывая имя класса перед ее именем. Например: </p>
<p class="paragraph">
01 #include <iostream> </p>
<p class="paragraph">
02 #include "truck.h" </p>
<p class="paragraph">
03 using namespace std; </p>
<p class="paragraph">
04 int main() </p>
<p class="paragraph">
05 { </p>
<p class="paragraph">
06 Truck truck1; </p>
<p class="paragraph">
07 Truck truck2; </p>
<p class="paragraph">
08 cout << Truck::instanceCount() << " equals 2" << endl; </p>
<p class="paragraph">
09 return 0; </p>
<p class="paragraph">
10 } </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Указатели</p>
<p class="paragraph">
Указатель в С++ — это переменная, содержащая не сам объект, а адрес памяти, где располагается объект. Java и C# имеют аналогичную концепцию «ссылки» при другом синтаксисе. Мы начнем с рассмотрения придуманного нами примера, иллюстрирующего применение указателей: </p>
<p class="paragraph">
01 #include "point2d.h" </p>
<p class="paragraph">
02 int main() </p>
<p class="paragraph">
03 { </p>
<p class="paragraph">
04 Point2D alpha; </p>
<p class="paragraph">
05 Point2D beta; </p>
<p class="paragraph">
06 Point2D *ptr; </p>
<p class="paragraph">
07 ptr = α </p>
<p class="paragraph">
08 ptr->setX(1.0); </p>
<p class="paragraph">
09 ptr->setY(2.5); </p>
<p class="paragraph">
10 ptr = β </p>
<p class="paragraph">
11 ptr->setX(4.0); </p>
<p class="paragraph">
12 ptr->setY(4.5); </p>
<p class="paragraph">
13 ptr = 0; </p>
<p class="paragraph">
14 return 0; </p>
<p class="paragraph">
15 } </p>
<p class="paragraph">
В этом примере используется класс Point2D из предыдущего подраздела. В строках 4 и 5 определяется два объекта типа Point2D. Эти объекты инициализируются в значение (0, 0) стандартным конструктором Point2D. </p>
<p class="paragraph">
В строке 6 определяется указатель на объект Point2D. Для обозначения указателя здесь используется звездочка перед именем переменной. Поскольку мы не инициализируем указатель, он будет содержать произвольный адрес памяти. Эта ситуация изменяется в строке 7, в которой адрес alpha присваивается этому указателю. Унарный оператор & возвращает адрес памяти, где располагается объект. Адрес обычно представляет собой 32-битовое или 64-битовое целое число, задающее смещение объекта в памяти. </p>
<p class="paragraph">
В строках 8 и 9 мы обращаемся к объекту alpha с помощью указателя ptr. Поскольку ptr является указателем, а не объектом, необходимо использовать оператор -> (стрелка) вместо оператора . (точка). </p>
<p class="paragraph">
В строке 10 указателю присваивается адрес beta. С этого момента любая выполняемая нами операция с этим указателем будет воздействовать на объект beta. </p>
<p class="paragraph">
В строке 13 указатель устанавливается в нулевое значение. С++ не имеет ключевого слова для представления указателя, который не ссылается ни на один объект; вместо этого мы используем значение 0 (или символическую константу NULL, которая разворачивается в 0). Попытка применения нулевого указателя приведет к краху приложения с выводом такого сообщения об ошибке, как «Segmentation fault» (ошибка сегментации), «General protection fault» (общая ошибка защиты) или «Bus error» (ошибка шины). Применяя отладчик, можно найти строку программного кода, которая приводит к краху. </p>
<p class="paragraph">
В конце функции объект alpha содержит пару координат (1.0, 2.5), а объект beta — (4.0,4.5). </p>
<p class="paragraph">
Указатели часто используются для хранения объектов, память для которых выделяется динамически с помощью оператора new. Используя жаргон С++ можно сказать, что эти объекты распределяются в «куче», в то время как локальные переменные (т.е. переменные, определенные внутри функции) хранятся в «стеке». </p>
<p class="paragraph">
Ниже приводится фрагмент программного кода, иллюстрирующий динамическое распределение памяти при помощи оператора new: </p>
<p class="paragraph">
01 #include "point2d.h" </p>
<p class="paragraph">
02 int main() </p>
<p class="paragraph">
03 { </p>
<p class="paragraph">
04 Point2D *point = new Point2D; </p>
<p class="paragraph">
05 point->setX(1.0); </p>
<p class="paragraph">
06 point->setY(2.5); </p>
<p class="paragraph">
07 delete point; </p>
<p class="paragraph">
08 return 0; </p>
<p class="paragraph">
09 } </p>
<p class="paragraph">
Оператор new возвращает адрес памяти для нового распределенного объекта. Мы сохраняем адрес в переменной указателя и обращаемся к объекту через этот указатель. Поработав с объектом, мы возвращаем занимаемую им память, используя оператор delete. В отличие от Java и C#, сборщик мусора отсутствует в С++; динамически распределяемые объекты должны явно освобождать занимаемую ими память при помощи оператора delete, когда они становятся больше ненужными. В описывается механизм родственных связей Qt, который значительно упрощает управление памятью в программах, написанных на С++. </p>
<p class="paragraph">
Если не вызвать оператор delete, память остается занятой до тех пор, пока не завершится программа. Это не создаст никаких проблем в приведенном выше примере, потому что память выделяется только для одного объекта, однако в программе, в которой постоянно создаются новые объекты, это может привести к нехватке машинной памяти. После удаления объекта переменная указателя по-прежнему будет хранить адрес объекта. Такой указатель является «повисшим указателем» и не должен использоваться для обращения к объекту. Qt предоставляет «умный» указатель QPointer<T>, который автоматически устанавливает себя в 0, если удаляется объект QObject, на который он ссылается. </p>
<p class="paragraph">
В приведенном выше примере мы вызывали стандартный конструктор и функции setX() и setY() для инициализации объекта. Вместо этого можно было использовать конструктор с двумя параметрами: </p>
<p class="paragraph">
Point2D *point = new Point2D(1.0, 2.5); </p>
<p class="paragraph">
Кроме того, мы могли бы распределить объект в стеке следующим образом: </p>
<p class="paragraph">
Point2D point; </p>
<p class="paragraph">
point.setX(1.0); </p>
<p class="paragraph">
point.setY(2.5); </p>
<p class="paragraph">
Распределенные таким образом объекты автоматически освобождаются в конце блока, в котором они появляются. </p>
<p class="paragraph">
Если мы не собираемся модифицировать объект при помощи указателя, можно объявить указатель как константный. Например: </p>
<p class="paragraph">
const Point2D *ptr = new Point2D(1.0, 2.5); </p>
<p class="paragraph">
double x = ptr->x(); </p>
<p class="paragraph">
double у = ptr->y(); </p>
<p class="paragraph">
// НЕ БУДЕТ КОМПИЛИРОВАТЬСЯ </p>
<p class="paragraph">
ptr->setX(4.0); </p>
<p class="paragraph">
*ptr = Point2D(4.0, 4.5); </p>
<p class="paragraph">
Константный указатель ptr можно использовать лишь для вызова константных функций-членов, например x() и y(). Признаком хорошего стиля является объявление указателей константными, когда нет намерения модификации объекта с их помощью. Более того, если сам объект является константным, ничего не остается, кроме использования константного указателя для хранения его адреса. Применение ключевого слова const предоставляет компилятору информацию, позволяющую обнаруживать ошибки на ранних этапах и повысить производительность. C# имеет ключевое слово const с очень похожими свойствами. Ближайшим эквивалентом в Java является ключевое слово final, однако оно лишь защищает переменные от операций присваивания, но не от вызова «неконстантных» функций—членов объекта. </p>
<p class="paragraph">
Указатели могут использоваться со встроенными типами так же, как с классами. Используемый в выражении унарный оператор * возвращает значение объекта, на который ссылается указатель. Например: </p>
<p class="paragraph">
int i = 10; </p>
<p class="paragraph">
int j = 20; </p>
<p class="paragraph">
int *p = &i; </p>
<p class="paragraph">
int *q = &j; </p>
<p class="paragraph">
cout << *p << " equals 10" << endl; </p>
<p class="paragraph">
cout << *q << " equals 20" << endl; </p>
<p class="paragraph">
*p = 40; </p>
<p class="paragraph">
cout << i << " equals 40" << endl; </p>
<p class="paragraph">
p = q; </p>
<p class="paragraph">
*p = 100; </p>
<p class="paragraph">
cout << i << " equals 40" << endl; </p>
<p class="paragraph">
cout << j << " equals 100" << endl; </p>
<p class="paragraph">
Оператор ->, который можно использовать для обращения к членам объекта через указатель, является чисто синтаксическим приемом. Вместо ptr->member можно также написать (*ptr).member. Скобки обязательны, потому что оператор . (точка) имеет более высокий приоритет, чем унарный оператор *. </p>
<p class="paragraph">
Указатели имели плохую репутацию в С и С++, причем доходило до того, что рекламировалось отсутствие указателей в языке Java. На самом деле указатели С++ концептуально аналогичны ссылкам в Java и C#, за исключением того, что указатели можно использовать для прохода по памяти, как мы это увидим позже в данном разделе. Более того, включение в Qt классов—контейнеров, использующих метод «копирования при записи» вместе со способностью С++ инстанцировать любой класс в стеке, означает возможность во многих случаях обойтись без указателей. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Ссылки</p>
<p class="paragraph">
Кроме указателей С++ поддерживает также концепцию «ссылки». Подобно указателю, ссылка в С++ хранит адрес объекта. Основными отличиями являются следующие: </p>
<p class="paragraph">
• Объявляются ссылки с применением оператора & вместо *. </p>
<p class="paragraph">
• Ссылка должна быть инициализирована и не может в дальнейшем изменяться. </p>
<p class="paragraph">
• С помощью ссылки обеспечивается прямое обращение к объекту; не предусмотрен специальный синтаксис, подобный операторам * или ->. </p>
<p class="paragraph">
• Ссылка не может быть нулевой. </p>
<p class="paragraph">
Ссылки в основном используются при объявлении параметров. По умолчанию в С++ используется передача параметров по значению, т.е. при передаче параметров функции последняя получает в действительности новую копию объекта. Ниже приводится определение функции, которая получает параметры, передаваемые по значению. </p>
<p class="paragraph">
#include <cstdlib> </p>
<p class="paragraph">
using namespace std; </p>
<p class="paragraph">
double manhattanDistance(Point2D a, Point2D b) </p>
<p class="paragraph">
{ </p>
<p class="paragraph">
return abs(b.x() - a.x()) + abs(b.y() - a.y()); </p>
<p class="paragraph">
} </p>
<p class="paragraph">
Эта функция может вызываться следующим образом: </p>
<p class="paragraph">
Point2D harlem(77.5, 50.0); </p>
<p class="paragraph">
Point2D broadway(12.5, 40.0); </p>
<p class="paragraph">
double distance = manhattanDistance(broadway, harlem); </p>
<p class="paragraph">
Опытные С—программисты избегают операций копирования путем объявления параметров в виде указателей вместо значений: </p>
<p class="paragraph">
double manhattanDistance(const Point2D *ap, const Point2D *bp) </p>
<p class="paragraph">
{ </p>
<p class="paragraph">
return abs(bp->x() - ap->x()) + abs(bp->y() - ap->y()); </p>
<p class="paragraph">
} </p>
<p class="paragraph">
После этого при вызове функции должны передаваться адреса вместо значений: </p>
<p class="paragraph">
Point2D harlem(77.5, 50.0); </p>
<p class="paragraph">
Point2D broadway(12.5, 40.0); </p>
<p class="paragraph">
double distance = manhattanDistance(&broadway, &harlem); </p>
<p class="paragraph">
Ссылки введены в С++ для того, чтобы сделать синтаксис менее громоздким и чтобы предотвратить передачу нулевого указателя. Если вместо указателей использовать ссылки, функция будет иметь следующий вид: </p>
<p class="paragraph">
double manhattanDistance(const Point2D &a, const Point2D &b) </p>
<p class="paragraph">
{ </p>
<p class="paragraph">
return abs(b.x() - a.x()) + abs(b.y() - a.y()); </p>
<p class="paragraph">
} </p>
<p class="paragraph">
Ссылка объявляется аналогично указателю с использованием & вместо *. Однако при использовании ссылки можно забыть о том, что она является каким-то адресом памяти, и рассматривать ее как обычную переменную. Кроме того, вызов функции, принимающей ссылки в качестве аргументов, не требует специальной записи аргументов (не требуется задавать оператор &). </p>
<p class="paragraph">
В конце концов, заменяя в списке параметров Point2D на const Point2D &, мы уменьшаем накладные расходы на вызов функции — вместо копирования 256 битов (размер четырех типов double) копируются только 64 или 128 бит, что зависит от размера указателя, принятого в целевой платформе. </p>
<p class="paragraph">
В предыдущем примере использовались константные ссылки, не позволяющие модифицировать в функции объекты, обращение к которым осуществляется с помощью ссылок. Когда желателен этот побочный эффект, можно передавать неконстантную ссылку или указатель. Например: </p>
<p class="paragraph">
void transpose(Point2D &point) </p>
<p class="paragraph">
{ </p>
<p class="paragraph">
double oldX = point.x(); </p>
<p class="paragraph">
point.setX(point.y()); </p>
<p class="paragraph">
point.setY(oldX); </p>
<p class="paragraph">
} </p>
<p class="paragraph">
В некоторых случаях имеется ссылка и требуется вызвать функцию, которая принимает указатель и наоборот. Для преобразования ссылки в указатель можно просто использовать унарный оператор &: </p>
<p class="paragraph">
Point2D point; </p>
<p class="paragraph">
Point2D &ref = point; </p>
<p class="paragraph">
Point2D *ptr = &ref; </p>
<p class="paragraph">
Для преобразования указателя в ссылку используется унарный оператор *: </p>
<p class="paragraph">
Point2D point; </p>
<p class="paragraph">
Point2D *ptr = &point; </p>
<p class="paragraph">
Point2D &ref = *ptr; </p>
<p class="paragraph">
Ссылки и указатели представляются в памяти одинаково и часто могут использоваться вместо друг друга, из-за чего возникает естественный вопрос о том, в каких случаях что из них следует предпочесть. С одной стороны, ссылки имеют более удобный синтаксис, с другой стороны — указатели в любой момент можно вновь устанавливать на указатель другого объекта, они могут содержать нулевое значение и более явный синтаксис их применения часто является неприятностью, неожиданно оказавшейся благом. По этим причинам предпочтение часто отдается указателям, а ссылки почти исключительно используются при объявлении параметров функций совместно с ключевым словом const. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Массивы</p>
<p class="paragraph">
Массивы в С++ объявляются с указанием количества элементов массива в квадратных скобках после имени переменной массива. Допускаются двумерные массивы, т.е. массив массивов. Ниже приводится определение одномерного массива, содержащего 10 элементов типа int: </p>
<p class="paragraph">
int fibonacci[10]; </p>
<p class="paragraph">
Доступ к элементам осуществляется с помощью следующей записи: fibonacci[0], fibonacci[1], … fibonacci[9]. Часто требуется инициализировать массив при его определении: </p>
<p class="paragraph">
int fibonacci[10] = { 0, 1, 1, 2, 3, 5, 8, 13, 21, 34 }; </p>
<p class="paragraph">
В таких случаях можно не указывать размер массива, поскольку компилятор может его рассчитать по количеству элементов в списке инициализации: </p>
<p class="paragraph">
int fibonacci[] = { 0, 1, 1, 2, 3, 5, 8, 13, 21, 34 }; </p>
<p class="paragraph">
Статическая инициализация также работает для сложных типов, например для Point2D: </p>
<p class="paragraph">
Point2D triangle[] = { </p>
<p class="paragraph">
Point2D(0.0, 0.0), Point2D(1.0, 0.0), Point2D(0.5, 0.866) </p>
<p class="paragraph">
}; </p>
<p class="paragraph">
Если не предполагается в дальнейшем изменять массив, его можно сделать константным: </p>
<p class="paragraph">
const int fibonacci[] = { 0, 1, 1, 2, 3, 5, 8, 13, 21, 34 }; </p>
<p class="paragraph">
Для нахождения количества элементов в массиве можно использовать оператор sizeof(): </p>
<p class="paragraph">
int n = sizeof(fibonacci) / sizeof(fibonacci[0]); </p>
<p class="paragraph">
Оператор sizeof() возвращает размер аргумента в байтах. Количество элементов массива равно его размеру в байтах, поделенному на размер одного его элемента. Поскольку это долго вводить, распространенной альтернативой является объявление константы и ее использование при определении массива: </p>
<p class="paragraph">
enum { NFibonacci = 10 }; </p>
<p class="paragraph">
const int fibonacci[NFibonacci] = { 0, 1, 1, 2, 3, 5, 8, 13, 21, 34 }; </p>
<p class="paragraph">
Есть соблазн объявить константу как переменную типа const int. К сожалению, некоторые компиляторы имеют проблемы при использовании константных переменных для представления размера массива. Ключевое слово enum будет объяснено далее в этом приложении. </p>
<p class="paragraph">
Проход в цикле по массиву обычно выполняется с использованием переменной целого типа. Например: </p>
<p class="paragraph">
for (int i = 0; i < NFibonacci; ++i) </p>
<p class="paragraph">
cout << fibonacci[i] << endl; </p>
<p class="paragraph">
Массив можно также проходить с помощью указателя: </p>
<p class="paragraph">
const int *ptr = &fibonacci[0]; </p>
<p class="paragraph">
while (ptr != &fibonacci[10]) { </p>
<p class="paragraph">
cout << *ptr << endl; </p>
<p class="paragraph">
++ptr; </p>
<p class="paragraph">
} </p>
<p class="paragraph">
Мы инициализируем указатель адресом первого элемента и проходим его в цикле, пока не достигнем элемента «после последнего элемента» («одиннадцатого» элемента, fibonacci[10]). На каждом шаге цикла оператор ++ продвигает указатель к следующему элементу. </p>
<p class="paragraph">
Вместо &fibonacci[0] можно было бы также написать fibonacci. Это объясняется тем, что указанное без элементов имя массива автоматически преобразуется в указатель на первый элемент массива. Аналогично можно было бы подставить fibonacci + 10 вместо &fibonacci[10]. Эти приемы работают и в других местах: мы можем получить содержимое текущего элемента, используя запись *ptr или ptr[0], а получить доступ к следующему элементу могли бы, используя *(ptr + 1) или ptr[1]. Это свойство иногда называют «эквивалентностью указателей и массивов». </p>
<p class="paragraph">
Чтобы не допустить того, что считается необоснованной неэффективностью, С++ не позволяет передавать массивы функциям по значению. Вместо этого передается адрес массива. Например: </p>
<p class="paragraph">
01 #include <iostream> </p>
<p class="paragraph">
02 using namespace std; </p>
<p class="paragraph">
03 void printIntegerTable(const int *table, int size) </p>
<p class="paragraph">
04 { </p>
<p class="paragraph">
05 for (int i = 0; i < size; ++i) </p>
<p class="paragraph">
06 cout << table[i] << endl; </p>
<p class="paragraph">
07 } </p>
<p class="paragraph">
08 int main() </p>
<p class="paragraph">
09 { </p>
<p class="paragraph">
10 const int fibonacci[10] = { 0, 1, 1, 2, 3, 5, 8, 13, 21, 34 }; </p>
<p class="paragraph">
11 printIntegerTable(fibonacci, 10); </p>
<p class="paragraph">
12 return 0; </p>
<p class="paragraph">
13 } </p>
<p class="paragraph">
Ирония в том, что, хотя С++ не позволяет выбирать между передачей массива по ссылке и передачей по значению, он предоставляет некоторую свободу синтаксиса при объявлении типа параметра. Вместо const int *table можно было бы также написать const int table[] для объявления в качестве параметра указателя на константный тип int. Аналогично параметр argv функции main() можно объявлять как char *argv[] или как char **argv. </p>
<p class="paragraph">
Для копирования одного массива в другой можно пройти в цикле по элементам массива: </p>
<p class="paragraph">
const int fibonacci[NFibonacci] = { 0, 1, 1, 2, 3, 5, 8, 13, 21, 34 }; </p>
<p class="paragraph">
int temp[NFibonacci]; </p>
<p class="paragraph">
for (int i = 0; i < NFibonacci; ++i) </p>
<p class="paragraph">
temp[i] = fibonacci[i]; </p>
<p class="paragraph">
Для базовых типов, таких как int, можно также использовать функцию std::memcpy(), которая копирует блок памяти. Например: </p>
<p class="paragraph">
memcpy(temp, fibonacci, sizeof(fibonacci)); </p>
<p class="paragraph">
При объявлении массива С++ его размер должен быть константой. Если необходимо создать массив переменного размера, это можно сделать несколькими способами: </p>
<p class="paragraph">
• Выделять память под массив можно динамически: </p>
<p class="paragraph">
int *fibonacci = new int[n]; </p>
<p class="paragraph">
Оператор new [] выделяет последовательные участки памяти под определенное количество элементов и возвращает указатель на первый элемент. Благодаря принципу «эквивалентности указателей и массивов» обращаться к элементам можно с помощью указателей: fibonacci[0], fibonacci[1], … fibonacci[n — 1]. После завершения работы с массивом необходимо освободить занимаемую им память, используя оператор delete []: </p>
<p class="paragraph">
delete [] fibonacci; </p>
<p class="paragraph">
• Можно использовать стандартный класс std::vector<T>: </p>
<p class="paragraph">
#include <vector> </p>
<p class="paragraph">
using namespace std; </p>
<p class="paragraph">
vector<int> fibonacci(n); </p>
<p class="paragraph">
Обращаться к элементам можно с помощью оператора [], как это делается для обычного массива С++. При использовании вектора std::vector<T> (где T — тип элемента, хранимого в векторе) можно изменить его размер в любой момент с помощью функции resize(), и его можно копировать, применяя оператор присваивания. Классы, содержащие угловые скобки в имени, называются шаблонными классами. </p>
<p class="paragraph">
• Можно использовать класс Qt QVector<T>: </p>
<p class="paragraph">
#include <QVector> </p>
<p class="paragraph">
QVector<int> fibonacci(n); </p>
<p class="paragraph">
Программный интерфейс вектора QVector<T> очень похож на интерфейс вектора std::vector<T>, кроме того, он поддерживает возможность прохода по его элементам с помощью ключевого слова Qt foreach и использует неявное совмещение данных («копирование при записи») как метод оптимизации расхода памяти и повышения быстродействия. В представлены классы—контейнеры Qt и объясняется их связь со стандартными контейнерами С++. </p>
<p class="paragraph">
Может возникнуть соблазн применения везде векторов std::vector<T> или QVector<T> вместо встроенных массивов. Тем не менее полезно иметь представление о работе встроенных массивов, потому что рано или поздно вам может потребоваться очень быстрый программный код или придется использовать существующие библиотеки С. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Символьные строки</p>
<p class="paragraph">
Основной способ представления символьных строк в С++ заключается в применении массива символов char, завершаемого нулевым байтом ('\0'). Следующие четыре функции демонстрируют работу таких строк: </p>
<p class="paragraph">
01 void hello1() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 const char str[] = { </p>
<p class="paragraph">
04 'H', 'e', 'l', 'l', 'o', ' ', 'w', 'o', 'r' 'l', 'd', '\0' </p>
<p class="paragraph">
05 }; </p>
<p class="paragraph">
06 cout << str << endl; </p>
<p class="paragraph">
07 } </p>
<p class="paragraph">
08 void hello2() </p>
<p class="paragraph">
09 { </p>
<p class="paragraph">
10 const char str[] = "Hello world!"; </p>
<p class="paragraph">
11 cout << str << endl; </p>
<p class="paragraph">
12 } </p>
<p class="paragraph">
13 void hello3() </p>
<p class="paragraph">
14 { </p>
<p class="paragraph">
15 cout << "Hello world!" << endl; </p>
<p class="paragraph">
16 } </p>
<p class="paragraph">
17 void hello4() </p>
<p class="paragraph">
18 { </p>
<p class="paragraph">
19 const char *str = "Hello world!"; </p>
<p class="paragraph">
20 cout << str << endl; </p>
<p class="paragraph">
21 } </p>
<p class="paragraph">
В первой функции строка объявляется как массив и инициализируется посимвольно. Обратите внимание на символ в конце '\0', обозначающий конец строки. Вторая функция имеет аналогичное определение массива, но на этот раз для инициализации массива используется строковый литерал. В С++ строковые литералы — это просто массивы символов const char, завершающиеся символом '\0', который не указывается в литерале. В третьей функции строковый литерал используется непосредственно без придания ему имени. После перевода на инструкции машинного языка она будет идентична первым двум функциям. </p>
<p class="paragraph">
Четвертая функция немного отличается, поскольку создает не только массив (без имени), но и переменную—указатель с именем str, в которой хранится адрес первого элемента массива. Несмотря на это, семантика данной функции идентична семантике предыдущих трех функций, и оптимизирующий компилятор удалит лишнюю переменную str. </p>
<p class="paragraph">
Функции, принимающие в качестве аргументов строки С++, обычно объявляют их как char * или const char *. Ниже приводится короткая программа, иллюстрирующая оба подхода: </p>
<p class="paragraph">
01 #include <cctype> </p>
<p class="paragraph">
02 #include <iostream> </p>
<p class="paragraph">
03 using namespace std; </p>
<p class="paragraph">
04 void makeUppercase(char *str) </p>
<p class="paragraph">
05 { </p>
<p class="paragraph">
06 for (int i = 0; str[i] != '\0'; ++i) </p>
<p class="paragraph">
07 str[i] = toupper(str[i]); </p>
<p class="paragraph">
08 } </p>
<p class="paragraph">
09 void writeLine(const char *str) </p>
<p class="paragraph">
10 { </p>
<p class="paragraph">
11 cout << str << endl; </p>
<p class="paragraph">
12 } </p>
<p class="paragraph">
13 int main(int argc, char *argv[]) </p>
<p class="paragraph">
14 { </p>
<p class="paragraph">
15 for (int i = 1; i < argc; ++i) { </p>
<p class="paragraph">
16 makeUppercase(argv[i]); </p>
<p class="paragraph">
17 writeLine(argv[i]); </p>
<p class="paragraph">
18 } </p>
<p class="paragraph">
19 return 0; </p>
<p class="paragraph">
20 } </p>
<p class="paragraph">
В С++ тип char обычно занимает 8 бит. Это значит, что в массиве символов char легко можно хранить строки в кодировке ASCII, ISO 8859-1 (Latin-1) и в других 8-битовых кодировках, но нельзя хранить произвольные символы Unicode, если не прибегать к многобайтовым последовательностям. Qt предоставляет мощный класс QString, который хранит строки Unicode в виде последовательностей 16-битовых символов QChar и при их реализации использует оптимизацию неявного совмещения данных («копирование при записи»). Более подробно строки QString рассматриваются в («Классы—контейнеры») и в («Интернационализация»). </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Перечисления</p>
<p class="paragraph">
С++ позволяет с помощью перечисления объявлять набор поименованных констант аналогично тому, как это делается в C#. Предположим, что в программе требуется хранить названия дней недели: </p>
<p class="paragraph">
enum DayOfWeek { </p>
<p class="paragraph">
Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday </p>
<p class="paragraph">
}; </p>
<p class="paragraph">
Обычно это объявление располагается в заголовочном файле или даже внутри класса. Приведенное выше объявление на первый взгляд представляется эквивалентным следующим определениям констант: </p>
<p class="paragraph">
const int Sunday = 0; </p>
<p class="paragraph">
const int Monday = 1; </p>
<p class="paragraph">
const int Tuesday = 2; </p>
<p class="paragraph">
const int Wednesday = 3; </p>
<p class="paragraph">
const int Thursday = 4; </p>
<p class="paragraph">
const int Friday = 5; </p>
<p class="paragraph">
const int Saturday = 6; </p>
<p class="paragraph">
Применяя конструкцию перечисления, мы можем затем объявлять переменные или параметры типа DayOfWeek, и компилятор гарантирует возможность присваивания им только значений перечисления DayOfWeek. Например: </p>
<p class="paragraph">
DayOfWeek day = Sunday; </p>
<p class="paragraph">
Если нас мало волнует обеспечение защищенности типов, мы можем просто написать </p>
<p class="paragraph">
int day = Sunday; </p>
<p class="paragraph">
Обратите внимание на то, что при ссылке на константу Sunday из перечисления DayOfWeek мы пишем просто Sunday, а не DayOfWeek::Sunday. </p>
<p class="paragraph">
По умолчанию компилятор назначает последовательные целочисленные значения константам перечисления, начиная с нуля. При необходимости можно назначить другие значения: </p>
<p class="paragraph">
enum DayOfWeek { </p>
<p class="paragraph">
Sunday = 628, </p>
<p class="paragraph">
Monday = 616, </p>
<p class="paragraph">
Tuesday = 735, </p>
<p class="paragraph">
Wednesday = 932, </p>
<p class="paragraph">
Thursday = 852, </p>
<p class="paragraph">
Friday = 607, </p>
<p class="paragraph">
Saturday = 845 </p>
<p class="paragraph">
}; </p>
<p class="paragraph">
Если значение не задается для элемента перечисления, этот элемент примет значение предыдущего элемента, увеличенное на 1. Перечисления иногда используются для объявления целочисленных констант, и в этих случаях перечислению обычно имя не задают: </p>
<p class="paragraph">
enum { </p>
<p class="paragraph">
FirstPort = 1024, MaxPorts = 32767 </p>
<p class="paragraph">
}; </p>
<p class="paragraph">
Другой областью применения перечислений является представление набора опций. Рассмотрим пример диалогового окна Find (поиск) с четырьмя переключателями, которые управляют алгоритмом поиска (применение шаблона поиска, учет регистра, поиск в обратном направлении и повторение поиска с начала документа). Это можно представить в виде перечисления, значения констант которого равны некоторой степени 2: </p>
<p class="paragraph">
enum FindOption { </p>
<p class="paragraph">
NoOptions = 0x00000000, </p>
<p class="paragraph">
WildcardSyntax = 0x00000001, </p>
<p class="paragraph">
CaseSensitive = 0x00000002, </p>
<p class="paragraph">
SearchBackward = 0x00000004, </p>
<p class="paragraph">
WrapAround = 0x00000008 </p>
<p class="paragraph">
}; </p>
<p class="paragraph">
Каждая опция часто называется «флажком». Флажки можно объединять при помощи логических поразрядных операторов | или |=: </p>
<p class="paragraph">
int options = NoOptions; </p>
<p class="paragraph">
if (wilcardSyntaxCheckBox->isChecked()) </p>
<p class="paragraph">
options |= WildcardSyntax; </p>
<p class="paragraph">
if (caseSensitiveCheckBox->isChecked()) </p>
<p class="paragraph">
options |= CaseSensitive; </p>
<p class="paragraph">
if (searchBackwardCheckBox->isChecked()) </p>
<p class="paragraph">
options |= SearchBackwardSyntax; </p>
<p class="paragraph">
if (wrapAroundCheckBox->isChecked()) </p>
<p class="paragraph">
options |= WrapAround; </p>
<p class="paragraph">
Проверить значение флажка можно при помощи логического поразрядного оператора &: </p>
<p class="paragraph">
if (options & CaseSensitive) { </p>
<p class="paragraph">
// поиск с учетом регистра </p>
<p class="paragraph">
} </p>
<p class="paragraph">
Переменная типа FindOption может содержать только один флажок в данный момент времени. Результат объединения нескольких флажков при помощи оператора | представляет собой обычное целое число. К сожалению, здесь не обеспечивается защищенность типа: компилятор не будет «жаловаться», если функция, которая должна принимать в качестве параметра типа int некую комбинацию опций FindOption, фактически получит Saturday. Qt использует класс QFlags<T> для обеспечения защищенности своих собственных типов флажков. Этот класс можно также применять при определении пользовательских типов флажков. Подробное описание класса QFlags<T> можно найти в онлайновой документации. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Имена, вводимые typedef</p>
<p class="paragraph">
С++ позволяет с помощью ключевого слова typedef назначать псевдонимы типам данных. Например, если часто используется тип QVector<Point2D> и хотелось бы сэкономить немного на вводе символов (или, к несчастью, приходится иметь дело с норвежской клавиатурой и вам трудно найти на ней угловые скобки), то можно в одном из ваших заголовочных файлов использовать такое объявление typedef: </p>
<p class="paragraph">
typedef QVector<Point2D> PointVector; </p>
<p class="paragraph">
После этого можно использовать имя PointVector как сокращение для QVector<Point2D>. Следует отметить, что новое имя указывается после старого. Синтаксис typedef специально имитирует синтаксис объявлений переменных. </p>
<p class="paragraph">
В Qt имена, вводимые typedef, в основном используются по трем причинам: </p>
<p class="paragraph">
• Удобство: Qt объявляет с помощью typedef имена uint и QWidgetList для unsigned int и QList<QWidget *>, чтобы сэкономить несколько символов. </p>
<p class="paragraph">
• Различие платформ: определенные типы должны определяться по-разному на различных платформах. Например, qlonglong определяется как __int64 в Windows и как long long на других платформах. </p>
<p class="paragraph">
• Совместимость: класс QIconSet из Qt 3 был переименован в QIcon для Qt 4. Для облегчения пользователям Qt 3 перевода своих приложений в Qt 4 класс QIconSet объявляется как typedef QIcon, когда включается режим совместимости с Qt 3. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Преобразование типов</p>
<p class="paragraph">
С++ представляет несколько синтаксических конструкций по приведению одного типа к другому. Заключение нужного типа результата в скобки и размещение его перед преобразуемым значением — это традиционный способ, унаследованный от С: </p>
<p class="paragraph">
const double Pi = 3.14159265359; </p>
<p class="paragraph">
int x = (int) (Pi * 100); </p>
<p class="paragraph">
cout << x << " equals 314" << endl; </p>
<p class="paragraph">
Это очень мощная конструкция. Она может использоваться для изменения типа указателя, устранения константности и для многого другого. Например: </p>
<p class="paragraph">
short j = 0x1234; </p>
<p class="paragraph">
if (*(char *) &j == 0x12) </p>
<p class="paragraph">
cout << "The byte order is big-endian" << endl; </p>
<p class="paragraph">
В этом примере мы приводим тип short * к типу char * и используем унарный оператор * для обращения к байту по заданному адресу памяти. В системах с прямым порядком байтов этот байт содержит значение 0x12; в системах с обратным порядком байтов он имеет значение 0x34. Поскольку указатели и ссылки представляются одинаково, не удивительно, что представленный выше программный код можно переписать с приведением типа ссылки: </p>
<p class="paragraph">
short j = 0x1234; </p>
<p class="paragraph">
if ((char &) j == 0x12) </p>
<p class="paragraph">
cout << "The byte order is big-endian" << endl; </p>
<p class="paragraph">
Если тип данных является именем класса, именем, введенным typedef, или элементарным типом, который может быть представлен одной буквенно—цифровой лексемой, для приведения типа можно использовать синтаксис конструктора: </p>
<p class="paragraph">
int x = int(Pi * 100); </p>
<p class="paragraph">
Приведение типа указателей и ссылок с использованием традиционного подхода в стиле языка С является неким экстремальным видом спорта, напоминающим параглайдинг и передвижение на кабине лифта, потому что компилятор позволяет приводить указатель (или ссылку) любого типа в любой другой тип указателя (или ссылки). По этой причине в С++ введены новые конструкции приведения типов с более точной семантикой. Для указателей и ссылок новые конструкции приведения типов более предпочтительны по сравнению с рискованными конструкциями в стиле С, и они используются в данной книге. </p>
<p class="paragraph">
• static_cast<T>() может применяться для приведения типа указателя на А к типу указателя на В при том ограничении, что класс В должен быть наследником класса А. Например: </p>
<p class="paragraph">
A *obj = new В; </p>
<p class="paragraph">
В *b = static_cast<B *>(obj); </p>
<p class="paragraph">
b->someFunctionDeclaredInB(); </p>
<p class="paragraph">
Если объект не является экземпляром В (но все же наследует А), применение полученного указателя может привести к неожиданному краху программы. </p>
<p class="paragraph">
• dynamic_cast<T>() действует аналогично static_cast<T>(), кроме применения информации о типах, получаемой на этапе выполнения (runtime type information — RTTI), для проверки принадлежности к классу В объекта, на который ссылается указатель. Если это не так, то оператор приведения типа возвратит нулевой указатель. Например: </p>
<p class="paragraph">
A *obj = new В; </p>
<p class="paragraph">
В *b = dynamic_cast<B *>(obj); </p>
<p class="paragraph">
if (b) </p>
<p class="paragraph">
b->someFunctionDeclaredInB(); </p>
<p class="paragraph">
В некоторых компиляторах оператор dynamic_cast<T>() не работает через границы динамических библиотек. Он также рассчитывает на поддержку компилятором технологии RTTI, а эта поддержка может быть отключена программистом для уменьшения размера своих исполняемых модулей. Qt решает эти проблемы, обеспечивая оператор приведения qobject_cast<T>() для подклассов QObject. </p>
<p class="paragraph">
• const_cast<T>() добавляет или удаляет спецификатор const из указателя или ссылки. Например: </p>
<p class="paragraph">
int MyClass::someConstFunction() const </p>
<p class="paragraph">
{ </p>
<p class="paragraph">
if (isDirty()) { </p>
<p class="paragraph">
MyClass *that = const_cast<MyClass *>(this); </p>
<p class="paragraph">
that->recomputeInternalData(); </p>
<p class="paragraph">
} </p>
<p class="paragraph">
… </p>
<p class="paragraph">
} </p>
<p class="paragraph">
В предыдущем примере мы убрали спецификатор const при приведении типа указателя this для вызова неконстантной функции—члена recomputeInternalData(). Не рекомендуется так делать, и, если использовать ключевое слово mutable, этого можно избежать, как это делается в («Реализация функциональности приложения»). </p>
<p class="paragraph">
• reinterpret_cast<T>() преобразует любой тип указателя или ссылки в любой другой их тип. Например: </p>
<p class="paragraph">
short j = 0x1234; </p>
<p class="paragraph">
if (reinterpret_cast<char &>(j) == 0x12) </p>
<p class="paragraph">
cout << "The byte order is big-endian" << endl; </p>
<p class="paragraph">
В Java и C# любая ссылка может храниться при необходимости как ссылка на Object. С++ не имеет никакого универсального базового класса, но предоставляет специальный тип данных void *, который содержит адрес экземпляра любого типа. Указатель void * необходимо привести к другому типу (используя static_cast<T>()) перед его использованием. </p>
<p class="paragraph">
С++ обеспечивает много способов приведения типов, однако в большинстве случаев это даже не приходится делать. При использовании таких классов—контейнеров, как std::vector<T> или QVector<T>, мы можем задать тип T и извлекать элементы без приведения типа. Кроме того, для элементарных типов некоторые преобразования происходят неявно (например, преобразование char в int), а для пользовательских типов можно определить неявные преобразования, предусматривая конструктор с одним параметром. Например: </p>
<p class="paragraph">
class MyInteger </p>
<p class="paragraph">
{ </p>
<p class="paragraph">
public: </p>
<p class="paragraph">
MyInteger(); </p>
<p class="paragraph">
MyInteger(int i); </p>
<p class="paragraph">
… </p>
<p class="paragraph">
}; </p>
<p class="paragraph">
int main() </p>
<p class="paragraph">
{ </p>
<p class="paragraph">
MyInteger n; </p>
<p class="paragraph">
n = 5; </p>
<p class="paragraph">
… </p>
<p class="paragraph">
} </p>
<p class="paragraph">
Автоматическое преобразование, обеспечиваемое некоторыми конструкторами с одним параметром, имеет мало смысла. Его можно отключить, если объявить конструктор с ключевым словом explicit: </p>
<p class="paragraph">
class MyVector </p>
<p class="paragraph">
{ </p>
<p class="paragraph">
public: </p>
<p class="paragraph">
explicit MyVector(int size); </p>
<p class="paragraph">
… </p>
<p class="paragraph">
}; </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Перегрузка операторов</p>
<p class="paragraph">
С++ позволяет нам перегружать функции, т.е. мы можем объявлять несколько функций с одним именем в одной и той же области видимости, если они имеют различные списки параметров. Кроме того, С++ поддерживает перегрузку операторов, позволяя назначать специальную семантику встроенным операторам (таким, как +, << и [ ]) при их применении для пользовательских типов. </p>
<p class="paragraph">
Мы уже видели несколько примеров с перегруженными операторами. Когда использовался оператор << для вывода текста в поток cout или cerr, мы не пользовались оператором С++, выполняющим поразрядный сдвиг влево, но использовали специальную версию этого оператора, принимающего слева объект потока ostream (например, cout или cerr), а справа — строку (либо вместо строки число или манипулятор потока, например endl) и возвращающего объект ostream, что позволяет несколько раз вызывать оператор в одной строке. </p>
<p class="paragraph">
Красота перегрузки операторов заключается в возможности сделать поведение пользовательских типов в точности таким же, как поведение встроенных типов. Чтобы показать, как работает такая перегрузка, мы перегрузим операторы +=, —=, + и —, добавив возможность работы с объектами Point2D: </p>
<p class="paragraph">
01 #ifndef POINT2D_H </p>
<p class="paragraph">
02 #define POINT2D_H </p>
<p class="paragraph">
03 class Point2D </p>
<p class="paragraph">
04 { </p>
<p class="paragraph">
05 public: </p>
<p class="paragraph">
06 Point2D(); </p>
<p class="paragraph">
07 Point2D(double x, double у); </p>
<p class="paragraph">
08 void setX(double x); </p>
<p class="paragraph">
09 void setY(double у); </p>
<p class="paragraph">
10 double x() const; </p>
<p class="paragraph">
11 double y() const; </p>
<p class="paragraph">
12 Point2D &operator+=(const Point2D &other) </p>
<p class="paragraph">
13 { </p>
<p class="paragraph">
14 xVal += other.xVal; </p>
<p class="paragraph">
15 yVal += other.yVal; </p>
<p class="paragraph">
16 return *this; </p>
<p class="paragraph">
17 } </p>
<p class="paragraph">
18 Point2D &operator-=(const Point2D &other) </p>
<p class="paragraph">
19 { </p>
<p class="paragraph">
20 xVal -= other.xVal; </p>
<p class="paragraph">
21 yVal -= other.yVal; </p>
<p class="paragraph">
22 return *this; </p>
<p class="paragraph">
23 } </p>
<p class="paragraph">
24 private: </p>
<p class="paragraph">
25 double xVal; </p>
<p class="paragraph">
26 double yVal; </p>
<p class="paragraph">
27 }; </p>
<p class="paragraph">
28 inline Point2D operator+(const Point2D &a, const Point2D &b) </p>
<p class="paragraph">
29 { </p>
<p class="paragraph">
30 return Point2D(a.x() + b.x(), a.y() + b.y()); </p>
<p class="paragraph">
31 } </p>
<p class="paragraph">
32 inline Point2D operator-(const Point2D &a, const Point2D &b) </p>
<p class="paragraph">
33 { </p>
<p class="paragraph">
34 return Point2D(a.x() - b.x(), a.y() - b.y()); </p>
<p class="paragraph">
35 } </p>
<p class="paragraph">
36 #endif </p>
<p class="paragraph">
Операторы можно реализовать либо как функции—члены, либо как глобальные функции. В нашем примере мы реализовали операторы += и —= как функции—члены, а операторы + и — как глобальные функции. </p>
<p class="paragraph">
Операторы += и —= принимают ссылку на другой объект Point2D и увеличивают или уменьшают координаты x и у текущего объекта на значение координат другого объекта. Они возвращают *this, т.е. ссылку на текущий объект (this имеет тип Point2D *). Возвращение ссылки позволяет создавать экзотический программный код, например: </p>
<p class="paragraph">
a += b += с; </p>
<p class="paragraph">
Операторы + и — принимают два параметра и возвращают значение объекта Point2D (а не ссылку на существующий объект). Ключевое слово inline позволяет поместить эти функции в заголовочный файл. Если бы тело функции было более длинным, мы бы поместили в заголовочный файл прототип функции, а определение функции (без ключевого слова inline) в файл .cpp. </p>
<p class="paragraph">
Следующие фрагменты программного кода показывают, как можно использовать все четыре перегруженных оператора: </p>
<p class="paragraph">
Point2D beta(77.5, 50.0); </p>
<p class="paragraph">
Point2D alpha(12.5, 40.0); </p>
<p class="paragraph">
alpha += beta; </p>
<p class="paragraph">
beta -= alpha; </p>
<p class="paragraph">
Point2D gamma = alpha + beta; </p>
<p class="paragraph">
Point2D delta = beta - alpha; </p>
<p class="paragraph">
Кроме того, можно вызывать функции operator точно так же, как вызываются любые другие функции: </p>
<p class="paragraph">
Point2D beta(77.5, 50.0); </p>
<p class="paragraph">
Point2D alpha(12.5, 40.0); </p>
<p class="paragraph">
alpha.operator+=(beta); </p>
<p class="paragraph">
beta.operator-=(alpha); </p>
<p class="paragraph">
Point2D gamma = operator+(alpha, beta); </p>
<p class="paragraph">
Point2D delta = operator-(beta, alpha); </p>
<p class="paragraph">
Перегрузка операторов в С++ представляет собой сложную тему, однако мы вполне можем пока обходиться без знания всех деталей. Все же важно понимать принципы перегрузки операторов, потому что несколько классов Qt (в том числе QString и QVector<T>) используют их для обеспечения простого и более естественного синтаксиса для таких операций, как конкатенация и добавление в конец объекта. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Типы значений</p>
<p class="paragraph">
B Java и C# различаются типы значений и типы ссылок. </p>
<p class="paragraph">
• Типы значений. Это такие элементарные типы, как char, int и float, а также структуры struct в C#. Характерным для них является то, что для их создания не используется оператор new и оператор присваивания копирует значение переменной. Например: </p>
<p class="paragraph">
int i = 5; </p>
<p class="paragraph">
int j = 10; </p>
<p class="paragraph">
i = j; </p>
<p class="paragraph">
• Типы ссылок. Это такие классы, как Integer (в Java), String и MyVeryOwnClass. Их экземпляры создаются при помощи оператора new. Оператор присваивания копирует только ссылку на объект, а для действительного копирования объекта мы должны вызывать функцию clone() (в Java) или Clone() (в C#). Например: </p>
<p class="paragraph">
Integer i = new Integer(5); </p>
<p class="paragraph">
Integer j = new Integer(10); </p>
<p class="paragraph">
i = j.clone(); </p>
<p class="paragraph">
В С++ все типы могут использоваться как «типы ссылок», а в дополнение к этому те из них, которые допускают копирование, могут использоваться как «типы значений». Например, в С++ нет необходимости иметь класс, подобный Integer, потому что можно использовать указатели и оператор new: </p>
<p class="paragraph">
int *i = new int(5); </p>
<p class="paragraph">
int *j = new int(10); </p>
<p class="paragraph">
*i = *j; </p>
<p class="paragraph">
В отличие от Java и C#, в С++ определяемые пользователем типы используются так же, как встроенные типы: </p>
<p class="paragraph">
Point2D *i = new Point2D(5, 5); </p>
<p class="paragraph">
Point2D *j = new Point2D(10, 10); </p>
<p class="paragraph">
*i = *j; </p>
<p class="paragraph">
Если требуется сделать класс С++ копируемым, необходимо предусмотреть в этом классе конструктор копирования и оператор присваивания. Конструктор копирования вызывается при инициализации объекта другим объектом того же типа. Синтаксически в С++ это обеспечивается двумя способами: </p>
<p class="paragraph">
Point2D i(20, 20); </p>
<p class="paragraph">
Point2D j(i); // первый способ </p>
<p class="paragraph">
Point2D k = i; // второй способ </p>
<p class="paragraph">
Оператор присваивания вызывается при присваивании одной переменной другой переменной: </p>
<p class="paragraph">
Point2D i(5, 5); </p>
<p class="paragraph">
Point2D j(10, 10); </p>
<p class="paragraph">
j = i; </p>
<p class="paragraph">
При определении класса компилятор С++ автоматически обеспечивает конструктор копирования и оператор присваивания, выполняющие копирование члена в член. Для класса Point2D это равносильно тому, как если бы мы написали следующий программный код в определении класса: </p>
<p class="paragraph">
01 class Point2D </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 public: </p>
<p class="paragraph">
04 Point2D(const Point2D &other) </p>
<p class="paragraph">
05 : xVal(other.xVal), yVal(other.yVal) { } </p>
<p class="paragraph">
06 Point2D &operator=(const Point2D &other) </p>
<p class="paragraph">
07 { </p>
<p class="paragraph">
08 xVal = other.xVal; </p>
<p class="paragraph">
09 yVal = other.yVal; </p>
<p class="paragraph">
10 return *this; </p>
<p class="paragraph">
11 } </p>
<p class="paragraph">
12 … </p>
<p class="paragraph">
13 private: </p>
<p class="paragraph">
14 double xVal; </p>
<p class="paragraph">
15 double yVal; </p>
<p class="paragraph">
16 }; </p>
<p class="paragraph">
Для некоторых классов создаваемые по умолчанию конструктор копирования и оператор присваивания оказываются неподходящими. Обычно это происходит в тех случаях, когда класс использует динамическую память. Чтобы сделать класс копируемым, мы должны сами реализовать конструктор копирования и оператор присваивания. </p>
<p class="paragraph">
Для классов, которые не должны быть копируемыми, можно отключить конструктор копирования и оператор присваивания, если сделать их закрытыми. Если мы случайно попытаемся копировать экземпляры такого класса, компилятор выдаст сообщение об ошибке. Например: </p>
<p class="paragraph">
class BankAccount </p>
<p class="paragraph">
{ </p>
<p class="paragraph">
public: </p>
<p class="paragraph">
… </p>
<p class="paragraph">
private: </p>
<p class="paragraph">
BankAccount(const BankAccount &other); </p>
<p class="paragraph">
BankAccount &operator=(const BankAccount &other); </p>
<p class="paragraph">
}; </p>
<p class="paragraph">
В Qt многие классы проектировались как используемые по значению. Они имеют конструктор копирования и оператор присваивания и обычно инстанцируются в стеке без использования оператора new. Это относится к классам QDateTime, QImage, QString и к классам—контейнерам, например QList<T>, QVector<T> и QMap<K, T>. </p>
<p class="paragraph">
Другие классы попадают в категорию «типа ссылок», в частности QObject и его подклассы (QWidget, QTimer, QTcpSocket и т.д.). Они имеют виртуальные функции и не могут копироваться. Например, QWidget представляет конкретное окно или элемент управления на экране дисплея. Если в памяти находится 75 экземпляров QWidget, на экране также будет находиться 75 окон или элементов управления. Обычно эти классы инстанцируются при помощи оператора new. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Глобальные переменные и функции</p>
<p class="paragraph">
С++ позволяет объявлять функции и переменные, которые не принадлежат никакому классу и к которым можно обращаться из любой другой функции. Мы видели несколько примеров глобальных функций, в частности main() — точка входа в программу. Глобальные переменные встречаются реже, потому что они плохо влияют на модульность и реентерабельность. Все же важно иметь представление о них, поскольку вам, возможно, придется с ними столкнуться в программном коде, написанном программистом, который раньше писал на С, и другими пользователями С++. </p>
<p class="paragraph">
Для иллюстрации работы глобальных функций и переменных рассмотрим небольшую программу, которая печатает список из 128 псевдослучайных чисел, используя придуманный на скорую руку алгоритм. Исходный код программы находится в двух файлах .cpp. </p>
<p class="paragraph">
Первый исходный файл — random.cpp: </p>
<p class="paragraph">
01 int randomNumbers[128]; </p>
<p class="paragraph">
02 static int seed = 42; </p>
<p class="paragraph">
03 static int nextRandomNumber() </p>
<p class="paragraph">
04 { </p>
<p class="paragraph">
05 seed = 1009 + (seed * 2011); </p>
<p class="paragraph">
06 return seed; </p>
<p class="paragraph">
07 } </p>
<p class="paragraph">
08 void populateRandomArray() </p>
<p class="paragraph">
09 { </p>
<p class="paragraph">
10 for (int i = 0; i < 128; ++i) </p>
<p class="paragraph">
11 randomNumbers[i] = nextRandomNumber(); </p>
<p class="paragraph">
12 } </p>
<p class="paragraph">
В этом файле объявляются две глобальные переменные (randomNumbers и seed) и две глобальные функции (nextRandomNumber() и populateRandomArray()). В двух объявлениях используется ключевое слово static; эти объявления видимы только внутри текущей единицы компиляции (random.cpp), и говорят, что они статически связаны (static linkage). Два других объявления доступны из любой единицы компиляции программы, они обеспечивают внешнюю связь (external linkage). </p>
<p class="paragraph">
Статическая компоновка идеально подходит для вспомогательных функций и внутренних переменных, которые не должны использоваться в других единицах компиляции. Она снижает риск «столкновения» идентификаторов (наличия глобальных переменных с одинаковым именем или глобальных функций с одинаковой сигнатурой в разных единицах компиляции) и не позволяет злонамеренным или другим опрометчивым пользователям получать доступ к внутренним объектам единицы компиляции. </p>
<p class="paragraph">
Теперь рассмотрим второй файл main.cpp, в котором используется две глобальные переменные, объявленные в random.cpp с обеспечением внешней связи: </p>
<p class="paragraph">
01 #include <iostream> </p>
<p class="paragraph">
02 using namespace std; </p>
<p class="paragraph">
03 extern int randomNumbers[128]; </p>
<p class="paragraph">
04 void populateRandomArray(); </p>
<p class="paragraph">
05 int main() </p>
<p class="paragraph">
06 { </p>
<p class="paragraph">
07 populateRandomArray(); </p>
<p class="paragraph">
08 for (int i = 0; i < 128; ++i) </p>
<p class="paragraph">
09 cout << randomNumbers[i] << endl; </p>
<p class="paragraph">
10 return 0; </p>
<p class="paragraph">
11 } </p>
<p class="paragraph">
Мы объявляем внешние переменные и функции до их вызова. Объявление randomNumbers внешней переменной (что делает ее видимой в текущей единице компиляции) начинается с ключевого слова extern. Если бы не было этого ключевого слова, компилятор «посчитал» бы, что он имеет дело с определением переменной, и компоновщик «пожаловался» бы на определение одной и той же переменной в двух единицах компиляции (random.cpp и main.cpp). Переменные могут объявляться любое количество раз, однако они могут иметь только одно определение. Именно благодаря определению компилятор резервирует пространство для переменной. </p>
<p class="paragraph">
Функция populateRandomArray() объявляется с использованием прототипа. Указывать ключевое слово extern для функций необязательно. </p>
<p class="paragraph">
Обычно объявления внешних переменных и функций помещают в заголовочный файл и включают его во все файлы, где они требуются: </p>
<p class="paragraph">
01 #ifndef RANDOM_H </p>
<p class="paragraph">
02 #define RANDOM_H </p>
<p class="paragraph">
03 extern int randomNumbers[128]; </p>
<p class="paragraph">
04 void populateRandomArray(); </p>
<p class="paragraph">
05 #endif </p>
<p class="paragraph">
Мы уже видели, как ключевое слово static может использоваться для объявления переменных—членов и функций—членов, которые не привязываются к конкретному экземпляру класса, и теперь мы увидели, как можно его использовать для объявления функций и переменных со статической связью. Существует еще одно применение ключевого слова static, о котором следует упомянуть. В С++ можно определить локальную переменную как статическую. Такие переменные инициализируются при первом вызове функции и сохраняют свои значения между вызовами функций. Например: </p>
<p class="paragraph">
01 void nextPrime() </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 static int n = 1; </p>
<p class="paragraph">
04 do { </p>
<p class="paragraph">
05 ++n; </p>
<p class="paragraph">
06 } while (!isPrime(n)); </p>
<p class="paragraph">
07 return n; </p>
<p class="paragraph">
08 } </p>
<p class="paragraph">
Статические локальные переменные подобны глобальным переменным, за исключением того, что они видимы только внутри функции, в которой они определены. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Пространства имен</p>
<p class="paragraph">
Пространства имен позволяют снизить риск конфликта имен в программах С++. Конфликты имен часто возникают в больших программах, использующих несколько библиотек независимых разработчиков. В своей собственной программе вы решаете сами, использовать ли вам или нет пространства имен. </p>
<p class="paragraph">
Обычно в пространство имен заключаются все объявления заголовочного файла, чтобы гарантировать невозможность попадания идентификаторов, объявленных в этом заголовочном файле, в глобальное пространство имен. Например: </p>
<p class="paragraph">
01 #ifndef SOFTWAREINC_RANDOM_H </p>
<p class="paragraph">
02 #define SOFTWAREINC_RANDOM_H </p>
<p class="paragraph">
03 namespace SoftwareInc </p>
<p class="paragraph">
04 { </p>
<p class="paragraph">
05 extern int randomNumbers[128]; </p>
<p class="paragraph">
06 void populateRandomArray(); </p>
<p class="paragraph">
07 } </p>
<p class="paragraph">
08 #endif </p>
<p class="paragraph">
(Обратите внимание на то, что мы переименовали препроцессорные макросимволы, используемые для предотвращения многократного включения содержимого заголовочного файла, снижая риск конфликта имен с заголовочным файлом, имеющим такое же имя, но расположенным в другом каталоге.) </p>
<p class="paragraph">
Синтаксис пространства имен совпадает с синтаксисом класса, однако в конце не ставится точка с запятой. Ниже приводится новая версия файла random.cpp: </p>
<p class="paragraph">
01 #include "random.h" </p>
<p class="paragraph">
02 int SoftwareInc::randomNumbers[128]; </p>
<p class="paragraph">
03 static int seed = 42; </p>
<p class="paragraph">
04 static int nextRandomNumber() </p>
<p class="paragraph">
05 { </p>
<p class="paragraph">
06 seed = 1009 + (seed * 2011); </p>
<p class="paragraph">
07 return seed; </p>
<p class="paragraph">
08 } </p>
<p class="paragraph">
09 void SoftwareInc::populateRandomArray() </p>
<p class="paragraph">
10 { </p>
<p class="paragraph">
11 for (int i = 0; i < 128; ++i) </p>
<p class="paragraph">
12 randomNumbers[i] = nextRandomNumber(); </p>
<p class="paragraph">
13 } </p>
<p class="paragraph">
В отличие от классов, пространства имен можно «повторно открывать» в любое время. Например: </p>
<p class="paragraph">
01 namespace Alpha </p>
<p class="paragraph">
02 { </p>
<p class="paragraph">
03 void alpha1(); </p>
<p class="paragraph">
04 void alpha2(); </p>
<p class="paragraph">
05 } </p>
<p class="paragraph">
06 namespace Beta </p>
<p class="paragraph">
07 { </p>
<p class="paragraph">
08 void beta1(); </p>
<p class="paragraph">
09 } </p>
<p class="paragraph">
10 namespace Alpha </p>
<p class="paragraph">
11 { </p>
<p class="paragraph">
12 void alpha3(); </p>
<p class="paragraph">
13 } </p>
<p class="paragraph">
Это позволяет определять сотни классов, размещенных во многих заголовочных файлах и принадлежащих одному пространству имен. Используя этот прием, стандартная библиотека С++ помещает все свои идентификаторы в пространство имен std. В Qt пространства имен используются для таких подобных глобальным идентификаторов, как Qt::AlignBottom и Qt::yellow. По историческим причинам классы Qt не принадлежат никакому пространству имен, но имеют префикс 'Q'. </p>
<p class="paragraph">
Для ссылки на идентификатор, объявленный в другом пространстве имен, указывается префикс в виде имени этого пространства имен (и ::). Можно поступить по-другому — использовать один из следующих трех механизмов, нацеленных на уменьшение количества вводимых символов: </p>
<p class="paragraph">
• Можно определить псевдоним пространства имен: </p>
<p class="paragraph">
namespace ElPuebloDeLaReinaDeLosAngeles </p>
<p class="paragraph">
{ </p>
<p class="paragraph">
void beverlyHills(); </p>
<p class="paragraph">
void culverCity(); </p>
<p class="paragraph">
void malibu(); </p>
<p class="paragraph">
void santaMonica(); </p>
<p class="paragraph">
} </p>
<p class="paragraph">
namespace LA = ElPuebloDeLaReinaDeLosAngeles; </p>
<p class="paragraph">
После определения псевдонима он может использоваться вместо исходного имени. </p>
<p class="paragraph">
• Из пространства имен можно импортировать один идентификатор: </p>
<p class="paragraph">
int main() </p>
<p class="paragraph">
{ </p>
<p class="paragraph">
using ElPuebloDeLaReinaDeLosAngeles::beverlyHills; </p>
<p class="paragraph">
beverlyHills(); </p>
<p class="paragraph">
} </p>
<p class="paragraph">
Объявление using позволяет обращаться к данному идентификатору без указания префикса, состоящего из имени пространства имен. </p>
<p class="paragraph">
• Можно импортировать все пространство имен с помощью одной директивы: </p>
<p class="paragraph">
int main() </p>
<p class="paragraph">
{ </p>
<p class="paragraph">
using namespace ElPuebloDeLaReinaDeLosAngeles; </p>
<p class="paragraph">
santaMonica(); </p>
<p class="paragraph">
malibu(); </p>
<p class="paragraph">
} </p>
<p class="paragraph">
При таком подходе конфликты имен становятся более вероятными. Если компилятор «жалуется» на двусмысленное имя (например, когда два класса имеют одинаковое имя, определенное в различных пространствах имен), всегда при ссылке на идентификатор его можно уточнить именем пространства имен. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Препроцессор</p>
<p class="paragraph">
Препроцессор С++ — это программа, которая обрабатывает исходный файл .cpp, содержащий директивы # (такие, как #include, #ifndef и #endif), и преобразует его файл исходного кода, который не содержит таких директив. Эти директивы предназначены для выполнения простых операций с текстом исходного файла, например для выполнения условной компиляции, включения файла и разворачивания макроса. Обычно препроцессор автоматически вызывается компилятором, однако в большинстве систем предусмотрена возможность непосредственного его вызова (часто для этого используется опция компилятора —E и /E). </p>
<p class="paragraph">
• Директива #include разворачивается в содержимое файла, имя которого указывается в угловых скобках (< >) или в двойных кавычках (" "), в зависимости от расположения заголовочного файла в стандартном каталоге или в каталоге текущего проекта. Имя файла может содержать .. и / (этот символ правильно интерпретируется компиляторами Windows как разделитель каталогов). Например: </p>
<p class="paragraph">
#include "../shared/globaldefs.h" </p>
<p class="paragraph">
• С помощью директивы #define определяется макрос. Каждое появление в тексте программы имени, расположенном после директивы #define, заменяется определенным для него значением. Например, директива </p>
<p class="paragraph">
#define PI 3.14159265359 </p>
<p class="paragraph">
указывает препроцессору на необходимость замены каждого появления в текущей единице компиляции лексемы PI лексемой 3.14159265359. Для предотвращения конфликтов имен с переменными и классами общей практикой стало назначение макросам имен, состоящих только из прописных букв. Можно определять макрос с аргументами: </p>
<p class="paragraph">
#define SQUARE(x) ((x) * (x)) </p>
<p class="paragraph">
Считается хорошим стилем окружение в теле макроса скобками любых параметров, а также всего тела макроса, что позволяет избегать проблем, связанных с приоритетностью операторов. В конце концов нам нужно, чтобы запись 7 * SQUARE(2 + 3) разворачивалась в 7 * ((2 + 3) * (2 + З)), а не в 7 * 2 + 3 * 2 + 3. </p>
<p class="paragraph">
Компиляторы С++ обычно позволяют определять макросы в командной строке, используя опцию —D или /D. Например: </p>
<p class="paragraph">
CC -DPI=3.14159265359 -с main.cpp </p>
<p class="paragraph">
Макросы были очень популярны в прежние дни, когда еще не были введены typedef, перечисления, константы, встраиваемые функции и шаблоны. В наши дни они играют важную роль в предотвращении многократных включений заголовочных файлов. </p>
<p class="paragraph">
• Макрос можно отменить в любом месте с помощью директивы #undef: </p>
<p class="paragraph">
#undef PI </p>
<p class="paragraph">
Эту возможность необходимо использовать, если требуется переопределить макрос, поскольку препроцессор не позволяет определять один и тот же макрос дважды. Эту директиву полезно также применять для управления условной компиляцией. </p>
<p class="paragraph">
• Отдельные фрагменты программного кода можно обрабатывать или пропускать при помощи директив #if, #elif, #else и #endif в зависимости от конкретных числовых значений макросов. Например: </p>
<p class="paragraph">
#define NO_OPTIM 0 </p>
<p class="paragraph">
#define OPTIM_FOR_SPEED 1 </p>
<p class="paragraph">
#define OPTIM_FOR_MEMORY 2 </p>
<p class="paragraph">
#define OPTIMIZATION OPTIM_FOR_MEMORY </p>
<p class="paragraph">
… </p>
<p class="paragraph">
#if OPTIMIZATION == OPTIM_FOR_SPEED </p>
<p class="paragraph">
typedef int MyInt; </p>
<p class="paragraph">
#elif OPTIMIZATION == OPTIM_FOR_MEMORY </p>
<p class="paragraph">
typedef short MyInt; </p>
<p class="paragraph">
#else </p>
<p class="paragraph">
typedef long long MyInt; </p>
<p class="paragraph">
#endif </p>
<p class="paragraph">
В приведенном выше примере компилятором будет обрабатываться только второе объявление, которое вводит синоним для short. Изменяя определение макроса OPTIMIZATION, мы получим другие программы. Если макрос не определен, он будет иметь значение 0. </p>
<p class="paragraph">
Другим оператором условной компиляции является проверка макроса на предмет его определения. Это можно сделать следующим образом, используя оператор defined(): </p>
<p class="paragraph">
#define OPTIM_FOR_MEMORY </p>
<p class="paragraph">
… </p>
<p class="paragraph">
#if defined(OPTIM_FOR_SPEED) </p>
<p class="paragraph">
typedef int MyInt; </p>
<p class="paragraph">
#elif defined(OPTIM_FOR_MEMORY) </p>
<p class="paragraph">
typedef short MyInt; </p>
<p class="paragraph">
#else </p>
<p class="paragraph">
typedef long long MyInt; </p>
<p class="paragraph">
#endif </p>
<p class="paragraph">
• Ради удобства препроцессор воспринимает #ifdef X и #ifndef X как синонимы #if defined(X) и #if !defined(X). Для пpeдoтвpaщeния мнoгoкpaтныx включeний заголовочного файла мы окружаем его содержимое следующими директивами: </p>
<p class="paragraph">
#ifndef MYHEADERFILE_H </p>
<p class="paragraph">
#define MYHEADERFILE_H </p>
<p class="paragraph">
… </p>
<p class="paragraph">
#endif </p>
<p class="paragraph">
При первом включении заголовочного файла символ MYHEADERFILE_H оказывается неопределенным, поэтому компилятор обрабатывает программный код, заключенный между директивами #ifndef и #endif. При повторном и последующих включениях заголовочного файла символ MYHEADERFILE_H оказывается определенным, поэтому весь блок #ifndef … #endif пропускается. </p>
<p class="paragraph">
• Директива #errоr генерирует на этапе компиляции определенное пользователем сообщение об ошибке. Эта директива часто используется в комбинации с директивами условной компиляции для вывода сообщения о возникновении недопустимого условия. Например: </p>
<p class="paragraph">
class UniChar </p>
<p class="paragraph">
{ </p>
<p class="paragraph">
public: </p>
<p class="paragraph">
#if BYTE_ORDER == BIG_ENDIAN </p>
<p class="paragraph">
uchar row; </p>
<p class="paragraph">
uchar cell; </p>
<p class="paragraph">
#elif BYTE_ORDER == LITTLE_ENDIAN </p>
<p class="paragraph">
uchar cell; </p>
<p class="paragraph">
uchar row; </p>
<p class="paragraph">
#else </p>
<p class="paragraph">
#error "BYTE_ORDER must be BIG_ENDIAN or LITTLE_ENDIAN" </p>
<p class="paragraph">
#endif </p>
<p class="paragraph">
}; </p>
<p class="paragraph">
В отличие от большинства других конструкций С++, в которых недопустимы пробельные символы, препроцессорные директивы должны быть единственными в строке и не должны содержать точку с запятой. Слишком длинные директивы можно разбивать на несколько строк, заканчивая каждую строку, кроме последней, обратной наклонной чертой. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
<article class="note-block entry post">
<div class="note">
<div class="note-inner">
<div class="note-content">
<div class="post-content clearfix">
<p> </p>
<p class="chap">Стандартная библиотека С++</p>
<p class="paragraph">
В данном разделе мы кратко рассмотрим стандартную библиотеку С++. На рис. Б.З приводится список базовых заголовочных файлов С++: </p>
<p class="paragraph">
• <bitset> — шаблонный класс для представления последовательностей битов фиксированной длины, </p>
<p class="paragraph">
• <complex> — шаблонный класс для представления комплексных чисел, </p>
<p class="paragraph">
• <exception> — типы и функции, относящиеся к обработке исключений, </p>
<p class="paragraph">
• <limits> — шаблонный класс, определяющий свойства числовых типов, </p>
<p class="paragraph">
• <locale> — классы и функции, относящиеся к локализации, </p>
<p class="paragraph">
• <new> — функции, управляющие динамическим распределением памяти, </p>
<p class="paragraph">
• <stdexcept> — заранее определенные типы исключений для вывода сообщений об ошибках, </p>
<p class="paragraph">
• <string> — шаблонный строковый контейнер и свойства символов, </p>
<p class="paragraph">
• <typeinfo> — класс, предоставляющий основную метаинформацию о типах, </p>
<p class="paragraph">
• <valarray> — шаблонные классы для представления массивов значений. </p>
<p class="paragraph">
Заголовочные файлы <exception>, <limits>, <new> и <typeinfo> поддерживают возможности языка С++; например, <limits> позволяет проверять возможности поддержки компилятором целочисленной арифметики и арифметики чисел с плавающей точкой, a <typeinfo> предлагает основные средства анализа информации о типах. Другие заголовочные файлы предоставляют часто используемые классы, в том числе класс строки и тип комплексных чисел. Функциональность, предлагаемая заголовочными файлами <bitset>, <locale>, <string> и <typeinfo>, свободно перекрывается в Qt классами QBitArray, QLocale, QString и QMetaObject. </p>
<p class="paragraph">
Стандартный С++ также включает ряд заголовочных файлов, обеспечивающих ввод—вывод (см. рис. Б.4): </p>
<p class="paragraph">
• <fstream> — шаблонные классы, манипулирующие внешними файлами, </p>
<p class="paragraph">
• <iomanip> — манипуляторы потоков ввода—вывода, принимающие один аргумент, </p>
<p class="paragraph">
• <ios> — шаблонный базовый класс потоков ввода—вывода, </p>
<p class="paragraph">
• <iosfwd> — предварительные объявления нескольких шаблонных классов потоков ввода—вывода, </p>
<p class="paragraph">
• <iostream> — стандартные потоки ввода—вывода (cin, cout, cerr, ctog), </p>
<p class="paragraph">
• <istream> — шаблонный класс, управляющий вводом из буфера потока, </p>
<p class="paragraph">
• <ostream> — шаблонный класс, управляющий выводом в буфер потока, </p>
<p class="paragraph">
• <sstream> — шаблонные классы, связывающие буферы потоков со строками, </p>
<p class="paragraph">
• <streambuf> — шаблонные классы, обеспечивающие буфер для операций ввода—вывода, </p>
<p class="paragraph">
• <strstream> — классы для выполнения операций потокового ввода-вывода с массивами символов. </p>
<p class="paragraph">
Классы стандартного ввода—вывода проектировались в 80-х годах и обладают излишней сложностью, что сильно затрудняет их понимание, причем настолько, что этой теме были посвящены целые книги. Кроме того, программист остается наедине с ящиком Пандоры неразрешенных проблем, связанных с кодировкой символов и зависимого от платформы двоичного представления элементарных типов данных. </p>
<p class="paragraph">
В («Ввод—вывод») представлены соответствующие классы Qt, обеспечивающие ввод—вывод символов в кодировке Unicode, а также большой набор национальных кодировок и абстракцию независимого от платформы хранения двоичных данных. Qt—классы ввода—вывода формируют основу поддержки межпроцессной связи, работы с сетями и XML. Qt—классы двоичных и текстовых потоков можно очень легко расширить для работы с пользовательскими типами данных. </p>
<p class="paragraph">
В начале 90-х годов была введена стандартная библиотека шаблонов (Standard Template Library — STL), представляющая собой набор шаблонных классов-контейнеров, итераторов и алгоритмов, которые вошли в стандарт ISO С++ в последний момент. На рис. Б.5 приводится список заголовочных файлов библиотеки STL: </p>
<p class="paragraph">
• <algorithm> — шаблонные функции общего назначения, </p>
<p class="paragraph">
• <deque> — шаблонный контейнер очереди с двумя концами, </p>
<p class="paragraph">
• <functional> — шаблоны, помогающие конструировать и манипулировать функторами, </p>
<p class="paragraph">
• <iterator> — шаблоны, помогающие конструировать и манипулировать итераторами, </p>
<p class="paragraph">
• <list> — шаблонный контейнер двусвязного списка, </p>
<p class="paragraph">
• <map> — шаблонные контейнеры ассоциативных массивов, связывающие ключ с одним и с несколькими значениями, </p>
<p class="paragraph">
• <memory> — утилиты, позволяющие упростить управление памятью, </p>
<p class="paragraph">
• <numeric> — шаблонные операции с числами, </p>
<p class="paragraph">
• <queue> — шаблонный контейнер очереди, </p>
<p class="paragraph">
• <set> — шаблонные контейнеры наборов, допускающие и недопускающие повторения элементов, </p>
<p class="paragraph">
• <stack> — шаблонный контейнер стека, </p>
<p class="paragraph">
• <utility> — основные шаблонные функции, </p>
<p class="paragraph">
• <vector> — шаблонный контейнер вектора. </p>
<p class="paragraph">
Проект STL выполнен очень аккуратно, почти с математической точностью, и обеспечивает обобщенную типобезопасную функциональность. Qt предоставляет свои собственные классы—контейнеры, разработка которых отчасти инспирирована STL. Они описываются в . </p>
<p class="paragraph">
Поскольку С++ фактически является супермножеством относительно языка программирования С, программисты С++ имеют в своем распоряжении также полную библиотеку С. Заголовочные файлы библиотеки С доступны как с их традиционными именами (например, <stdio.h>), так и с новыми именами с с—префиксом и без расширения .h (например, <cstdio>). Когда используется новая версия имен заголовочных файлов, функции и типы данных объявляются в пространстве имен std. (Это не относится к таким макросам, как ASSERT(), потому что препроцессор никак не реагирует на пространства имен.) Рекомендуется использовать новый стиль обозначения имен, если его поддерживает ваш компилятор. </p>
<p class="paragraph">
На рис. Б.6 приводится список заголовочных файлов библиотеки С: </p>
<p class="paragraph">
• <cassert> — макрос ASSERT(), </p>
<p class="paragraph">
• <cctype> — функции классификации и отображения символов, </p>
<p class="paragraph">
• <cerrno> — макросы, относящиеся к сообщениям об ошибочных ситуациях, </p>
<p class="paragraph">
• <cfloat> — макросы, определяющие свойства элементарных типов чисел с плавающей точкой, </p>
<p class="paragraph">
• <ciso646> — альтернативное представление для пользователей набора символов ISO 646, </p>
<p class="paragraph">
• <climits> — макросы, определяющие свойства элементарных целочисленных типов, </p>
<p class="paragraph">
• <clocale> — функции и типы, относящиеся к локализации, </p>
<p class="paragraph">
• <cmath> — математические функции и константы, </p>
<p class="paragraph">
• <csetjmp> — функции для выполнения нелокальных переходов, </p>
<p class="paragraph">
• <csignal> — функции для обработки системных сигналов, </p>
<p class="paragraph">
• <cstdarg> — макросы для реализации функций с переменным числом аргументов, </p>
<p class="paragraph">
• <cstddef> — определения, общие для некоторых стандартных заголовочных файлов, </p>
<p class="paragraph">
• <cstdio> — функции ввода—вывода, </p>
<p class="paragraph">
• <cstdlib> — общие вспомогательные функции, </p>
<p class="paragraph">
• <cstring> — функции для манипулирования массивами char, </p>
<p class="paragraph">
• <ctime> — типы и функции для манипулирования временем, </p>
<p class="paragraph">
• <cwchar> — утилиты для работы с многобайтовыми символами и символами расширенной кодировки, </p>
<p class="paragraph">
• <cwctype> — функции классификации и отображения символов расширенной кодировки. </p>
<p class="paragraph">
Большинство из них предлагает функциональность, которая перекрывается более новыми заголовочными файлами С++ или Qt. Стоит отметить одно из исключений — <cmath>, в котором объявляются такие математические функции, как sin(), sqrt() и pow(). </p>
<p class="paragraph">
Этим завершается наш краткий обзор стандартной библиотеки С++. В сети Интернет можно получить предлагаемое компанией «Dinkumware» полное справочное руководство по стандартной библиотеке С++, размещенное на веб-странице , и предлагаемое компанией «SGI» подробное руководство программиста по STL, размещенное на веб-странице . Официальное описание стандартной библиотеки С++ можно найти в стандартах С и С++ в виде файлов PDF или получить в бумажном виде в Международной организации по стандартизации (International Organization for Standardization — ISO). </p>
<p class="paragraph">
В данном приложении мы бегло рассмотрели многие темы. Когда вы станете изучать средства разработки Qt, начиная с , вы обнаружите, что используемый ими синтаксис значительно проще и аккуратнее, чем можно было бы предположить после прочтения данного приложения. Хорошее Qt—программирование требует применения только подмножества языка С++ и обычно не требует использования более сложного и не очень понятного синтаксиса, возможного в С++. После того как вы станете вводить программный код, собирать исполняемые модули и запускать их, четкость и простота принятого в Qt подхода станет очевидной. И когда вы начнете писать более амбициозные программы, особенно те, в которых требуется обеспечить быструю и сложную графику, возможности комбинации С++ и Qt всегда будут идти в ногу с вашими потребностями. </p>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
</div>
</div>
<!-- end .note-content-->
</div>
<!-- end .note-inner-->
</div>
<!-- end .note-->
<div class="note-bottom-left">
<div class="note-bottom-right">
<div class="note-bottom-center"></div>
</div>
</div>
</article>
</div>
<h4>Ссылки</h4>
<p>[0] От составителя: поскольку библиотека Qt в 2008м была куплена Nokia, адреса теперь не "www.trolltech.com", а "qt.nokia.com". Всё остальное — такое же :). </p>
<p>[1] Если вы получаете ошибку при компиляции оператора #include <QApplication> , возможно, это происходит из-за применения старой версии Qt. Убедитесь, что вы используете Qt 4.1.1 или более новую версию Qt 4. </p>
<p>[2] Сигналы Qt не надо путать с сигналами системы Unix. В данной книге нами рассматриваются только сигналы Qt. </p>
<p>[3] Qt позволяет применять значения TRUE и FALSE на любой платформе и везде использует их в качестве синонимов стандартных значений true и false . Тем не менее нет никакой необходимости в ваших собственных программах использовать написание этих значений большими буквами, если только не приходится применять старый компилятор, не поддерживающий значения true и false . — Прим. автора. </p>
<p>[4] Если вы находитесь в стране, которая признает патенты на программное обеспечение и где компания Unisys обладает патентом на LZW—распаковку, вам, возможно, потребуется лицензия от компании Unisys на право применения ее технологии работы с файлами GIF. По этой причине поддержка файлов GIF по умолчанию отключена в Qt. Мы надеемся, что срок действия ограничений этой лицензии истечет к концу 2004 года. GIF support is disabled in Qt by default because the decompression algorithm used by GIF files was patented in some countries where software patents are recognized. We believe that this patent has now expired worldwide. To enable GIF support in Qt, pass the —qt—gif command—line option to the configure script or set the appropriate option in the Qt installer. </p>
<p>[5] Подчеркнутый символ в пункте меню означает, что этот пункт можно выбрать в активном меню, нажав клавиатурную комбинацию «Alt» + «подчеркнутый символ». — Примеч. науч. ред. </p>
<p>[6] Используемый здесь удобный синтаксис qDebug() << arg требует включения заголовочного файла <QtDebug>, в то время как синтаксис qDebug("...", arg) доступен в любом файле, который включает по крайней мере один заголовочный файл Qt. </p>
<p>[7] Ключевое слою forever обеспечивается Qt. Оно просто разворачивается в оператор for (;;). </p>
<p>[8] Последние версии стандарта Unicode позволяют назначать символам значения, превышающие 65 535. Эти символы можно представить с помощью последовательности из двух 16-битовых значений, называемых «суррогатными парами» (surrogate pairs). </p>
<p>[9] Компания Microsoft вместо long long использует тип __int64. В программах Qt доступен тип qlonglong в качестве альтернативы, работающей на всех платформах Qt. </p>
<p>[10] Некоторые компиляторы позволяют использовать также переменные, однако нельзя на это рассчитывать в переносимых программах. </p>
</section>
<div>
<div>
<h3 class="title">Содержание</h3>
<div>
<ul>
<li>
<a class="chapLink" href="#sec_1">
<p> Вступление</p>
</a>
</li>
</ul>
</div>
<div>
<ul>
<li>
<a class="chapLink" href="#sec_2">
<p> Предисловие</p>
</a>
</li>
</ul>
</div>
<div>
<ul>
<li>
<a class="chapLink" href="#sec_3">
<p> Благодарности</p>
</a>
</li>
</ul>
</div>
<div>
<ul>
<li>
<a class="chapLink" href="#sec_4">
<p> Краткая история Qt</p>
</a>
</li>
</ul>
</div>
<div>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Часть I. Основные возможности средств разработки Qt</p>
</a>
</li>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Глава 1. Первое знакомство</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> «Здравствуй, Qt»</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Взаимодействие с пользователем</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Компоновка виджетов</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Использование справочной документации</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Стили виджетов</p>
</a>
</li>
</ul></ul></ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Глава 2. Создание диалоговых окон</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Подклассы QDialog</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Подробное описание технологии сигналов и слотов</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Метаобъектная система Qt</p>
</a>
</li>
</ul>
<ul>
</ul></ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Быстрое проектирование диалоговых окон</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Изменяющиеся диалоговые окна</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Динамические диалоговые окна</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Встроенные классы виджетов и диалоговых окон</p>
</a>
</li>
</ul></ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Глава 3. Создание главных окон</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Создание подкласса QMainWindow</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Создание меню и панелей инструментов</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Создание и настройка строки состояния</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Реализация меню File</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Применение диалоговых окон</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Сохранение настроек приложения</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Работа со многими документами</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Экранные заставки</p>
</a>
</li>
</ul></ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Глава 4. Реализация функциональности приложения</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Центральный виджет</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Создание подкласса QTableWidget</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Хранение данных в объектах типа «элемент»</p>
</a>
</li>
</ul>
<ul>
</ul></ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Загрузка и сохранение</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Реализация меню Edit</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Реализация других меню</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Создание подкласса QTableWidgetltem</p>
</a>
</li>
</ul></ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Глава 5. Создание пользовательских виджетов</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Настройка виджетов Qt</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Создание подкласса QWidget</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Интеграция пользовательских виджетов в Qt Designer</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_5">
<p> Двойная буферизация</p>
</a>
</li>
</ul></ul></ul>
</div>
<div>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Часть II. Средний уровень Qt—программирования</p>
</a>
</li>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Глава 6. Управление компоновкой</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Компоновка виджетов на форме</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Стековая компоновка</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Разделители</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Области с прокруткой</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Прикрепляемые виджеты и панели инструментов</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Многодокументный интерфейс</p>
</a>
</li>
</ul></ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Глава 7. Обработка событий</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Переопределение обработчиков событий</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Установка фильтров событий</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Обработка событий во время продолжительных процессов</p>
</a>
</li>
</ul></ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Глава 8. Графика 2D и 3D</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Рисование при помощи QPainter</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Преобразования рисовальщика</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Высококачественное воспроизведение изображения при помощи QImage</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Вывод на печатающее устройство</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Графические средства OpenGL</p>
</a>
</li>
</ul></ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Глава 9. Технология «drag-and-drop»</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Обеспечение поддержки технологии «drag-and-drop»</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Поддержка пользовательских типов переносимых объектов</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Работа с буфером обмена</p>
</a>
</li>
</ul></ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Глава 10. Классы отображения элементов</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Применение удобных классов отображения элементов</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Применение заранее определенных моделей</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Реализация пользовательских моделей</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Реализация пользовательских делегатов</p>
</a>
</li>
</ul></ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Глава 11. Классы—контейнеры</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Последовательные контейнеры</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Как работает неявное совместное использование данных</p>
</a>
</li>
</ul></ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Ассоциативные контейнеры</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Обобщенные алгоритмы</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Строки, массивы байтов и объекты произвольного типа</p>
</a>
</li>
</ul></ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Глава 12. Ввод—вывод</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Чтение и запись двоичных данных</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Чтение и запись текста</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Работа с каталогами</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Ресурсы, внедренные в исполняемый модуль</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Связь между процессами</p>
</a>
</li>
</ul></ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Глава 13. Базы данных</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Соединение с базой данных и выполнение запросов</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Представление данных в табличной форме</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Создание форм по технологии «master—detail»</p>
</a>
</li>
</ul></ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Глава 14. Работа с сетью</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Написание FTP—клиентов</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Написание НТТР—клиента</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Написание клиент—серверных приложений на базе TCP</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Передача и прием дейтаграмм UDP</p>
</a>
</li>
</ul></ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Глава 15. XML</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Чтение документов XML при помощи интерфейса SAX</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Чтение документов XML при помощи интерфейса DOM</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Запись документов XML</p>
</a>
</li>
</ul></ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Глава 16. Обеспечение интерактивной помощи</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Всплывающие подсказки, комментарии в строке состояния и справки «что это такое?»</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Использование </p>
<p> QTextBrowser</p>
<p> в качестве простого браузера системы помощи</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_6">
<p> Использование </p>
<p> Qt Assistant</p>
<p> для мощной интерактивной системы помощи</p>
</a>
</li>
</ul></ul></ul>
</div>
<div>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Часть III. Advanced Qt</p>
</a>
</li>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Глава 17. Интернационализация</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Работа с </p>
<p> Unicode</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Создание переводимого интерфейса приложения</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Динамическое переключение языков</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Перевод приложений</p>
</a>
</li>
</ul></ul>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Глава 18. Многопоточная обработка</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Создание потоков</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Синхронизация потоков</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Взаимодействие с главным потоком</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Применение классов Qt во вторичных потоках</p>
</a>
</li>
</ul></ul>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Глава 19. Создание подключаемых модулей</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Расширение Qt с помощью подключаемых модулей</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Как обеспечить в приложении возможность подключения модулей</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Написание подключаемых к приложению модулей</p>
</a>
</li>
</ul></ul>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Глава 20. Возможности, зависимые от платформы</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Применение «родных» программных интерфейсов</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Применение ActiveX в системе Windows</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Управление сеансами в системе X11</p>
</a>
</li>
</ul></ul>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Глава 21. Программирование встроенных систем</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Первое знакомство с Qtopia</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_7">
<p> Настройка Qtopia Core</p>
</a>
</li>
</ul></ul></ul>
</div>
<div>
<ul>
<li>
<a class="chapLink" href="#sec_8">
<p> Приложение А. Установка Qt</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_8">
<p> Замечание о лицензировании</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_8">
<p> Установка Qt/Windows</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_8">
<p> Установка Qt/Mac</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_8">
<p> Установка Qt/X11</p>
</a>
</li>
</ul></ul>
</div>
<div>
<ul>
<li>
<a class="chapLink" href="#sec_9">
<p> Приложение Б. Введение в С++ для программистов Java и С#</p>
</a>
</li>
<ul>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_9">
<p> Первое знакомство с С++</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_9">
<p> Основные отличия языков</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_9">
<p> Элементарные типы данных</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_9">
<p> Определения класса</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_9">
<p> Указатели</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_9">
<p> Ссылки</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_9">
<p> Массивы</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_9">
<p> Символьные строки</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_9">
<p> Перечисления</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_9">
<p> Имена, вводимые typedef</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_9">
<p> Преобразование типов</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_9">
<p> Перегрузка операторов</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_9">
<p> Типы значений</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_9">
<p> Глобальные переменные и функции</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_9">
<p> Пространства имен</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_9">
<p> Препроцессор</p>
</a>
</li>
</ul>
<ul>
<li>
<a class="chapLink" href="#sec_9">
<p> Стандартная библиотека С++</p>
</a>
</li>
</ul></ul>
</div>
</div>
</div>
</div><!-- .wrap -->
</div><!-- #main -->
</div>
</div><!-- #container -->
<div id="footer" class="clearfix" style="margin-bottom:40px">
<div class="footer-wrap">
<div class="footer-content">
<p class="copyright">2014</p>
<p class="themeby"> Связаться по вопросам размещения книг: <a href="mailto:litrespru@ya.ru" title="Почта">litrespru@ya.ru</a></p>
</div><!-- .footer-content -->
<!-- Yandex.RTB R-A-1583086-4 -->
<div id="yandex_rtb_R-A-1583086-4"></div>
<script>window.yaContextCb.push(()=>{
Ya.Context.AdvManager.render({
renderTo: 'yandex_rtb_R-A-1583086-4',
blockId: 'R-A-1583086-4'
})
})</script>
</div><!-- .wrap -->
</div><!-- #footer -->
<noindex>
<div class="footer">
<p style="font-size:14pt;" id="braveText">
</p></div>
</noindex>
<script type="text/javascript">
var $mgc = jQuery.noConflict();
$mgc(document).ready(function () {
$mgc('#dc_jqmegamenu_widget-2-item .mega').dcMegaMenu({
rowItems: 3,
subMenuWidth: '',
speed: 'fast',
effect: 'slide',
event: 'hover',
fullWidth: true
});
});
</script>
<script type="text/javascript">
function changeLink(){
setTimeout(function() {
document.getElementById("braveText").innerHTML = "Играй и пополняй словарный запас на <a rel='nofollow' id='brave' style='color:lightblue;text-decoration:underline' target='_blank'></a> языках!";
var link = document.getElementById("brave");
link.setAttribute('href', "htt"+"ps"+":"+"/"+"/"+"yandex"+"."+"ru"+"/"+"games/app"+"/"+"354393");
document.getElementById("brave").innerHTML = 'иностранных'
}, 500);
}
changeLink();
</script>
<script src="/scripts/script.js"></script>
<script src="/scripts/cookie.js"></script>
<script src="/scripts/modernizr.js"></script>
<script src="/scripts/jquery.flexslider-min.js"></script>
<script src="/scripts/jquery.megamenu.1.2.js"></script>
<script src="/scripts/jquery.hoverIntent.minified.js"></script>
</body>
</html>
|
