l-qt 1-pdf

Программирование с Qt : Часть 1. Введение.
Инструменты разработчика и объектная модель
Алексей Бешенов
технический писатель
независимый специалист
27.08.2009
Qt – кросс-платформенный инструментарий разработчика прикладного программного
обеспечения, широко используемый для создания графических интерфейсов. Он написан
на C++ и предоставляет мощные расширения этого языка. Также доступны интерфейсы
для других языков программирования, таких как Python (PyQt), Ruby (Korundum/
QtRuby) и Perl (PerlQt). Существует проект Jambi для Java, но его развитие вскоре будет
прекращено. В первой статье цикла, посвященного программированию с использованием
библиотек Qt, речь пойдет об объектной модели и основных инструментах разработчика.
Материал рассчитан на программистов, знакомых с C++ и желающих изучить Qt 4 с
самого начала. Он будет полезен в основном разработчикам прикладного ПО. Кроме
того, компания Nokia активно продвигает Qt на рынок мобильных устройств, поэтому
специалистам по встраиваемым системам также стоит присмотреться к возможностям
этого инструментария (об использовании Qt на мобильных платформах речь пойдет в
самом конце цикла). Мы будем использовать GNU/Linux, хотя выбор платформы мало
влияет на ход разработки.
1. Введение
Существуют версии 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 или другой совместимой графической
подсистемы.
© Copyright IBM Corporation 2009
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Торговые марки
Страница 1 из 34
developerWorks®
ibm.com/developerWorks/ru/
2. Установка Qt
Нам потребуется установить среду разработки Qt. Программное обеспечение
распространяется на условиях свободной лицензии GPL 3.0 или LGPL 2.1. Его можно
получить по адресу http://www.qtsoftware.com/downloads (EN).
2.1. Базовые библиотеки и инструменты
В репозиториях популярных дистрибутивов GNU/Linux уже есть готовые пакеты со средой
разработки Qt (например, в Debian, Fedora, Gentoo, Mandriva, Ubuntu). Тем не менее,
пользователь может собрать и установить инструментарий из исходных текстов.
Для систем, использующих X11, необходимо загрузить файл qt-x11-opensourcesrc-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 следующие
строки:
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 2 из 34
ibm.com/developerWorks/ru/
developerWorks®
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 запустите демонстрационные приложения для проверки
работоспособности установленного инструментария.
2.2. 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 в домашнюю директорию, то запускайте
инсталлятор с правами суперпользователя.
Рисунок 1. Установка Qt SDK
3. Инструменты разработчика
В состав Qt включены инструменты разработчика с графическим или консольным
интерфейсом. В их числе:
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 3 из 34
developerWorks®
ibm.com/developerWorks/ru/
• 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 – экранная лупа.
Рисунок 2. Qt Assistant
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 4 из 34
ibm.com/developerWorks/ru/
developerWorks®
Рисунок 3. qtdemo
3.1. 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 <QtDebug>
#include "hello.h"
void hello()
{
qDebug() << "Hello, World!";
}
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 5 из 34
developerWorks®
ibm.com/developerWorks/ru/
Здесь qDebug() используется для вывода отладочной информации. Ее можно убрать,
объявив при компиляции символ QT_NO_DEBUG_OUTPUT. Также имеется функция qWarning(),
выдающая предупреждения, и qFatal(), завершающая работу приложения после вывода
сообщения о критической ошибке в STDERR (то же самое, но без завершения работы, делает
qCritical()).
В заголовочном файле <QtDebug> содержатся объявления, добавляющие для 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 –
foobar).
что мы собираем приложение; для библиотеки используется
имя целевого файла (укажите TARGET = foobar, чтобы получить исполняемый файл
DEPENDPATH
– директории для поиска при разрешении зависимостей.
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 6 из 34
ibm.com/developerWorks/ru/
INCLUDEPATH
developerWorks®
– директории с заголовочными файлами.
После запуска
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 берет на себя
большую часть работы по сборке (например, запускает компилятор метаобъектов).
3.2. 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.
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 7 из 34
developerWorks®
ibm.com/developerWorks/ru/
Рисунок 4. Qt Creator
Для навигации в редакторе применяется комбинация клавиш Ctrl+K. После ее нажатия
нужно указать один из префиксов:
Таблица 1. Префиксы для навигации в Qt Creator
l
Строка в текущем документе
m
Методы
c
Классы
:
Классы и методы
?
Предметный указатель справки
f
Файлы на диске
a
Файлы во всех проектах
p
Файлы в текущем проекте
После префикса нажмите пробел и введите соответствующую информацию. Например, для
перехода на строку 93 текущего файла нужно напечатать "l 93" (то же самое можно сделать
при помощи Ctrl+L), для перехода к документации по теме qobject_cast – "? qobject_cast"
и т.д.
В нижней части окна при этом отображается поле с автоматическим дополнением.
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 8 из 34
ibm.com/developerWorks/ru/
developerWorks®
Рисунок 5. Поле для навигации в Qt Creator
Таблица 2. Комбинации клавиш для редактора Qt Creator
Ctrl+[
Перейти к началу блока
Ctrl+]
Перейти к концу блока
Ctrl+U
Выделить блок
Ctrl+Shift+U
Снять выделение блока
Ctrl+I
Выровнять блок
Ctrl+<
Свернуть блок
Ctrl+>
Развернуть блок
Ctrl+/
Закомментировать блок
Ctrl+Shift+↑
Переместить строку вверх
Ctrl+Shift+↓
Переместить строку вниз
hift+Del
SУдалить строку
Во встроенном редакторе реализовано «умное» дополнение кода, вызываемое комбинацией
клавиш Ctrl+<Пробел>. База символов составляется на основе заголовочных файлов проекта
из INCLUDEPATH.
Рисунок 6. Дополнение кода в Qt Creator
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 9 из 34
developerWorks®
ibm.com/developerWorks/ru/
Для чтения документации в IDE предусмотрен отдельный режим справки. Чтобы получить
контекстную помощь по классу или методу, просто передвиньте текстовый курсор к имени
и нажмите F1. Также полезна клавиша F2, перемещающая к определению в заголовочных
файлах.
Чтобы переключиться из режима справки или отладки в основной режим редактирования,
нажмите Esc. В режиме редактирования Esc переводит фокус из дополнительных окон
(например, вывода компиляции или контекстной справки) на редактор. Если нажать Esc еще
раз, то дополнительные окна закрываются.
Как и qmake, Qt Creator использует файлы в формате .pro, поэтому в IDE легко
импортируются старые проекты, созданные вручную. Также доступен мастер, при помощи
которого можно создать заготовку нового проекта.
Сейчас Qt Creator активно разрабатывается, но если вам нужна классическая IDE для Qt,
работающая на различных платформах, то это лучший вариант.
4. Стиль Qt
В Qt используется CamelCasing: имена классов выглядят как MyClassName, а имена методов –
как myMethodName.
При этом имена всех классов Qt начинаются с Q, например QObject, QList или QFont.
Большинству классов соответствуют заголовочные файлы с тем же именем (без расширения
.h), т.е. нужно использовать:
#include <QObject>
#include <QList>
#include <QFont>
Поэтому в дальнейшем мы не будем отдельно оговаривать, где объявлен тот или иной
класс.
Методы для получения и установки свойств (getter и setter) именуются следующим образом:
свойство fooBar можно получить при помощи метода fooBar() и установить при помощи
setFooBar().
T fooBar() const;
void setFooBar (T val);
При разработке собственных приложений на Qt стоит придерживаться этого стиля.
5. Объектная модель
Для эффективной работы с классами на стадии выполнения в Qt используется специальная
объектная модель, расширяющая модель C++. В частности, добавляются следующие
возможности:
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 10 из 34
ibm.com/developerWorks/ru/
•
•
•
•
developerWorks®
древовидные иерархии объектов;
аналог 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);
Другие объекты (например, контейнеры и строки) полностью определяются
представляемыми данными, поэтому в соответствующих классах имеются операция
присваивания и конструктор копирования. Кроме того, объекты, представляющие
одинаковые данные, могут прозрачно для программиста разделять их в памяти.
Рисунок 7. Некоторые классы Qt.
5.1. Система метаобъектов
Часть расширений реализована стандартными методами C++, однако Qt использует и более
сложные синтаксические расширения, поэтому он использует автоматическую генерацию
кода.
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 11 из 34
developerWorks®
ibm.com/developerWorks/ru/
Для этого в C++ реализован механизм шаблонов, но он не предоставляет всех необходимых
Qt возможностей, плохо совместим с динамической объектной моделью и в полной мере не
поддерживается всеми версиями компиляторов.
В сложных ситуациях Qt использует свой компилятор метаобъектовmoc, преобразующий
код с расширениями в стандартный код C++. Для обозначения того, что класс использует
метаобъектные возможности (и, соответственно, должен обрабатываться moc), в разделе
private нужно указать макрос Q_OBJECT.
Если вы встречаете странные ошибки компиляции, сообщающие, что у класса не определен
конструктор, либо у него нет таблицы виртуальных функций (vtbl), скорее всего вы забыли
код, генерируемый moc. Обычно это происходит, если не указан макрос Q_OBJECT.
Во избежание ошибок Q_OBJECT лучше использовать во всех классах, наследуемых от
QObject (косвенно либо напрямую).
Использование динамического подхода связано с определенными потерями в
производительности по сравнению со статическим, однако этими накладками можно
пренебречь, если принять во внимание полученные преимущества.
В числе прочих, метаобъектный код добавляет метод
virtual const QMetaObject* QObject::metaObject() const;
который возвращает указатель на метаобъект объекта.
На системе метаобъектов основаны сигналы, слоты и свойства.
При наследовании от QObject помните об ограничениях, налагаемых moc:
1. При множественном наследовании потомком QObject должен быть первый и только
первый наследуемый класс:
class MyClass : public QObject, public Foo, public Bar
{
// ...
};
2. Виртуальное наследование с QObject не поддерживается.
5.2. qobject_cast
Для динамического приведения QObject используется функция
T qobject_cast (QObject *object);
Она работает как стандартная операция dynamic_cast в C++, но не требует поддержки со
стороны системы динамической идентификации типов (RTTI).
Пусть у нас имеется класс MyClass1, наследующий от QObject и MyClass2, наследующий от
MyClass1:
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 12 из 34
ibm.com/developerWorks/ru/
developerWorks®
#include <QObject>
class MyClass1 : public QObject
{
Q_OBJECT
public:
MyClass1();
// ...
};
class MyClass2 : public MyClass1
{
Q_OBJECT
public:
MyClass2();
// ...
};
Динамическое приведение иллюстрирует следующий код:
QObject *a = new MyClass2;
MyClass1 *b = qobject_cast<MyClass1*>(a);
MyClass2 *c = qobject_cast<MyClass2*>(b);
Эти операции сработают корректно на стадии выполнения.
Как и в случае с dynamic_cast, результат приведения можно проверить:
if (b = qobject_cast<MyClass1*>(a))
{
// ...
}
Система метаобъектов позволяет также проверить, наследует ли a класс MyClass1:
if (a->inherits("MyClass1"))
{
b = static_cast<MyClass1*>(a);
// ...
}
Однако предпочтителен предыдущий вариант с qobject_cast.
5.3. Деревья объектов
Объекты классов, наследующих от QObject, могут быть организованы в древовидную
структуру. При удалении объекта Qt удаляет его дочерние объекты, которые в свою очередь
удаляют свои дочерние объекты, и т.д. Иными словами, удаление объекта приводит к
удалению всего поддерева, корнем которого он является.
Пусть у нас имеются классы ClassA и ClassB:
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 13 из 34
developerWorks®
ibm.com/developerWorks/ru/
Листинг 2.1. Объявление MyClass для программы, демонстрирующей
порядок создания и удаления объектов
// myclass.h
#include <QObject>
class MyClass : public QObject
{
public:
MyClass (char id, QObject *parent = 0);
~MyClass();
private:
char id_;
};
Листинг 2.2. Определение методов MyClass для программы,
демонстрирующей порядок создания и удаления объектов
// myclass.cpp
#include <QObject>
#include <QtDebug>
#include "myclass.h"
MyClass::MyClass (char id, QObject *parent) :
QObject(parent), id_(id)
{
qDebug() << '+' >> id_;
}
MyClass::~MyClass()
{
qDebug() << '-' >> id_;
}
Здесь родительский объект устанавливается в конструкторе 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;
}
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 14 из 34
ibm.com/developerWorks/ru/
developerWorks®
Если создать 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;
}
Аналогично для более сложных деревьев:
Рисунок 8. Пример многоуровневого дерева объектов
Листинг 2.5. Многоуровневое дерево объектов с корнем в стеке
// main.cpp
#include "myclass.h"
int main()
{
MyClass a ('A');
MyClass *b = new MyClass
MyClass *c = new MyClass
MyClass *d = new MyClass
MyClass *e = new MyClass
return 0;
}
('B',
('C',
('D',
('E',
&a);
&a);
c);
c);
После удаления A удалится всё дерево.
Таким образом, программист должен создавать объекты в куче и задавать соответствующие
иерархии, а заботу об управлении памятью Qt берет на себя.
Если объект и его дочерние объекты созданы в стеке, то подобный порядок удаления может
привести к ошибкам.
int main()
{
MyClass b ('B');
MyClass a ('A');
b.setParent(&a);
// ...
return 0;
}
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 15 из 34
developerWorks®
ibm.com/developerWorks/ru/
Здесь при выходе из области действия сначала будет удален объект 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<QObject*>& children() const;
– возвращает список дочерних объектов.
T findChild (const QString& name = QString()) const;
– возвращает дочерний объект с именем name, который можно привести к типу T, либо 0,
если такой объект не найден. Без аргумента name возвращает все дочерние объекты. Поиск
осуществляется рекурсивно.
QList<T> QObject::findChildren (const QString& name = QString()) const;
– возвращает все дочерние объекты с именем name, которые можно привести к типу T,
либо пустой список, если таких объектов не найдено. Без аргумента name возвращает все
дочерние объекты. Поиск осуществляется рекурсивно.
QList<T> QObject::findChildren (const QRegExp& regExp) const;
– аналогично, но с поиском по регулярному выражению regExp.
void dumpObjectTree();
– выводит отладочную информацию о дереве объектов с данным корнем.
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 16 из 34
ibm.com/developerWorks/ru/
developerWorks®
5.4. Сигналы и слоты
При создании графических пользовательских интерфейсов взаимодействие объектов часто
осуществляется через обратные вызовы, т.е. передачу кода для последующего выполнения
(в виде указателей на функции, функторов, и т.д.). Также популярна концепция событий и
обработчиков, в которой обработчик действует как перехватчик события определенного
объекта.
В Qt вводится концепция сигналов и слотов.
Сигнал отправляется при вызове соответствующего ему метода. Программисту при этом
нужно только указать прототип метода в разделе signals.
Слот является методом, исполняемым при получении сигнала. Слоты могут объявляться в
разделе pulic slots, protected slots или private slots. При этом уровень защиты влияет
лишь на возможность вызова слотов в качестве обычных методов, но не на возможность
подключения сигналов к слотам.
Модель сигналов и слотов отличается от модели событий и обработчиков тем, что слот
может подключаться к любому числу сигналов, а сигнал может подключаться к любому
числу слотов. При отправке сигнала будут вызваны все подключенные к нему слоты
(порядок вызовов не определен).
5.4.1. Объявление сигналов и слотов, отправка сигналов
В качестве типичного примера слота рассмотрим метод получения свойства (getter). Методу
установки свойства (setter) при этом будет соответствовать сигнал.
Листинг 3.1. Класс MyClass со слотом void setValue (int x) и сигналом void
valueChanged (int x)
// myclass.h
#include <QObject>
class MyClass : public QObject
{
Q_OBJECT
public:
MyClass(int x, QObject *parent = 0);
int value() const;
public slots:
void setValue (int x);
signals:
void valueChanged (int x);
private:
int x_;
};
Обратите внимание на макрос Q_OBJECT, сигнализирующий Qt о том, что используются
возможности системы метаобъектов.
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 17 из 34
developerWorks®
ibm.com/developerWorks/ru/
Листинг 3.2. Реализация методов класса MyClass со слотом void setValue
(int x) и сигналом void valueChanged (int x)
// myclass.cpp
#include <QObject>
#include "myclass.h"
MyClass::MyClass (int x, QObject *parent)
: QObject(parent)
{
setValue (x);
}
int MyClass::value() const
{
return x_;
}
void MyClass::setValue (int x)
{
if (x_ == x) return;
x_ = x;
emit valueChanged (x);
}
Ключевое слово 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.
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 18 из 34
ibm.com/developerWorks/ru/
developerWorks®
5.4.2. Подключение сигнала к слоту
Листинг 3.3. Подключение сигнала void MyClass::valueChanged (int x) к
слоту void MyClass::setValue (int x)
// main.cpp
#include <QObject>
#include <QtDebug>
#include "myclass.h"
int main()
{
MyClass a(1);
MyClass b(2);
QObject::connect
(
&a, SIGNAL(valueChanged(int)),
&b, SLOT(setValue(int))
);
a.setValue (3);
qDebug() << "a:" << a.value(); // 3
qDebug() << "b:" << b.value(); // 3
return 0;
}
Здесь при помощи 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>
#include <QtDebug>
#include "slots.h"
int main()
{
MyClass a(0);
MyClass b(1);
MyClass c(2);
QObject::connect
(
&a, SIGNAL(valueChanged(int)),
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 19 из 34
developerWorks®
ibm.com/developerWorks/ru/
&b, SLOT(setValue(int))
);
QObject::connect
(
&b, SIGNAL(valueChanged(int)),
&c, SLOT(setValue(int))
);
QObject::connect
(
&c, SIGNAL(valueChanged(int)),
&a, SLOT(setValue(int))
);
a.setValue (3);
qDebug() << "a:" << a.value(); // 3
qDebug() << "b:" << b.value(); // 3
qDebug() << "c:" << c.value(); // 3
return 0;
}
возвращает true, если соединение успешно установлено, и false в
противном случае – например, когда сигнал или слот не обнаружен, либо их сигнатуры
несовместимы.
QObject::connect
Если добавить при помощи QObject::connect одинаковые соединения, то слот будет
вызываться несколько раз.
5.4.3. Отключение
Для отключения сигнала от слота используется 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:
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 20 из 34
ibm.com/developerWorks/ru/
developerWorks®
// Отключить всё от сигналов,
отправляемых объектом 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 автоматически удаляет само соединение.
5.4.4. Ограничения
У компилятора метаобъектов имеется ряд ограничений, которые распространяются и на
работу с сигналами и слотами.
1. 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.
2. Типы должны быть указаны полностью, так как QObject::connect() сравнивает их
буквально. В частности, если внутри класса Foo определяется перечисление Bar, то в
аргументах сигнала нужно указывать Foo::Bar:
class Foo : public QObject
{
Q_OBJECT
enum Bar { a, b, c };
signals:
void somethingHappened (Foo::Bar x);
};
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 21 из 34
developerWorks®
ibm.com/developerWorks/ru/
3. В качестве параметров сигналов и слотов нельзя использовать указатели на функции.
Например,
int (*fun)(int)
не является допустимым аргументом. Можно использовать typedef:
typedef int (*fun)(int);
Обычно вместо указателей лучше применять наследование и виртуальные функции.
4. Вложенные классы не могут содержать сигналы и слоты.
5. Сигналы и слоты, возвращающие ссылки, обрабатываются таким образом, как если бы
они возвращали void.
6. В разделах signals и slots могут объявляться только сигналы и слоты.
5.5. Свойства
Класс, наследующий QObject, может содержать объявление свойства при помощи макроса
Q_PROPERTY():
Q_PROPERTY(type
name
READgetFunction
[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;
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 22 из 34
ibm.com/developerWorks/ru/
developerWorks®
Методы могут быть виртуальными либо унаследованными от базового класса. При
множественном наследовании они должны принадлежать первому классу в списке.
Для не обязательных атрибутов 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);
возвращает значение свойства либо неправильный вариантQVariant, если
такого свойства нет.
property()
возвращает true, если у объекта есть указанное свойство с типом,
совместимым с переданным значением. В противном случае возвращается false.
setProperty()
Если в классе нет указанного свойства, то добавляется динамическое свойство объекта.
Перечень динамических свойств можно получить при помощи
QList<QByteArray> QObject::dynamicPropertyNames() const;
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 23 из 34
developerWorks®
ibm.com/developerWorks/ru/
Рассмотрим пример использования свойств. Пусть класс MyClass имеет строковое свойство
text (типа QString):
Листинг 4.1. Объявление класса MyClass со свойством text
// myclass.h
#include <QObject>
#include <QString>
class MyClass : public QObject
{
Q_OBJECT
Q_PROPERTY(QString text READ text WRITE setText)
public:
MyClass(QString text, QObject *parent = 0);
QString text() const;
void setText(const QString& text);
private:
QString text_;
};
Листинг 4.2. Определение методов класса MyClass со свойством text
// myclass.cpp
#include <QObject>
#include <QString>
#include "myclass.h"
MyClass::MyClass(QString text, QObject *parent) :
QObject(parent)
{
setText(text);
}
QString MyClass::text() const
{
return text_;
}
void MyClass::setText(const QString& text)
{
text_ = text;
}
Работа со свойством:
Листинг 4.3. Работа со свойством text объекта MyClass
// main.cpp
#include <QByteArray>
#include <QList>
#include <QListIterator>
#include <QString>
#include <QtDebug>
#include <QVariant>
#include "myclass.h"
int main()
{
MyClass str("foo");
qDebug() << "text :" << str.text();
// Через метод:
str.setText("bar");
qDebug() << "text :" << str.text();
// Через setProperty() / property():
str.setProperty("text", QVariant("baz"));
QVariant prop = str.property("text");
qDebug() << "text :" << prop.toString();
// Добавление динамического свойства:
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 24 из 34
ibm.com/developerWorks/ru/
developerWorks®
str.setProperty("foo", QVariant("bob"));
str.setProperty("bar", QVariant("slack"));
QList<QByteArray> d_props =
str.dynamicPropertyNames();
QListIterator<QByteArray> iter
(d_props);
// (Контейнеры и итераторы мы
еще рассмотрим отдельно)
while (iter.hasNext())
{
const char* d_prop_name = iter.next().data();
QVariant d_prop = str.property(d_prop_name);
qDebug() << "[Dynamic]" <<
d_prop_name << ':' << d_prop.toString();
}
return 0;
}
Программа должна вывести на экран следующее:
text : "foo"
text : "bar"
text : "baz"
[Dynamic] foo : "bob"
[Dynamic] bar : "slack"
Разумеется, безопаснее и быстрее вызывать методы конкретного класса для считывания и
записи свойств. property() и setProperty() нужны в том случае, когда о классе ничего не
известно кроме имен и типов свойств.
Если для класса не известен даже перечень свойств и методов, можно использовать
метаобъект.
5.6. Работа с метаобъектами
Метаобъект возвращается методом
QObject::metaObject()
С его помощью можно динамически получить информацию о классе, как, например, в Java
Reflecion API (EN).
5.6.1. Основная информация
Имя класса возвращает
const char * QMetaObject::className() const;
Указатель на метаобъект базового класса –
const QMetaObject* superClass() const;
5.6.2. Методы
Через систему метаобъектов доступны только те методы и конструкторы, перед
объявлениями которых указан макрос Q_INVOKABLE:
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 25 из 34
developerWorks®
ibm.com/developerWorks/ru/
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:
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 26 из 34
ibm.com/developerWorks/ru/
developerWorks®
Листинг 5. Вывод конструкторов QObject через систему метаобъектов
#include <QMetaMethod>
#include <QMetaObject>
#include <QObject>
#include <QtDebug>
int main()
{
QObject obj;
const QMetaObject* m_obj = obj.metaObject();
for (int i = 0; i < m_obj->constructorCount(); i++)
{
qDebug() << m_obj->constructor(i).signature();
}
return 0;
}
Результат:
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);
Это текстовое приведение к каноническому виду, используемое, в частности, при проверке
совместимости сигнала и слота.
5.6.3. Свойства
Аналогично можно работать со свойствами.
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 27 из 34
developerWorks®
ibm.com/developerWorks/ru/
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;
5.6.4. Перечисления
Перечисления регистрируются в классе при помощи макроса 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
};
// ...
};
Флаги используются следующим образом:
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 28 из 34
ibm.com/developerWorks/ru/
developerWorks®
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;
5.6.5. CLASSINFO
При помощи макроса Q_CLASSINFO() к метаобъекту можно добавлять пары имя–значение.
Например,
Листинг 7.1. Класс MyClass с CLASSINFO
class MyClass
{
Q_OBJECT
Q_CLASSINFO("author", "Bob Dobbs")
Q_CLASSINFO("version", "0.23")
// ...
};
Эти пары наследуются, и их можно получить из метаобъекта по той же схеме:
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 29 из 34
developerWorks®
ibm.com/developerWorks/ru/
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;
5.6.6. Вызов конструкторов и методов
Передача аргументов осуществляется через объекты 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 аргументов.
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 30 из 34
ibm.com/developerWorks/ru/
developerWorks®
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:
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 31 из 34
developerWorks®
ibm.com/developerWorks/ru/
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<MyClass*>
(m_foo->newInstance(Q_ARG(QString,"bar")));
if (!bar)
{
qCritical() << "Can't invoke constructor!";
}
else
{
bar->setParent(&foo);
qDebug() << bar->text(); // "bar"
}
// Вызвать метод:
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 32 из 34
ibm.com/developerWorks/ru/
developerWorks®
if (!QMetaObject::invokeMethod
(&foo, "setText", Q_ARG(QString,"baz")))
qCritical() << "Can't invoke method!";
QString val;
// Вызвать метод и получить возвращенное значение:
if (!QMetaObject::invokeMethod
(&foo, "text", Q_RETURN_ARG(QString, val)))
qCritical() << "Can't invoke method!";
qDebug() << val; // "baz"
text() и setText() вызываются таким образом лишь в качестве простого примера работы с
QMetaObject::invokeMethod(). Как вы уже знаете, эти два метода должны быть связаны со
свойством.
Также обратите внимание, что text() возвращает QString, но не const QString&. Иначе бы
система метаобъектов считала, что text() возвращает void.
Заключение
Для эффективной работы с классами на стадии выполнения Qt использует специальную
объектную модель, в которой при помощи наследования от QObject и генерирования кода
компилятором метаобъектов реализованы:
•
•
•
•
•
иерархии объектов;
специальный аналог dynamic_cast, не зависящий от RTTI;
система сигналов и слотов;
система свойств объектов;
динамическая работа с классами.
В следующей статье мы рассмотрим типы, варианты, ссылки и разделение данных.
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 33 из 34
developerWorks®
ibm.com/developerWorks/ru/
Об авторе
Алексей Бешенов
Алексей Бешенов --- независимый разработчик и технический
писатель, работающий со свободным программным обеспечением и
свободными технологиями. Интересуется функциональным и логическим
программированием, занимается математикой и теоретической информатикой.
© Copyright IBM Corporation 2009
(www.ibm.com/legal/copytrade.shtml)
Торговые марки
(www.ibm.com/developerworks/ru/ibm/trademarks/)
Программирование с Qt: Часть 1. Введение. Инструменты
разработчика и объектная модель
Страница 34 из 34