1. #include "mydialog.h"
2. MyDialog::MyDialog(QWidget *parent) : QDialog(parent) {
3. QVBoxLayout *layout = new QVBoxLayout(this );
4. QLabel *label = new QLabel(this );
5. label->setText("Hello, World!" );
6. QPushButton *button = new QPushButton(this );
7. button->setText("Close" );
8. layout->addWidget(label);
9. layout->addWidget(button);
10. connect(button, SIGNAL(clicked()), this , SLOT(close()));

* This source code was highlighted with Source Code Highlighter .

1. #include
2. #include "mydialog.h"
3. int main(int argc, char * argv) {
4. QApplication app(argc, argv);
5. MyDialog *dialog = new MyDialog;
6. dialog->show();
7. return app.exec();

* This source code was highlighted with Source Code Highlighter .

$ qmake -project

Что бы новые файлы автоматически в него добавились и компилируем его. Вот так выглядит наша новая программа:

Третья программа

И выбираем создание диалогового окна без кнопок. Добавляем на него метку и кнопку, редактируем их текст. С помощью инструмента редактора сигналов и слотов (Signal/Slot Editor) подключаем сигнал нажатия clicked() кнопки button к слоту close() диалогового окна. Располагаем их вертикально с помощью менеджера компоновки. Сохраняем полученный файл под именем mydialog.ui. Позже он будет автоматически преобразован в заголовочный файл с именем ui_mydialog.h.
Изменяем заголовочный файл нашего диалогового окна mydialog.h следующим образом:

tl;dr — Qt библиотека для создания кроссплатформенных оконных приложений на C++.

Qt, как проект, зародился из желания разработчиков C++ иметь удобный инструментарий разработки графических интерфейсов программ (GUI). Если, например, в Java для этих целей из коробки идет AWT, а в Python Tk, то в С++ не было ничего подобного. И не только того что касается разработки GUI, а так же классов работы с сетью, мультимедиа и прочих очень востребованных вещей. Чему очень досадовали разработчики. Ну а раз есть спрос, то предложение не заставило себя долго ждать. В 1995 году вышел первый релиз библиотеки. С тех пор Qt быстро стал расширяться за пределы всего-лишь разработки интерфейсов.

Поэтому, Qt стоит рассматривать не столько набор классов для создания GUI, а скорее как полноценный инструментарий классов на все случаи жизни. Этот набор всего (ну или почти всего) что может потребоваться программисту-прикладнику для создания практически любого приложения. Структура библиотеки логично разбита на компоненты, их очень много и с каждой новой версией Qt в них становится все больше и больше полезных классов.

Основных компонента два — QtCore являющий собой ядро библиотеки и QtGui представляющий компоненты графического интерфейса. Как мы в дальнейшем увидим, создаваемый проект всегда имеет при себе два этих компонента (за исключение консольных приложений, в которых обязательную роль играет QtCore).

Ну а далее, в зависимости от потребностей, разработчики вольны использовать все что душе угодно. QtNetwork для работы с сетью, написать свой Torrent-клиент. QtMultimedia для реализации видео-аудио плеера. QtWebEngine для встраивания в свое приложение полноценного браузерного движка. И многое другое.

Стоит так же отметить, что заявленная кроссплатформенность действительно присутствует. Вы можете взять свой код разрабатываемый на одной системе (Windows, MinGW) и скомпилировать ее компилятором другой системы (Linux, GCC) и получить бинарный файл способный запускаться там без особых хлопот. Как показала практика, особые хлопоты начинаются когда приложение становится сильно обвешенным сторонними библиотеками.

Приятным бонусом для веб-разработчиков станет возможность разрабатывать программы не только на C++, но и языке QML, сильно схожим с JavaScript. Это особая ветка развития Qt, направленная на быстрое прототипирование и разработку мобильных приложений.

Ну и конечно же, одной из изюминок Qt является среда разработки Qt Creator. Универсальная и очень удобная среда разработки на Qt, не перегруженная лишним функционалом, .

Программирование с Qt

Часть 1. Введение. Инструменты разработчика и объектная модель

Серия контента:

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 или другой совместимой графической подсистемы.

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-opensource-src-4.x.y.tar.gz , где 4.x.y – последняя доступная версия из стабильных. Мы будем устанавливать версию 4.5.0.

В директории с файлом qt-x11-opensource-src-4.5.0.tar.gz выполните следующие команды:

Прежде чем собирать Qt, запустите скрипт configure . Полный набор его опций выдается по команде./configure -help , но обычно можно использовать типовые настройки.

Параметр -prefix задает каталог для установки (по умолчанию используется /usr/local/Trolltech/Qt-4.5.0). Также имеются ключи для инсталляции различных компонентов (исполняемых файлов, библиотек, документации, и т.д.) в разные директории.

При запуске скрипт требует подтвердить согласие пользователя с условиями лицензии GPL / LGPL. После выполнения

можно запустить сборку и установку при помощи команд:

Имейте в виду, что компиляция занимает много времени, а для установки Qt могут потребоваться права суперпользователя (файлы записываются в /usr/local/).

Если в дальнейшем вам понадобится в той же директории заново сконфигурировать и пересобрать Qt, удалите все следы предыдущей конфигурации при помощи make confclean , прежде чем снова запускать./configure .

Путь к исполняемым файлам Qt нужно добавить в переменную окружения PATH. В оболочках bash, ksh, zsh и sh это можно сделать, дописав в файл ~/.profile следующие строки:

В csh и tcsh нужно дописать в ~/.login строку:

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

Кроме того, необходимо добавить строку /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 и запустите мастер установки:

Если не собираетесь устанавливать SDK в домашнюю директорию, то запускайте инсталлятор с правами суперпользователя.

3. Инструменты разработчика

В состав 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 – экранная лупа.

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() поместим в hello.cpp:

Листинг 1.2. Реализации функций программы «Hello, World!»

Здесь 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!»

Чтобы создать файл проекта, запустите

После этого должен появиться файл 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 – директории с заголовочными файлами.

После запуска

на основе 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 .

Для навигации в редакторе применяется комбинация клавиш Ctrl+K . После ее нажатия нужно указать один из префиксов:

Таблица 1. Префиксы для навигации в Qt Creator

После префикса нажмите пробел и введите соответствующую информацию. Например, для перехода на строку 93 текущего файла нужно напечатать " l 93 " (то же самое можно сделать при помощи Ctrl+L), для перехода к документации по теме qobject_cast – "? qobject_cast" и т.д.

В нижней части окна при этом отображается поле с автоматическим дополнением.

Рисунок 5. Поле для навигации в Qt Creator

Таблица 2. Комбинации клавиш для редактора Qt Creator

Во встроенном редакторе реализовано «умное» дополнение кода, вызываемое комбинацией клавиш Ctrl+<Пробел> . База символов составляется на основе заголовочных файлов проекта из INCLUDEPATH .

Для чтения документации в 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), т.е. нужно использовать:

Поэтому в дальнейшем мы не будем отдельно оговаривать, где объявлен тот или иной класс.

Методы для получения и установки свойств (getter и setter ) именуются следующим образом: свойство fooBar можно получить при помощи метода fooBar() и установить при помощи setFooBar() .

При разработке собственных приложений на Qt стоит придерживаться этого стиля.

5. Объектная модель

Для эффективной работы с классами на стадии выполнения в Qt используется специальная объектная модель, расширяющая модель C++. В частности, добавляются следующие возможности:

• древовидные иерархии объектов;
• аналог dynamic_cast для библиотеки, не использующий RTTI;
• взаимодействие объектов через сигналы и слоты ;
• свойства объектов.

Многие объекты определяются значением сразу нескольких свойств, внутренними состояниями и связями с другими объектами. Они представляют собой индивидуальные сущности, и для них не имеет смысла операция буквального копирования, а также разделение данных в памяти. В Qt эти объекты наследуют свойства QObject .

В тех случаях, когда объект требовалось бы рассматривать не как сущность, а как значение (например, при хранении в контейнере) – используются указатели. Иногда указатель на объект, наследуемый от QObject , называют просто объектом.

Инструментарий спроектирован так, что для QObject и всех его потомков конструктор копирования и оператор присваивания недоступны – они объявлены в разделе private через макрос Q_DISABLE_COPY() :

Будьте внимательны и не используйте конструкцию

Foo bar = Foo (baz);

Другие объекты (например, контейнеры и строки) полностью определяются представляемыми данными, поэтому в соответствующих классах имеются операция присваивания и конструктор копирования. Кроме того, объекты, представляющие одинаковые данные, могут прозрачно для программиста разделять их в памяти.

5.1. Система метаобъектов

Часть расширений реализована стандартными методами 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:

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:

Динамическое приведение иллюстрирует следующий код:

Эти операции сработают корректно на стадии выполнения.

Как и в случае с dynamic_cast , результат приведения можно проверить:

Система метаобъектов позволяет также проверить, наследует ли a класс MyClass1:

Однако предпочтителен предыдущий вариант с qobject_cast .

5.3. Деревья объектов

Объекты классов, наследующих от QObject , могут быть организованы в древовидную структуру. При удалении объекта Qt удаляет его дочерние объекты , которые в свою очередь удаляют свои дочерние объекты, и т.д. Иными словами, удаление объекта приводит к удалению всего поддерева, корнем которого он является.

Пусть у нас имеются классы ClassA и ClassB:

Листинг 2.1. Объявление MyClass для программы, демонстрирующей порядок создания и удаления объектов

Листинг 2.2. Определение методов MyClass для программы, демонстрирующей порядок создания и удаления объектов

Здесь родительский объект устанавливается в конструкторе 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 в стеке

Если создать B в куче и назначить его дочерним объектом для A, то вместе с A автоматически удалится B:

Листинг 2.4. Создание экземпляра A класса MyClass в стеке, а экземпляра B – в куче, как дочернего для A

Аналогично для более сложных деревьев:

Рисунок 8. Пример многоуровневого дерева объектов

Листинг 2.5. Многоуровневое дерево объектов с корнем в стеке

После удаления A удалится всё дерево.

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

Если объект и его дочерние объекты созданы в стеке, то подобный порядок удаления может привести к ошибкам.

Здесь при выходе из области действия сначала будет удален объект A, так как он был создан последним. При этом Qt удалит и его дочерний объект B. Но потом будет сделана попытка удаления B, что приведет к ошибке.

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

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

У каждого QObject есть свойство objectName , для доступа к которому используются методы

По умолчанию 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();

– выводит отладочную информацию о дереве объектов с данным корнем.

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)

Обратите внимание на макрос Q_OBJECT , сигнализирующий Qt о том, что используются возможности системы метаобъектов.

Листинг 3.2. Реализация методов класса MyClass со слотом void setValue (int x) и сигналом void valueChanged (int 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 .

5.4.2. Подключение сигнала к слоту

Листинг 3.3. Подключение сигнала void MyClass::valueChanged (int x) к слоту void MyClass::setValue (int x)

Здесь при помощи 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)

QObject::connect возвращает true , если соединение успешно установлено, и false в противном случае – например, когда сигнал или слот не обнаружен, либо их сигнатуры несовместимы.

Если добавить при помощи QObject::connect одинаковые соединения, то слот будет вызываться несколько раз.

5.4.3. Отключение

Для отключения сигнала от слота используется QObject::disconnect:

При успешном отключении возвращается 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 автоматически удаляет само соединение.

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 .

Типы должны быть указаны полностью, так как QObject::connect() сравнивает их буквально. В частности, если внутри класса Foo определяется перечисление Bar , то в аргументах сигнала нужно указывать Foo::Bar:

class Foo: public QObject { Q_OBJECT enum Bar { a, b, c }; signals: void somethingHappened (Foo::Bar x); };

2. В качестве параметров сигналов и слотов нельзя использовать указатели на функции. Например,

   int (*fun)(int)

   не является допустимым аргументом. Можно использовать typedef:

   typedef int (*fun)(int);

   Обычно вместо указателей лучше применять наследование и виртуальные функции.

3. Вложенные классы не могут содержать сигналы и слоты.
4. Сигналы и слоты, возвращающие ссылки, обрабатываются таким образом, как если бы они возвращали void .
5. В разделах signals и slots могут объявляться только сигналы и слоты.

5.5. Свойства

Класс, наследующий QObject , может содержать объявление свойства при помощи макроса Q_PROPERTY() :

Q_PROPERTY(type name

READ getFunction

Обязательные параметры макроса:

• 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:

Для считывания и записи свойства используются методы:

property() возвращает значение свойства либо неправильный вариант QVariant , если такого свойства нет.

setProperty() возвращает true , если у объекта есть указанное свойство с типом, совместимым с переданным значением. В противном случае возвращается false .

Если в классе нет указанного свойства, то добавляется динамическое свойство объекта. Перечень динамических свойств можно получить при помощи

Рассмотрим пример использования свойств. Пусть класс MyClass имеет строковое свойство text (типа QString):

Листинг 4.1. Объявление класса MyClass со свойством text

Листинг 4.2. Определение методов класса MyClass со свойством text

Работа со свойством:

Листинг 4.3. Работа со свойством text объекта MyClass

Программа должна вывести на экран следующее:

Разумеется, безопаснее и быстрее вызывать методы конкретного класса для считывания и записи свойств. 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:

Для доступа к методам (в том числе сигналам и слотам) используйте

Методы и свойства класса проиндексированы. Доступ к методу по индексу осуществляется через QMetaObject::method() .

Общее число методов, с учетом наследованных, возвращает QMetaObject::methodCount() . Смещение методов класса возвращается QMetaObject::methodOffset() , оно показывает, с какого индекса начинаются методы данного класса. Смещение увеличивается при наследовании и показывает число методов базовых классов.

Пример прохода по методам:

Если бы мы начали с индекса 0, то получили бы методы всех базовых классов, в том числе QObject:

Методы, начинающиеся с _q_ , используются внутри Qt и не являются частью API.

Конструкторы указываются отдельно:

Например, получим перечень конструкторов QObject:

Листинг 5. Вывод конструкторов QObject через систему метаобъектов

Результат:

Индекс метода, сигнала, слота или конструктора можно получить по его сигнатуре:

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

Например,

возвращает " int*foo(QString,QObject*) ".

Аналогично работает

Это текстовое приведение к каноническому виду, используемое, в частности, при проверке совместимости сигнала и слота.

5.6.3. Свойства

Аналогично можно работать со свойствами.

(Если просмотреть все свойства, включая наследованные, то вы увидите, по меньшей мере, objectName из QObject .)

Индекс свойства можно получить по его имени:

5.6.4. Перечисления

Перечисления регистрируются в классе при помощи макроса Q_ENUMS() .

Перечисление, значения которого можно комбинировать при помощи побитового ИЛИ, называется флагом и должно регистрироваться при помощи Q_FLAGS() .

Листинг 6.1. Класс MyClass с перечислением Type и флагом Mode

Флаги используются следующим образом:

Динамическая работа с перечислениями:

Листинг 6.2. Вывод перечислений и флагов MyClass через систему метаобъектов

Результат работы:

Индекс перечисления можно получить по его имени:

5.6.5. CLASSINFO

При помощи макроса Q_CLASSINFO() к метаобъекту можно добавлять пары имя–значение. Например,

Листинг 7.1. Класс MyClass с CLASSINFO

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

Для примера выше:

Листинг 7.2. Вывод CLASSINFO класса MyClass

Результат:

Не была бы тем чем она является без того, что называется proof-of-concept . И в данном случае роль этого доказательства играет Qt Creator — среда разработки под Qt с открытым исходным кодом, написанная полностью на ней самой.

Qt Creator может показать изумительно аскетичной IDE, особенно после работы и программирования в чем-либо другом. Между тем, среда содержит все необходимое для работы и является довольно продуманной. Qt Creator поставляется в пакете вместе с самой библиотекой Qt. . Выбирайте способ (онлайн, оффлайн), платформу и вперед (Примечание: описанный способ может измениться в будущем, но в любом случае — скачивайте дистрибутив библиотеки только с официального сайта ). Установка является довольно простой и особых сюрпризов не несет.

Кстати, под Linux и Mac OS X существует также вариант установки через репозитарий вашего дистрибутива (через brew в Mac OS X или apt в Ubuntu), но в этом случае вы рискуете получить не самую свежую версию библиотеки.

После скачивания и установки остается запустить Qt Creator и начать разрабатывать.

Среда имеет три темы (тема Flat появилась в 4.0) интерфейса и несколько вариантов расцветки синтаксиса кода. При желании цвета синтаксиса можно изменить на любые другие. Как и генеральный цвет IDE.

Плюсом для начинающих знакомство с Qt станет встроенная коллекция примеров на любую тему. Выбираем пункт Начало , кликаем по кнопке Примеры , и выбираем интересующий. Qt Creator предложит сразу же подготовить пример для последующей сборки и запуска. Это очень удобно и позволяет вживую посмотреть на возможности Qt.

Примеры очень хорошо помогут после некоторого времени ознакомления со средой и Qt. Основная фишка Qt Creator — встроенная справка, позволяющая не выходя из среды получать информацию о любом классе и его методах и свойствах. Достаточно встать на имя класса или экземпляре и нажать F1. Сбоку появится окно справки, аналогичное документации с https://doc.qt.io/ — главного справочного портала Qt.

Если нет желания делить рабочее пространство с справочным окном и хочется вдумчивого чтения, можно кликнуть по кнопке Справка в левом сайдбаре. Вкладка Проекты позволяет настроить некоторые этапы сборки и запуска проекта, Отладка переключает среду в соответствующий режим, кнопка Дизайн становится активной при редактировании.ui файлов интерфейса. В окне Редактор происходит главное действо — написание кода. Со всем этим мы разберемся позже.

В нижней левой части экрана расположены манящие нажать кнопки создания билда, отладочного запуска и запуска приложения. А так же режим сборки — Отладка, Релиз и Профилирование.

Наигравшись вдоволь со средой можно переходить к созданию своего собственного проекта.

Начинающий программист постоянно сомневается, какие технологии начать осваивать эту или какую-нибудь другую. Нужно ли начинающему программисту изучать Qt? Однозначно, нужно! Например, почитайте этот пост или поищите что-нибудь в интернете. Всё ещё не уверены нужен ли Вам Qt? Если Вы пишите на С++, Qt вы должны знать, у Вас просто нет другой альтернативы.

Итак, поехали...

Давайте, для примера, напишем простенький калькулятор - сложение двух чисел.

Создаём новый проект. Как мы видем, существует несколько типов приложений. Мы как начинающие, выбираем "Приложение Qt Widgets":

Указываем имя проекта и папку для размещения файлов, у меня: C:\projects\qt

Qt автоматически генерирует следующие файлы:

• lesson1.pro - файл проекта
• main.cpp - главный файл с фукнцией main()
• mainwindow.cpp - исходный код главного окна
• mainwindow.h - заголовочный файл главного окна
• mainwindow.ui - файл формы главного окна

Нажимаем кнопку "Завершить" - открывается редактор для разработки программ на Qt.

Пока должно быть всё понятно для начинающего Qt-разработчика...

Открываем главную форму (для этого переходим в mainwindow.ui).

Слева располагаются компоненты для создания экранной формы, справа сама форма, она пустая. Накидаем нужные компонентики, незабудем поля ввода QLineEdit назвать так: edtA, edtB и edtC соответственно.

Мы видем на экране поля ввода, подписи к ним слева и кнопку "A + B =". При нажатии на эту кнопку мы должны сложить A и B и поместить результат в C.

Как быть? Любой начинающий Qt-разработчик предположит, что нужно навесить на кнопку обработчик нажатия этой кнопки и он будет прав! В любых других фреймворках есть такое понятие как событие . Но в Qt решили выпендриться и придумали сигналы/слоты. Хотя, по сути, это, практически, тоже самое.

Кликаем правой кнопкой мыши на кнопку "A + B =", открывается всплывающее меню:

жмём на "Перейти к слоту"

Выбираем сигнал clicked() , и в открывшемся редакторе кода пишем небольшой программный код на Qt:

Void MainWindow::on_btnOK_clicked() { int a = ui->edtA->text().toInt(); // Берем текст edtA и преобразовываем его в число a int b = ui->edtB->text().toInt(); // Берем текст edtB и преобразовываем его в число b int c = a + b; // Складываем числа QString s = QString::number(c); // Преобразуем результат в строковый вид ui->edtC->setText(s); // Вывести результат в edtC }

Функция обработки сигнала clicked() называется слотом on_btnOK_clicked().

Для начинающих

Охлаждающая подставка для ноутбука своими руками Как самому сделать охлаждающую подставку

Программамы

Не двигается курсор мыши, но мышь работает

Устройство ПК

Как пользоваться программой unlocker