Источник: IBM developerWorks Россия
Автор: Алексей Бешенов, технический писатель, независимый специалист
Уровень сложности: средний
В этой статье:
Qt – кросс-платформенный инструментарий разработчика прикладного программного обеспечения, широко используемый для создания графических интерфейсов. Он написан на C++ и предоставляет мощные расширения этого языка. Также доступны интерфейсы для других языков программирования, таких как Python (PyQt), Ruby (Korundum/QtRuby) и Perl (PerlQt). Существует проект Jambi для Java, но его развитие вскоре будет прекращено. В первой статье цикла, посвященного программированию с использованием библиотек Qt, речь пойдет об объектной модели и основных инструментах разработчика. Материал рассчитан на программистов, знакомых с C++ и желающих изучить Qt 4 с самого начала. Он будет полезен в основном разработчикам прикладного ПО. Кроме того, компания Nokia активно продвигает Qt на рынок мобильных устройств, поэтому специалистам по встраиваемым системам также стоит присмотреться к возможностям этого инструментария (об использовании Qt на мобильных платформах речь пойдет в самом конце цикла). Мы будем использовать GNU/Linux, хотя выбор платформы мало влияет на ход разработки.
Введение
Существуют версии Qt для unix-подобных операционных систем с X Window System (например, X.Org (EN), Mac OS X и ОС Windows). Также Qt Software портирует свой продукт на мобильные платформы: Embedded Linux (EN), S60(EN) и Windows CE. Qt предоставляет большие возможности кросс-платформенной разработки самых разных программ, не обязательно с графическим интерфейсом. На нем, в частности, основана популярная среда рабочего стола KDE (EN).
Инструментарий разбит на модули, каждый из которых размещается в отдельной библиотеке. Базовые классы находятся в
QtCore
, компоненты графических интерфейсов – в
QtGui
, классы для работы с сетью – в
QtNetwork
и т.д. Таким образом, можно собирать программы даже для платформ, где нет X11 или другой совместимой графической подсистемы.
Установка Qt
Нам потребуется установить среду разработки Qt. Программное обеспечение распространяется на условиях свободной лицензии GPL 3.0 или LGPL 2.1. Его можно получить по адресу http://www.qtsoftware.com/downloads (EN).
Базовые библиотеки и инструменты
В репозиториях популярных дистрибутивов GNU/Linux уже есть готовые пакеты со средой разработки Qt (например, в Debian, Fedora, Gentoo, Mandriva, Ubuntu). Тем не менее, пользователь может собрать и установить инструментарий из исходных текстов.
Для систем, использующих X11, необходимо загрузить файл
qt-x11-opensource-src-4.x.y.tar.gz
, где
4.x.y
– последняя доступная версия из стабильных. Мы будем устанавливать версию 4.5.0.
В директории с файлом
qt-x11-opensource-src-4.5.0.tar.gz
выполните следующие команды:
tar xvfz qt-x11-opensource-src-4.5.0.tar.gz cd qt-x11-opensource-src-4.5.0 |
Прежде чем собирать Qt, запустите скрипт
configure
. Полный набор его опций выдается по команде
./configure -help
, но обычно можно использовать типовые настройки.
Параметр
-prefix
задает каталог для установки (по умолчанию используется
/usr/local/Trolltech/Qt-4.5.0
). Также имеются ключи для инсталляции различных компонентов (исполняемых файлов, библиотек, документации, и т.д.) в разные директории.
При запуске скрипт требует подтвердить согласие пользователя с условиями лицензии GPL / LGPL. После выполнения
./configure |
можно запустить сборку и установку при помощи команд:
make & make install |
Имейте в виду, что компиляция занимает много времени, а для установки Qt могут потребоваться права суперпользователя (файлы записываются в
/usr/local/
).
Если в дальнейшем вам понадобится в той же директории заново сконфигурировать и пересобрать Qt, удалите все следы предыдущей конфигурации при помощи
make confclean
, прежде чем снова запускать
./configure
.
Путь к исполняемым файлам Qt нужно добавить в переменную окружения PATH. В оболочках bash, ksh, zsh и sh это можно сделать, дописав в файл
~/.profile
следующие строки:
PATH=/usr/local/Trolltech/Qt-4.5.0/bin:$PATH export PATH |
В csh и tcsh нужно дописать в ~/.login строку:
setenv PATH /usr/local/Trolltech/Qt-4.5.0/bin:$PATH |
Если вы используете другую оболочку, то обратитесь к соответствующим разделам документации.
Кроме того, необходимо добавить строку
/usr/local/Trolltech/Qt-4.5.0/lib
в переменную
LD_LIBRARY_PATH
, если компилятор не поддерживает RPATH. Мы используем GNU/Linux и GCC (EN), поэтому пропускаем этот шаг.
Затем с помощью утилиты
qtdemo
запустите демонстрационные приложения для проверки работоспособности установленного инструментария.
SDK
Недавно появилась кросс-платформенная среда разработки Qt Creator. На сайте Qt Software можно найти полный SDK, включающий IDE (помимо библиотек и основных средств разработчика). Загрузите бинарный файл
qt-sdk-linux-x86-opensource-xxx.bin
и запустите мастер установки:
chmod +x ./qt-sdk-linux-x86-opensource-2009.01.bin ./qt-sdk-linux-x86-opensource-2009.01.bin |
Если не собираетесь устанавливать SDK в домашнюю директорию, то запускайте инсталлятор с правами суперпользователя.

![]() |
|
Инструменты разработчика
В состав Qt включены инструменты разработчика с графическим или консольным интерфейсом. В их числе:
-
assistant
– графическое средство для просмотра гипертекстовой документации по инструментарию и библиотекам Qt.
-
designer
– графическое средство для создания и сборки пользовательских интерфейсов на основе компонентов Qt.
-
qmake
– кросс-платформенный генератор Makefile.
-
moc
– компилятор метаобъектов (обработчик расширений Qt для C++).
-
uic
– компилятор пользовательских интерфейсов из файлов .ui, созданных в Qt Designer.
-
rcc
– компилятор ресурсов из файлов .qrc.
-
qtconfig
– графическое средство установки пользовательских настроек для приложений Qt.
-
qtdemo
– запуск примеров и демонстрационных программ.
-
qt3to4
– средство переноса проектов с Qt 3 на Qt 4.
-
linguist
– средство для локализации приложений.
-
pixeltool
– экранная лупа.


qmake
Утилита
qmake
используется для автоматического генерирования Makefile на различных платформах.
В целом
qmake
ориентируется на Qt. Если вас интересуют кросс-платформенные системы сборки более широкого назначения, то можете обратиться к CMake, которая также поддерживает Qt.
Новичкам стоит остановиться на qmake.
Полную документацию по этой утилите вы можете найти в Qt Assistant. Также с Qt поставляются страницы руководства, в том числе
qmake(1)
(наберите в командной строке
man qmake
). Здесь мы приведем основные указания, которые помогут вам собирать код примеров статьи, а также свои простые проекты.
myproject
и добавим туда файлы
hello.h, hello.cpp
и
main.cpp
. В
hello.h
опишем прототип функции
hello():
Листинг 1.1. Объявления функций программы «Hello, World!»
// hello.h void hello(); |
Реализацию
hello()
поместим в
hello.cpp:
Листинг 1.2. Реализации функций программы «Hello, World!»
// hello.cpp #include |
Здесь
qDebug()
используется для вывода отладочной информации. Ее можно убрать, объявив при компиляции символ
QT_NO_DEBUG_OUTPUT
. Также имеется функция
qWarning()
, выдающая предупреждения, и
qFatal()
, завершающая работу приложения после вывода сообщения о критической ошибке в
STDERR
(то же самое, но без завершения работы, делает
qCritical()
).
В заголовочном файле
содержатся объявления, добавляющие для
qDebug(), qWarning()
и
qCritical()
более удобный синтаксис оператора
<<
. При этом между аргументами (как в случае
qDebug() << a << b << c;
) автоматически расставляются пробелы, поддерживается вывод многих типов C++ и Qt, а в конце автоматически добавляется перевод строки.
Код основного приложения (здесь мы следуем соглашению, по которому
main()
помещается в файл
main.cpp
):
Листинг 1.3. Функция main() программы «Hello, World!»
// main.cpp #include "hello.h" int main() { hello(); return 0; } |
Чтобы создать файл проекта, запустите
qmake -project
После этого должен появиться файл
myproject.pro
примерно такого содержания:
#################################### # Automatically generated by qmake #################################### TEMPLATE = app TARGET = DEPENDPATH += . INCLUDEPATH += . # Input HEADERS += hello.h SOURCES += hello.cpp main.cpp |
Оператор = используется для присвоения значений переменным, += добавляет новую опцию к переменной, -= удаляет указанную опцию.
TEMPLATE = app
обозначает, что мы собираем приложение; для библиотеки используется
TEMPLATE = lib
.
TARGET
– имя целевого файла (укажите
TARGET = foobar
, чтобы получить исполняемый файл
foobar
).
DEPENDPATH
– директории для поиска при разрешении зависимостей.
INCLUDEPATH
– директории с заголовочными файлами.
После запуска
qmake
на основе
myproject.pro
в GNU/Linux будет создан обычный
Makefile
:
####### Compile hello.o: hello.cpp hello.h $(CXX) -c $(CXXFLAGS) $(INCPATH) -o hello.o hello.cpp main.o: main.cpp hello.h $(CXX) -c $(CXXFLAGS) $(INCPATH) -o main.o main.cpp ####### Install install: FORCE uninstall: FORCE FORCE: |
Опции qmake влияют на содержимое Makefile. Например,
qmake -Wall
добавит к флагам компилятора
-Wall
– вывод всех предупреждений.
По команде
make
мы получим исполняемый файл
myproject
, который выводит на экран строку «Hello, World!».
Эта схема может показаться слишком сложной, но в реальных проектах
qmake
берет на себя большую часть работы по сборке (например, запускает компилятор метаобъектов).
Qt Creator
Описанных выше инструментов достаточно для разработки приложений. Вы можете использовать любимый текстовый редактор, например GNU Emacs или Vim. С Qt работают также традиционные IDE, такие как KDevelop.
Однако не так давно Qt Software выпустила свою кросс-платформенную IDE Qt Creator. В неё встроены все инструменты разработчика, имеется редактор с подсветкой и дополнением кода, отладчик (графический интерфейс для
gdb
), а также реализована поддержка Perforce, SVN и Git.
При работе в Qt Creator используется несколько режимов, которым соответствуют вкладки на панели слева. Для быстрого переключения между режимами можно использовать комбинации клавиш
Ctrl+1, Ctrl+2
, и т.д. Основному режиму редактирования соответствует
Ctrl+2
.

Для навигации в редакторе применяется комбинация клавиш
Ctrl+K
. После ее нажатия нужно указать один из префиксов:
Таблица 1. Префиксы для навигации в Qt Creator
l | Строка в текущем документе |
---|---|
m | Методы |
c | Классы |
: | Классы и методы |
? | Предметный указатель справки |
f | Файлы на диске |
a | Файлы во всех проектах |
p | Файлы в текущем проекте |
После префикса нажмите пробел и введите соответствующую информацию. Например, для перехода на строку 93 текущего файла нужно напечатать "
l 93
" (то же самое можно сделать при помощи
Ctrl+L
), для перехода к документации по теме
qobject_cast – "? qobject_cast"
и т.д.
В нижней части окна при этом отображается поле с автоматическим дополнением.

Таблица 2. Комбинации клавиш для редактора Qt Creator
Ctrl+[ | Перейти к началу блока |
---|---|
Ctrl+] | Перейти к концу блока |
Ctrl+U | Выделить блок |
Ctrl+Shift+U | Снять выделение блока |
Ctrl+I | Выровнять блок |
Ctrl+< | Свернуть блок |
Ctrl+> | Развернуть блок |
Ctrl+/ | Закомментировать блок |
Ctrl+Shift+? | Переместить строку вверх |
Ctrl+Shift+? | Переместить строку вниз |
hift+Del | SУдалить строку |
Во встроенном редакторе реализовано «умное» дополнение кода, вызываемое комбинацией клавиш
Ctrl+<Пробел>
. База символов составляется на основе заголовочных файлов проекта из
INCLUDEPATH
.

Для чтения документации в IDE предусмотрен отдельный режим справки. Чтобы получить контекстную помощь по классу или методу, просто передвиньте текстовый курсор к имени и нажмите
F1
. Также полезна клавиша
F2
, перемещающая к определению в заголовочных файлах.
Чтобы переключиться из режима справки или отладки в основной режим редактирования, нажмите
Esc
. В режиме редактирования
Esc
переводит фокус из дополнительных окон (например, вывода компиляции или контекстной справки) на редактор. Если нажать Esc еще раз, то дополнительные окна закрываются.
Как и
qmake
, Qt Creator использует файлы в формате
.pro
, поэтому в IDE легко импортируются старые проекты, созданные вручную. Также доступен мастер, при помощи которого можно создать заготовку нового проекта.
Сейчас Qt Creator активно разрабатывается, но если вам нужна классическая IDE для Qt, работающая на различных платформах, то это лучший вариант.
![]() |
|
Стиль Qt
В Qt используется CamelCasing: имена классов выглядят как
MyClassName
, а имена методов – как
myMethodName
.
При этом имена всех классов Qt начинаются с
Q
, например
QObject, QList
или
QFont
.
Большинству классов соответствуют заголовочные файлы с тем же именем (без расширения
.h
), т.е. нужно использовать:
#include |
Поэтому в дальнейшем мы не будем отдельно оговаривать, где объявлен тот или иной класс.
Методы для получения и установки свойств (getter и setter) именуются следующим образом: свойство
fooBar
можно получить при помощи метода
fooBar()
и установить при помощи
setFooBar()
.
T fooBar() const; void setFooBar (T val); |
При разработке собственных приложений на Qt стоит придерживаться этого стиля.
![]() |
|
Объектная модель
Для эффективной работы с классами на стадии выполнения в Qt используется специальная объектная модель, расширяющая модель C++. В частности, добавляются следующие возможности:
- древовидные иерархии объектов;
-
аналог
dynamic_cast
для библиотеки, не использующий RTTI;
- взаимодействие объектов через сигналы и слоты;
- свойства объектов.
Многие объекты определяются значением сразу нескольких свойств, внутренними состояниями и связями с другими объектами. Они представляют собой индивидуальные сущности, и для них не имеет смысла операция буквального копирования, а также разделение данных в памяти. В Qt эти объекты наследуют свойства
QObject
.
В тех случаях, когда объект требовалось бы рассматривать не как сущность, а как значение (например, при хранении в контейнере) – используются указатели. Иногда указатель на объект, наследуемый от
QObject
, называют просто объектом.
Инструментарий спроектирован так, что для
QObject
и всех его потомков конструктор копирования и оператор присваивания недоступны – они объявлены в разделе
private
через макрос
Q_DISABLE_COPY()
:
class FooBar : public QObject { private: Q_DISABLE_COPY(FooBar) }; |
Будьте внимательны и не используйте конструкцию
Foo bar = Foo (baz);
вместо
Foo bar (baz);
Другие объекты (например, контейнеры и строки) полностью определяются представляемыми данными, поэтому в соответствующих классах имеются операция присваивания и конструктор копирования. Кроме того, объекты, представляющие одинаковые данные, могут прозрачно для программиста разделять их в памяти.

Система метаобъектов
Часть расширений реализована стандартными методами C++, однако Qt использует и более сложные синтаксические расширения, поэтому он использует автоматическую генерацию кода.
Для этого в C++ реализован механизм шаблонов, но он не предоставляет всех необходимых Qt возможностей, плохо совместим с динамической объектной моделью и в полной мере не поддерживается всеми версиями компиляторов.
В сложных ситуациях Qt использует свой компилятор метаобъектов
moc
, преобразующий код с расширениями в стандартный код C++. Для обозначения того, что класс использует метаобъектные возможности (и, соответственно, должен обрабатываться
moc
), в разделе
private
нужно указать макрос
Q_OBJECT
.
Если вы встречаете странные ошибки компиляции, сообщающие, что у класса не определен конструктор, либо у него нет таблицы виртуальных функций (
vtbl
), скорее всего вы забыли код, генерируемый moc. Обычно это происходит, если не указан макрос
Q_OBJECT
.
Во избежание ошибок
Q_OBJECT
лучше использовать во всех классах, наследуемых от
QObject
(косвенно либо напрямую).
Использование динамического подхода связано с определенными потерями в производительности по сравнению со статическим, однако этими накладками можно пренебречь, если принять во внимание полученные преимущества.
В числе прочих, метаобъектный код добавляет метод
virtual const QMetaObject* QObject::metaObject() const;
который возвращает указатель на метаобъект объекта.
На системе метаобъектов основаны сигналы, слоты и свойства.
При наследовании от
QObject
помните об ограничениях, налагаемых
moc
:
-
При множественном наследовании потомком
QObject
должен быть первый и только первый наследуемый класс:
class MyClass : public QObject, public Foo, public Bar { // ... };
-
Виртуальное наследование с
QObject
не поддерживается.
qobject_cast
Для динамического приведения
QObject
используется функция
T qobject_cast (QObject *object);
Она работает как стандартная операция
dynamic_cast
в C++, но не требует поддержки со стороны системы динамической идентификации типов (RTTI).
Пусть у нас имеется класс
MyClass1
, наследующий от
QObject
и
MyClass2
, наследующий от
MyClass1
:
#include |
Динамическое приведение иллюстрирует следующий код:
QObject *a = new MyClass2; MyClass1 *b = qobject_cast |
Эти операции сработают корректно на стадии выполнения.
Как и в случае с
dynamic_cast
, результат приведения можно проверить:
if (b = qobject_cast |
Система метаобъектов позволяет также проверить, наследует ли a класс
MyClass1
:
if (a->inherits("MyClass1")) { b = static_cast |
Однако предпочтителен предыдущий вариант с
qobject_cast
.
Деревья объектов
Объекты классов, наследующих от
QObject
, могут быть организованы в древовидную структуру. При удалении объекта Qt удаляет его дочерние объекты, которые в свою очередь удаляют свои дочерние объекты, и т.д. Иными словами, удаление объекта приводит к удалению всего поддерева, корнем которого он является.
Пусть у нас имеются классы
ClassA
и
ClassB
:
Листинг 2.1. Объявление MyClass для программы, демонстрирующей порядок создания и удаления объектов
// myclass.h #include |
Листинг 2.2. Определение методов MyClass для программы, демонстрирующей порядок создания и удаления объектов
// myclass.cpp #include |
Здесь родительский объект устанавливается в конструкторе
QObject
:
QObject::QObject (QObject *parent = 0);
Его можно установить в последующем при помощи метода
setParent()
и получить при помощи
parent()
:
void QObject::setParent (QObject *parent);
QObject* QObject::parent() const;
Если создать в стеке по одному из объектов A и B, то сначала будет создан A, потом B. В соответствии со стандартом C++, удаление происходит в обратном порядке – сначала B, затем A:
Листинг 2.3. Создание экземпляров MyClass в стеке
// main.cpp #include "myclass.h" int main() { MyClass a ('A'); MyClass b ('B'); return 0; } |
Если создать B в куче и назначить его дочерним объектом для A, то вместе с A автоматически удалится B:
Листинг 2.4. Создание экземпляра A класса MyClass в стеке, а экземпляра B – в куче, как дочернего для A
// main.cpp #include "myclass.h" int main() { MyClass a ('A'); MyClass *b = new MyClass ('B', &a); return 0; } |
Аналогично для более сложных деревьев:

Листинг 2.5. Многоуровневое дерево объектов с корнем в стеке
// main.cpp #include "myclass.h" int main() { MyClass a ('A'); MyClass *b = new MyClass ('B', &a); MyClass *c = new MyClass ('C', &a); MyClass *d = new MyClass ('D', c); MyClass *e = new MyClass ('E', c); return 0; } |
После удаления A удалится всё дерево.
Таким образом, программист должен создавать объекты в куче и задавать соответствующие иерархии, а заботу об управлении памятью Qt берет на себя.
Если объект и его дочерние объекты созданы в стеке, то подобный порядок удаления может привести к ошибкам.
int main() { MyClass b ('B'); MyClass a ('A'); b.setParent(&a); // ... return 0; } |
Здесь при выходе из области действия сначала будет удален объект A, так как он был создан последним. При этом Qt удалит и его дочерний объект B. Но потом будет сделана попытка удаления B, что приведет к ошибке.
В другом случае проблем не будет, потому что при вызове деструктора
QObject
объект удаляет себя из списка дочерних объектов родительского объекта:
int main() { MyClass a ('A'); MyClass b ('B', &a); // ... return 0; } |
Вообще говоря, дочерние объекты должны размещаться в куче.
У каждого
QObject
есть свойство
objectName
, для доступа к которому используются методы
QString objectName() const; void setObjectName (const QString& name); |
По умолчанию
objectName
– пустая строка. Через это свойство объектам в дереве можно присвоить имена для последующего поиска.
const QList & children() const; *>
– возвращает список дочерних объектов.
T findChild (const QString& name = QString()) const;
– возвращает дочерний объект с именем name, который можно привести к типу T, либо 0, если такой объект не найден. Без аргумента name возвращает все дочерние объекты. Поиск осуществляется рекурсивно.
QList QObject::findChildren (const QString& name = QString()) const;
– возвращает все дочерние объекты с именем name, которые можно привести к типу T, либо пустой список, если таких объектов не найдено. Без аргумента name возвращает все дочерние объекты. Поиск осуществляется рекурсивно.
QList QObject::findChildren (const QRegExp& regExp) const;
– аналогично, но с поиском по регулярному выражению regExp.
void dumpObjectTree();
– выводит отладочную информацию о дереве объектов с данным корнем.
При создании графических пользовательских интерфейсов взаимодействие объектов часто осуществляется через обратные вызовы, т.е. передачу кода для последующего выполнения (в виде указателей на функции, функторов, и т.д.). Также популярна концепция событий и обработчиков, в которой обработчик действует как перехватчик события определенного объекта.
В Qt вводится концепция сигналов и слотов.
Сигнал отправляется при вызове соответствующего ему метода. Программисту при этом нужно только указать прототип метода в разделе
signals
.
Слот является методом, исполняемым при получении сигнала. Слоты могут объявляться в разделе
pulic slots, protected slots
или
private slots
. При этом уровень защиты влияет лишь на возможность вызова слотов в качестве обычных методов, но не на возможность подключения сигналов к слотам.
Модель сигналов и слотов отличается от модели событий и обработчиков тем, что слот может подключаться к любому числу сигналов, а сигнал может подключаться к любому числу слотов. При отправке сигнала будут вызваны все подключенные к нему слоты (порядок вызовов не определен).
Объявление сигналов и слотов, отправка сигналов
В качестве типичного примера слота рассмотрим метод получения свойства (getter). Методу установки свойства (setter) при этом будет соответствовать сигнал.
Листинг 3.1. Класс MyClass со слотом void setValue (int x) и сигналом void valueChanged (int x)
// myclass.h #include |
Обратите внимание на макрос
Q_OBJECT
, сигнализирующий Qt о том, что используются возможности системы метаобъектов.
Листинг 3.2. Реализация методов класса MyClass со слотом void setValue (int x) и сигналом void valueChanged (int x)
// myclass.cpp #include |
Ключевое слово
emit
отвечает за отправку сигнала.
Для сигнала задается только прототип, причем сигнал не может возвращать значение (т.е., указывается
void
). За реализацию отвечает компилятор метаобъектов, он же преобразует расширенный синтаксис с ключевыми словами
signals, slots, emit
в стандартный код C++.
На самом деле, ключевые слова можно заменить на макросы
Q_SIGNALS, Q_SLOTS и Q_EMIT
. Это полезно, если вы используете сторонние библиотеки, в которых уже используются слова
signals, slots
или
emit
.
Обработка ключевых слов отключается флагом
no_keywords
. В файл проекта
qmake (.pro)
добавьте
CONFIG += no_keywords
Вы можете посмотреть на результат работы компилятора метаобъектов в файле
moc_slots.cpp
, который генерируется на основе
slots.h
и компилируется вместе с остальными
.cpp
.
Подключение сигнала к слоту
Листинг 3.3. Подключение сигнала void MyClass::valueChanged (int x) к слоту void MyClass::setValue (int x)
// main.cpp #include |
Здесь при помощи
QObject::connect
сигнал объекта
a
соединяется со слотом объекта
b
(передаются указатели на
QObject
). Макросы
SIGNAL
и
SLOT
формируют строковые сигнатуры методов. Их аргументы должны содержать прототипы без указания имен переменных, т.е.
SIGNAL(valueChanged(int x))
– недопустимый вариант.
Сигнатуры используются для сверки типов: сигнатура сигнала должна соответствовать сигнатуре слота. При этом у слота сигнатура может быть короче, если дополнительные аргументы игнорируются.
Другой вариант вызова
QObject::connect
:
b.connect (&a, SIGNAL(valueChanged(int)), SLOT(setValue(int)));
Таким образом, здесь вызов
MyClass::setValue
для
a
задействует
MyClass::setValue
для
b
.
Обратите внимание на строку
if (x_ == x) return;
. Она нужна, чтобы избежать проблем при циклических соединениях. Например, следующий код сработает:
Листинг 3.4. Циклическое соединение сигналов void MyClass::valueChanged (int x) со слотами void MyClass::setValue (int x)
// main.cpp #include |
QObject::connect
возвращает
true
, если соединение успешно установлено, и
false
в противном случае – например, когда сигнал или слот не обнаружен, либо их сигнатуры несовместимы.
Если добавить при помощи
QObject::connect
одинаковые соединения, то слот будет вызываться несколько раз.
Отключение
Для отключения сигнала от слота используется
QObject::disconnect
:
QObject::disconnect ( &a, SIGNAL(valueChanged(int)), &b, SLOT(setValue(int)) ); |
При успешном отключении возвращается
true
.
Если вместо сигнала
(SIGNAL(...))
указать 0, то данный получатель сигнала (
b
) и слот отключаются от любого сигнала:
QObject::disconnect (&a, 0, &b, SLOT(setValue(int)));
Если 0 указать вместо получателя сигнала (
b
) и слота
(SLOT(...))
, то отключено будет всё, что подключено к данному сигналу:
QObject::disconnect (&a, SIGNAL(valueChanged(int)), 0, 0);
Если 0 указать вместо слота
(SLOT(...))
, то отключено будет всё, что подключено к данному получателю сигнала (
b
):
QObject::disconnect (&a, SIGNAL(valueChanged(int)), &b, 0);
Получаем следующие варианты вызова
QObject::disconnect
:
// Отключить всё от сигналов, отправляемых объектом a: QObject::disconnect (&a, 0, 0, 0); // То же самое, но в виде метода a: a.disconnect(); // Отключить всё от сигнала SIGNAL(...), отправляемого объектом a: QObject::disconnect (&a, SIGNAL(...), 0, 0); // То же самое,но в виде метода a: a.disconnect (SIGNAL(...)); // Отключить данного получателя сигналов b: QObject::disconnect (&a, 0, &b, 0); // То же самое,но в виде метода a: a.disconnect (&b); |
При удалении одного из объектов соединения Qt автоматически удаляет само соединение.
Ограничения
У компилятора метаобъектов имеется ряд ограничений, которые распространяются и на работу с сигналами и слотами.
-
moc
не обрабатывает шаблоны и макросы, поэтому шаблоны классов не могут определять сигналы и слоты, а при объявлении сигналов и слотов нельзя использовать макросы (в том числе при указании параметров).
Макросы нельзя использовать в любых участках кода, которые должны обрабатываться
moc
. В частности, через них нельзя указать базовый класс.
Однако некоторые возможности препроцессора использовать можно. Доступны простые условные конструкции (с директивами
#if, #ifdef, #ifndef, #else, #elif, #endif
, а также специальным оператором
defined
). Для создания объявлений у
moc
имеется опция командной строки
-D
. Утилита
qmake
передает
moc
все объявления, перечисленные в параметре проекта
DEFINES
.
Например,
moc
правильно обработает
#if 0 // Игнорируемый блок #endif
Блок
#ifdef FOO // ... #endif
также будет обработан, только если вызвать
moc -DFOO
, либо если до него имеется строка
#define FOO
.
-
Типы должны быть указаны полностью, так как
QObject::connect()
сравнивает их буквально. В частности, если внутри класса
Foo
определяется перечисление
Bar
, то в аргументах сигнала нужно указывать
Foo::Bar
:
class Foo : public QObject { Q_OBJECT enum Bar { a, b, c }; signals: void somethingHappened (Foo::Bar x); };
-
В качестве параметров сигналов и слотов нельзя использовать указатели на функции. Например,
int (*fun)(int)
не является допустимым аргументом. Можно использовать typedef:
typedef int (*fun)(int);
Обычно вместо указателей лучше применять наследование и виртуальные функции.
-
Вложенные классы не могут содержать сигналы и слоты.
-
Сигналы и слоты, возвращающие ссылки, обрабатываются таким образом, как если бы они возвращали
void
.
-
В разделах
signals
и
slots
могут объявляться только сигналы и слоты.
Свойства
Класс, наследующий
QObject
, может содержать объявление свойства при помощи макроса
Q_PROPERTY()
:
Q_PROPERTY(
type name
READ
getFunction
[WRITE setFunction]
[RESET resetFunction]
[DESIGNABLE bool]
[SCRIPTABLE bool]
[STORED bool]
[USER bool])
Обязательные параметры макроса:
- type – тип свойства;
- name – имя свойства;
- getFunction – const-метод для считывания значения; возвращаемый тип должен быть type, type* либо type&.
Не обязательные параметры макроса:
-
setFunction – метод для установки значения свойства, должен возвращать
void
и принимать только один аргумент типа type, type*, либо type&;
-
resetFunction – метод для установки значения свойства по умолчанию, зависящего от контекста, должен не иметь аргументов и возвращать
void
;
Методы могут быть виртуальными либо унаследованными от базового класса. При множественном наследовании они должны принадлежать первому классу в списке.
Для не обязательных атрибутов
DESIGNABLE, SCRIPTABLE, STORED, USER
допускается указание булевых значений:
-
DESIGNABLE
– показывать ли свойство в Qt Designer и подобных графических программах. По умолчанию
true
, также можно указать булев метод.
-
SCRIPTABLE
– должно ли свойство быть видимым скриптовому движку. По умолчанию
true
, также можно указать булев метод.
-
STORED
– должно ли свойство сохраняться при сохранении состояния объекта либо оно вычисляется через другие свойства. По умолчанию
true
.
-
USER
— редактируется ли свойство пользователем. Обычно у классов, соответствующих элементам управления, бывает одно такое свойство. По умолчанию
false
.
Например,
QWidget
объявляет, в числе прочих, следующие свойства:
Q_PROPERTY(QSize minimumSize READ minimumSize WRITE setMinimumSize)
Q_PROPERTY(int minimumWidth READ minimumWidth WRITE setMinimumWidth STORED false DESIGNABLE false)
Q_PROPERTY(int minimumHeight READ minimumHeight WRITE setMinimumHeight STORED false DESIGNABLE false)
Свойство
minimumSize
имеет тип
QSize
и может быть получено при помощи
QSize minimumSize() const
и установлено при помощи
void setMinimumSize
(
const QSize&
).
minimumWidth
и
minimumHeight
вычисляются через
minimumSize
, поэтому для них указано
STORED false
.
Пример свойства с атрибутом
USER – text в QLineEdit
:
Q_PROPERTY(QString text READ text WRITE setText USER true) |
Для считывания и записи свойства используются методы:
QVariant QObject::property (const char * name) const; bool QObject::setProperty (const char * name, const QVariant& value); |
property()
возвращает значение свойства либо неправильный вариант
QVariant
, если такого свойства нет.
setProperty()
возвращает
true
, если у объекта есть указанное свойство с типом, совместимым с переданным значением. В противном случае возвращается
false
.
Если в классе нет указанного свойства, то добавляется динамическое свойство объекта. Перечень динамических свойств можно получить при помощи
QList |
Рассмотрим пример использования свойств. Пусть класс
MyClass
имеет строковое свойство
text
(типа
QString
):
Листинг 4.1. Объявление класса MyClass со свойством text
// myclass.h #include |
Листинг 4.2. Определение методов класса MyClass со свойством text
// myclass.cpp #include |
Работа со свойством:
Листинг 4.3. Работа со свойством text объекта MyClass
// main.cpp #include <QByteArray> #include <QList> #include <QListIterator> #include <QString> #include <QtDebug> #include <QVariant> |
Программа должна вывести на экран следующее:
text : "foo" text : "bar" text : "baz" [Dynamic] foo : "bob" [Dynamic] bar : "slack" |
Разумеется, безопаснее и быстрее вызывать методы конкретного класса для считывания и записи свойств.
property()
и
setProperty()
нужны в том случае, когда о классе ничего не известно кроме имен и типов свойств.
Если для класса не известен даже перечень свойств и методов, можно использовать метаобъект.
Работа с метаобъектами
QObject::metaObject()
. С его помощью можно динамически получить информацию о классе, как, например, в Java Reflecion API (EN).
Основная информация
Имя класса возвращает
const char * QMetaObject::className() const;
Указатель на метаобъект базового класса –
const QMetaObject* superClass() const;
Методы
Через систему метаобъектов доступны только те методы и конструкторы, перед объявлениями которых указан макрос
Q_INVOKABLE
:
class MyClass : public QObject { Q_OBJECT public: Q_INVOKABLE MyClass(); // виден системе метаобъектов Q_INVOKABLE void foo(); // виден void foo(); // не виден }; |
Для доступа к методам (в том числе сигналам и слотам) используйте
int QMetaObject::methodCount() const; int QMetaObject::methodOffset() const; QMetaMethod QMetaObject::method (int index) const; |
Методы и свойства класса проиндексированы. Доступ к методу по индексу осуществляется через
QMetaObject::method()
.
Общее число методов, с учетом наследованных, возвращает
QMetaObject::methodCount()
. Смещение методов класса возвращается
QMetaObject::methodOffset()
, оно показывает, с какого индекса начинаются методы данного класса. Смещение увеличивается при наследовании и показывает число методов базовых классов.
Пример прохода по методам:
const QMetaObject* m_obj = obj.metaObject(); for (int i = m_obj->methodOffset(); i < m_obj->methodCount(); i++) { qDebug() << m_obj->method(i).signature(); } |
Если бы мы начали с индекса 0, то получили бы методы всех базовых классов, в том числе
QObject
:
destroyed(QObject*) destroyed() deleteLater() _q_reregisterTimers(void*) ... |
Методы, начинающиеся с
_q_
, используются внутри Qt и не являются частью API.
Конструкторы указываются отдельно:
QMetaMethod QMetaObject::constructor (int index) const; int QMetaObject::constructorCount() const; |
Например, получим перечень конструкторов
QObject
:
Листинг 5. Вывод конструкторов QObject через систему метаобъектов
#include <QMetaMethod> #include <QMetaObject> #include <QObject> #include <QtDebug> |
Результат:
QObject(QObject*) QObject() |
Индекс метода, сигнала, слота или конструктора можно получить по его сигнатуре:
int QMetaObject::indexOfConstructor (const char * constructor) const; int QMetaObject::indexOfMethod (const char * method) const; int QMetaObject::indexOfSignal (const char * signal) const; int QMetaObject::indexOfSlot (const char * slot) const; |
Для конструкторов, методов или сигналов ожидаются нормализованные сигнатуры. Их можно получить при помощи статического метода
static QByteArray QMetaObject::normalizedSignature (const char * method); |
Например,
QMetaObject::normalizedSignature ("int * foo(const QString &, QObject *)") |
возвращает "
int*foo(QString,QObject*)
".
Аналогично работает
static QByteArray QMetaObject::normalizedType (const char * type); |
Это текстовое приведение к каноническому виду, используемое, в частности, при проверке совместимости сигнала и слота.
Свойства
Аналогично можно работать со свойствами.
int QMetaObject::propertyCount() const; int QMetaObject::propertyOffset() const; QMetaProperty QMetaObject::property (int index) const; |
Пример:
const QMetaObject* m_obj = obj.metaObject(); for (int i = m_obj->propertyOffset(); i < m_obj->>propertyCount(); i++) { qDebug() << m_obj->property(i).name(); } |
(Если просмотреть все свойства, включая наследованные, то вы увидите, по меньшей мере,
objectName
из
QObject
.)
Индекс свойства можно получить по его имени:
int QMetaObject::indexOfProperty (const char * name) const; |
Перечисления
Перечисления регистрируются в классе при помощи макроса
Q_ENUMS()
.
Перечисление, значения которого можно комбинировать при помощи побитового ИЛИ, называется флагом и должно регистрироваться при помощи
Q_FLAGS()
.
QMetaEnum QMetaObject::enumerator (int index) const; int QMetaObject::enumeratorCount() const; int QMetaObject::enumeratorOffset() const; |
Пример:
Листинг 6.1. Класс MyClass с перечислением Type и флагом Mode
class MyClass { Q_OBJECT Q_ENUMS(Type) Q_FLAGS(Mode) public: enum Type { A, B, C }; enum Mode { Read = 0x1, Write = 0x2, Execute = 0x4 }; // ... }; |
Флаги используются следующим образом:
int mode = MyClass::Read | MyClass::Write; // ... if (mode & MyClass::Write) // Установлен ли флаг Write? { // ... } |
Динамическая работа с перечислениями:
Листинг 6.2. Вывод перечислений и флагов MyClass через систему метаобъектов
MyClass obj; const QMetaObject* m_obj = obj.metaObject(); for (int i = m_obj->enumeratorOffset(); i < m_obj->enumeratorCount(); i++) { QMetaEnum me = m_obj->enumerator(i); if (me.isValid()) // Есть имя { if (me.isFlag()) // Флаг { qDebug() << "[Flag]" << me.scope() << "::" << me.name(); } else { qDebug() << me.scope() << "::" << me.name(); } } } |
Результат работы:
MyClass :: Type [Flag] MyClass :: Mode |
Индекс перечисления можно получить по его имени:
int QMetaObject::indexOfEnumerator (const char * name) const; |
CLASSINFO
При помощи макроса
Q_CLASSINFO()
к метаобъекту можно добавлять пары имя–значение. Например,
Листинг 7.1. Класс MyClass с CLASSINFO
class MyClass { Q_OBJECT Q_CLASSINFO("author", "Bob Dobbs") Q_CLASSINFO("version", "0.23") // ... }; |
Эти пары наследуются, и их можно получить из метаобъекта по той же схеме:
QMetaClassInfo QMetaObject::classInfo (int index) const; int QMetaObject::classInfoCount() const; int QMetaObject::classInfoOffset() const; |
Для примера выше:
Листинг 7.2. Вывод CLASSINFO класса MyClass
MyClass obj; const QMetaObject* m_obj = obj.metaObject(); for (int i = m_obj->classInfoOffset(); i < m_obj->classInfoCount(); i++) { QMetaClassInfo mci = m_obj->classInfo(i); qDebug() << mci.name() << ':' << mci.value(); } |
Результат:
author : Bob Dobbs version : 0.23 |
Индекс
CLASSINFO
можно получить по его имени:
int QMetaObject::indexOfClassInfo (const char * name) const; |
Вызов конструкторов и методов
Передача аргументов осуществляется через объекты
QGenericArgument
и
QGenericReturnArgument
. Они создаются макросами
Q_ARG
и
Q_RETURN_ARG
.
// константная ссылка для передачи значения: Q_ARG (T, const T& value) // ссылка для возврата значения: Q_RETURN_ARG (T, T& value) |
Пример использования:
Q_ARG(QString, "foo") Q_ARG(int, 23) Q_RETURN_ARG(QString, str) |
Для создания нового экземпляра класса используется метод метаобъекта
newInstance()
, которому можно передать до 10 аргументов.
QObject* QMetaObject::newInstance ( QGenericArgument val0 = QGenericArgument(0), QGenericArgument val1 = QGenericArgument(), QGenericArgument val2 = QGenericArgument(), QGenericArgument val3 = QGenericArgument(), QGenericArgument val4 = QGenericArgument(), QGenericArgument val5 = QGenericArgument(), QGenericArgument val6 = QGenericArgument(), QGenericArgument val7 = QGenericArgument(), QGenericArgument val8 = QGenericArgument(), QGenericArgument val9 = QGenericArgument() ) const; |
В случае ошибки возвращается 0.
Для вызова метода используется
invokeMethod()
:
static bool QMetaObject::invokeMethod ( QObject* obj, const char * member, Qt::ConnectionType type, QGenericReturnArgument ret, QGenericArgument val0 = QGenericArgument(0), QGenericArgument val1 = QGenericArgument(), QGenericArgument val2 = QGenericArgument(), QGenericArgument val3 = QGenericArgument(), QGenericArgument val4 = QGenericArgument(), QGenericArgument val5 = QGenericArgument(), QGenericArgument val6 = QGenericArgument(), QGenericArgument val7 = QGenericArgument(), QGenericArgument val8 = QGenericArgument(), QGenericArgument val9 = QGenericArgument() ); |
где
- obj – указатель на объект;
- member – имя метода;
-
type – тип вызова:
-
Qt::DirectConnection
– незамедлительно,
-
Qt::QueuedConnection
– при начале выполнения
QCoreApplication::exec()
,
-
Qt::AutoConnection
– синхронно, если объект находится в том же потоке, и асинхронно в противном случае;
-
- ret – возвращаемое значение;
далее следует до 10 аргументов.
При асинхронном вызове значение не может быть вычислено.
Имеются перегруженные версии
invokeMethod()
. Если вы не укажете тип вызова, то будет использоваться
Qt::AutoConnection
. Если вы не укажете возвращаемое значение, то оно будет проигнорировано.
Те же возможности предоставляет класс
QMetaMethod
:
bool QMetaMethod::invoke ( QObject* object, Qt::ConnectionType connectionType, QGenericReturnArgument returnValue, QGenericArgument val0 = QGenericArgument(0), QGenericArgument val1 = QGenericArgument(), QGenericArgument val2 = QGenericArgument(), QGenericArgument val3 = QGenericArgument(), QGenericArgument val4 = QGenericArgument(), QGenericArgument val5 = QGenericArgument(), QGenericArgument val6 = QGenericArgument(), QGenericArgument val7 = QGenericArgument(), QGenericArgument val8 = QGenericArgument(), QGenericArgument val9 = QGenericArgument() ) const; |
Точно так же, тип соединения и/или возвращаемое значение можно не указывать.
Асинхронный вызов используется в том случае, когда вычисления занимают слишком много времени, поэтому их результат не ожидается в точке вызова. Подобные вычисления обычно помещают в отдельный поток, поэтому по умолчанию (
Qt::AutoConnection
) методы объектов из внешних потоков вызываются асинхронно.
Рассмотрим следующий класс:
Листинг 8.1. Класс MyClass с конструктором и методами, доступными системе метаобъектов
class MyClass : public QObject { Q_OBJECT public: Q_INVOKABLE MyClass (QString text, QObject *parent = 0); Q_INVOKABLE QString text() const; Q_INVOKABLE void setText (const QString& text); private: QString text_; }; |
Обращение к конструктору и методам:
Листинг 8.2. Вызов конструкторов и методов класса MyClass через систему метаобъектов
MyClass foo ("foo"); const QMetaObject* m_foo = foo.metaObject(); // Создать новый экземпляр: MyClass *bar = qobject_cast |
text()
и
setText()
вызываются таким образом лишь в качестве простого примера работы с
QMetaObject::invokeMethod()
. Как вы уже знаете, эти два метода должны быть связаны со свойством.
Также обратите внимание, что
text()
возвращает
QString
, но не
const QString&
. Иначе бы система метаобъектов считала, что
text()
возвращает
void
.
Заключение
Для эффективной работы с классами на стадии выполнения Qt использует специальную объектную модель, в которой при помощи наследования от
QObject
и генерирования кода компилятором метаобъектов реализованы:
- иерархии объектов;
-
специальный аналог
dynamic_cast
, не зависящий от RTTI;
- система сигналов и слотов;
- система свойств объектов;
- динамическая работа с классами.
В следующей статье мы рассмотрим типы, варианты, ссылки и разделение данных.
Ресурсы
-
Примите участие в обсуждении материала на форуме IBM developerWorks.
-
Исходный код с примерами (EN).
-
Qt Software (EN).
-
Документация по Qt (EN).
-
Qt Centre (EN).
-
Информационный бюллетень «Qt Quarterly» (EN).
-
Списки рассылки Qt (EN).
-
Jasmin Blanchette, Mark Summerfield. C++ GUI Programming with Qt 4 (2nd Edition) (EN). Prentice Hall: 2006. – 752 pp.
-
Daniel Molkentin. The Book of Qt 4: The Art of Building Qt Applications (EN). No Starch Press: 2007. – 440 pp.
-
J. Thelin. Foundations of Qt Development (EN). Apress: 2007. – 528 pp.
-
Bjarne Stroustrup. The C++ Programming Language (Special Edition) (EN). Addison-Wesley: 2000 – 1040 pp.
-
Ж. Бланшет, М. Саммерфилд. Qt 4. Программирование GUI на C++. 2-е издание. Кудиц-пресс: 2008 – 736 с.
- Б. Страуструп. Язык программирования C++. 2-е издание. Бином: 2007 – 1099 с.
Об авторе
![]() |
||
![]() |
Алексей Бешенов --- независимый разработчик и технический писатель, работающий со свободным программным обеспечением и свободными технологиями. Интересуется функциональным и логическим программированием, занимается математикой и теоретической информатикой. |