GettingStartedWithQtRussian

Начало работы с Qt

Добро пожаловать в мир Qt — кроссплатформенного набора инструментов (toolkit) для разработки графического интерфейса пользователя (GUI). В данном руководстве мы изучим основы Qt, написав простое приложение “Блокнот”. После прочтения этого руководства вы сможете лучше ориентироваться в документации и найти там всю необходимую информацию для разработки своих приложений.

Привет, Блокнот!

В качестве первого примера создадим и отобразим текстовый редактор (QTextEdit [doc.qt.nokia.com]). Это, пожалуй, самая простая программа на Qt с графическим интерфейсом пользователя, которая только может существовать.

Самое простое приложение на Qt

Исходный код:
Давайте рассмотрим каждую строку кода. На первых двух строках мы подключаем заголовочные файлы для QApplication [doc.qt.nokia.com] и QTextEdit [doc.qt.nokia.com] – двух классов которые потребуются для этого примера. Для каждого класса Qt есть заголовочный файл с соответствующим именем.

На строке 6 создается экземпляр QApplication [doc.qt.nokia.com]. Этот объект управляет ресурсами уровня приложения и необходим для запуска любой программы на Qt с графическим интерфейсом. Ему необходимо передать argv и args, так как Qt может принимать некоторые параметры командной строки.

На строке 8 создаётся экземпляр текстового редактора QTextEdit [doc.qt.nokia.com]. Текстовый редактор – это графический элемент интерфейса пользователя. В Qt мы называем такие элементы виджетами. Примерами других виджетов являются полосы прокрутки (scroll bars), метки (labels) и переключатели (radio buttons). Виджет также может быть контейнером для других виджетов, например, диалог или главное окно приложения.

На строке 9 текстовый редактор отображается на экране. Так как виджеты также служат контейнерами (например, QMainWindow [doc.qt.nokia.com], у которого есть панели инструментов (toolbars), меню, строка состояния (status bar) и другие виджеты), то можно показать отдельный виджет как полноценное окно. По умолчанию виджеты скрыты; метод show() [doc.qt.nokia.com] делает их видимыми.

На строке 11 QApplication [doc.qt.nokia.com] входит в цикл событий (eventloop). Во время работы приложения на Qt события генерируются и отправляются виджетам. Примерами событий могут служить нажатия кнопок мыши или ввод с клавиатуры. Когда пользователь вводит текст в текстовый редактор, этот виджет получает события нажатий клавиш и отображает набранный текст на экране.

Чтобы запустить приложение нужно в командной строке перейти в каталог с .cpp-файлом и выполнить следующие команды:

Так как утилита qmake может работать в двух режимах – для создания Makefile или для создания .pro файла, мы должны импользовать ее два раза.

После этого в каталоге появится исполняемый файл (обратите внимание, что в Windows вместо make необходимо выполнить nmake и исполняемый файл будет в подкаталоге debug или release). qmake – это инструмент Qt для сборки приложения, использующий конфигурационный файл, который создается при запуске qmake с ключом -project. Используя заданный конфигурационный файл (файл с расширением .pro), qmake создаёт файл для утилиты make, которая будет собирать ваше приложение. Мы рассмотрим написание собственных .pro файлов позже.

Дополнительная информация

Тема	Статья
Виджеты и геометрия окна	Window and Dialog Widgets [doc.qt.nokia.com]
События и их обработка	The Event System [doc.qt.nokia.com]

Добавление кнопки выхода

В настоящем приложении обычно требуется более одного виджета. Добавим кнопку (QPushButton [doc.qt.nokia.com]) под текстовым редактором. Кнопка будет закрывать Блокнот при нажатии на неё.

Кнопка выход

Давайте взглянем на код.

На первой строке мы включаем QtGui [doc.qt.nokia.com] – заголовочный файл, содержащий все классы графического интерфейса пользователя Qt.

На строке 10 используется механизм сигналов и слотов Qt для выхода из приложения при нажатии кнопки Quit. Слот это функция, которая может быть вызвана во время выполнения программы (runtime) с помощью её имени (в виде строки). Сигнал это функция, которая вызывает связанные с ней слоты; мы называем это подключением слота к сигналу (connect) и отправкой сигнала (emit).

quit() [doc.qt.nokia.com] — это слот QApplication [doc.qt.nokia.com], который закрывает приложение. clicked() [doc.qt.nokia.com] – это сигнал, посылаемый кнопкой (QPushButton [doc.qt.nokia.com]) при нажатии. Статическая функция QObject::connect() [doc.qt.nokia.com] соединяет сигнал со слотом. SIGNAL и SLOT это два макроса, которые принимают сигнатуры соединяемых функций сигнала и слота. Также необходимо передать указатели на соединяемые объекты.

На строке 12 создаётся вертикальный компоновщик (QVBoxLayout [doc.qt.nokia.com]). Как было сказано выше, виджеты могут содержать другие виджеты. Можно явно указать границы (расположение и размер) дочерних виджетов, но удобнее использовать компоновщик (layout). Компоновщик управляет границами дочерних виджетов. QVBoxLayout [doc.qt.nokia.com], например, размещает дочерние виджеты вертикально.

На строках 13 и 14 текстовый редактор и кнопка добавляются в компоновщик. На строке 17 компоновщик устанавливается на виджет.

Дополнительная информация

Тема	Статья
Сигналы и слоты	Signals & Slots [doc.qt.nokia.com]
Компоновки	Layout Management [doc.qt.nokia.com], Widgets and Layouts [doc.qt.nokia.com], Layout Examples [doc.qt.nokia.com]
Виджеты Qt	Qt Widget Gallery [doc.qt.nokia.com], Widget Examples [doc.qt.nokia.com]

Наследование QWidget

Представим, что при выходе пользователя из приложения нам надо показать диалог для подтверждения выхода. В этом примере мы наследуем QWidget [doc.qt.nokia.com] и добавим слот, который соединим с кнопкой выхода Quit.

Наследуемся от QWidget

Давайте взглянем на код:

Макрос Q_OBJECT должен быть первой инструкцией в объявлении класса. Этот макрос объявляет наш класс как QObject [doc.qt.nokia.com] (естественно, класс должен быть унаследован от QObject [doc.qt.nokia.com]). QObject [doc.qt.nokia.com] добавляет несколько возможностей обычным классам C++. Например, имя класса и имена его слотов могут быть запрошены во время выполнения программы. Также можно вызывать слоты и узнавать типы их параметров.

Строка 13 объявляет слот quit(). Для объявления слотов используется макрос slots. Теперь этот слот может быть подключен к сигналам с подходящей сигнатурой (то есть к сигналам без параметров).

Вместо настройки графического интерфейса пользователя и соединения слота в функции main() мы используем конструктор класса Notepad.

Как видно из определения класса, используются указатели на экземпляры QObject [doc.qt.nokia.com] (textEdit и quitButton). Как правило, вы всегда должны создавать наследников QObject [doc.qt.nokia.com] в динамической памяти (heap) и никогда не копировать их.

Также мы используем функцию tr() [doc.qt.nokia.com] для видимых пользователю строк. Эта функция нужна когда приложение должно быть более чем на одном языке (например, на китайском и английском). Мы не будем углубляться в детали, но все подробности можно посмотреть по ссылке о Qt Linguist в дополнительной информации.

Дополнительная информация

Тема	Статья
tr() и интернационализация	Qt Linguist Manual [doc.qt.nokia.com], Writing Source Code for Translation [doc.qt.nokia.com], Hello tr() Example [doc.qt.nokia.com], Internationalization with Qt [doc.qt.nokia.com]
QObject [doc.qt.nokia.com] и объектная модель Qt (необходимо для понимания Qt)	Object Model [doc.qt.nokia.com]
qmake и система сборки Qt	qmake Manual [doc.qt.nokia.com]

Создание .pro файла

Для этого примера мы напишем собственный .pro файл вместо использования опции qmake -project.

Соберем приложение:

Использование QMainWindow

Многие приложения могут выиграть от использования QMainWindow [doc.qt.nokia.com], у которого есть собственный компоновщик куда вы можете добавить меню, прикрепляемые виджеты (dock widgets), панель инструментов (tool bars) и строку состояния (status bar). У QMainWindow [doc.qt.nokia.com] есть центральная область где можно разместить любой виджет. В нашем случае мы разместим там наш текстовый редактор.

Используем QMainWindow

Давайте взглянем на новое определение класса Notepad.

Здесь появились еще два слота для сохранения и загрузки файла. Они будут реализованы в следующем разделе.

Часто в главном окне один и тот же слот должен быть вызван сразу несколькими виджетами. Например, элементами меню и кнопками на панели инструментов. Для упрощения подобных вещей в Qt есть QAction [doc.qt.nokia.com], который может быть использован несколькими виджетами и который может быть соединён со слотом. Например, и QMenu [doc.qt.nokia.com], и QToolBar [doc.qt.nokia.com] могут создавать элементы меню и кнопки инструментов из одного QAction [doc.qt.nokia.com]. Мы скоро увидим как это работает.
Как и ранее, для настройки графического интерфейса пользователя мы используем конструктор Notepad.

Экземпляры QAction [doc.qt.nokia.com] создаются с указанием текста, который будет отображен на виджетах (в нашем случае, на элементах меню). Если мы хотим добавить их на панель инструментов, то нам может потребоваться задать ещё и иконки [doc.qt.nokia.com].

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

Дополнительная информация

Тема	Статья
Главные окна и классы главного окна	Application Main Window [doc.qt.nokia.com], Main Window Examples [doc.qt.nokia.com]
Приложения с многодокументным интерфейсом (MDI)	QMdiArea [doc.qt.nokia.com], MDI Example [doc.qt.nokia.com]

Сохранение и загрузка

В этом примере мы реализуем слоты open() и save(), которые были добавлены в предыдущем примере.

Открытие файла в Kubuntu

Начнем со слота open():

Сначала у пользователя запрашивается имя открываемого файла. В Qt есть класс QFileDialog [doc.qt.nokia.com], который является диалогом выбора файла. Выше показан такой диалог в Kubuntu. Статический метод getOpenFileName() [doc.qt.nokia.com] отображает модальный диалог выбора файла и не завершается, пока пользователь не выберет файл. Он возвращает путь к выбранному файлу или пустую строку, если пользователь отменил диалог.

Если пользователь выбрал файл, то попробуем его открыть с помощью метода open() [doc.qt.nokia.com], который возвращает истину в случае успеха. Мы не будем углубляться в обработку ошибок (подробнее про них можно почитать в дополнительной информации). Если не удалось открыть файл, то отображается диалог QMessageBox [doc.qt.nokia.com] с сообщением об ошибке.

Фактически, чтение данных выполняется с помощью одного метода readAll() [doc.qt.nokia.com], который возвращает все содержимое файла в QByteArray [doc.qt.nokia.com]. Метод constData() [doc.qt.nokia.com] возвращает содержимое QByteArray [doc.qt.nokia.com] в виде const char *, для которого у QString [doc.qt.nokia.com] есть конструктор. Затем содержимое файла отображается в текстовом редакторе. В конце работы вызывается метод close() [doc.qt.nokia.com] который закроет файл и вернет файловый дескриптор операционной системе.

Рассмотрим слот save():

Для записи данных в файл воспользуемся классом QTextStream [doc.qt.nokia.com] (текстовый поток), который в нашем случае будет оберткой над экземпляром QFile [doc.qt.nokia.com]. Текстовый поток может записывать QString [doc.qt.nokia.com] непосредственно в файл; QFile [doc.qt.nokia.com] же принимает лишь сырые данные (char*) или QByteArray [doc.qt.nokia.com] с помощью методов write() [doc.qt.nokia.com] класса-предка QIODevice [doc.qt.nokia.com].

Дополнительная информация

Тема	Статья
Файлы и устройства ввода-вывода	QFile [doc.qt.nokia.com], QIODevice [doc.qt.nokia.com]