GettingStartedQtRussian
Начало работы с 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.
Давайте взглянем на код:
Макрос 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] есть центральная область где можно разместить любой виджет. В нашем случае мы разместим там наш текстовый редактор.
Давайте взглянем на новое определение класса 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(), которые были добавлены в предыдущем примере.
Начнем со слота 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].
Дополнительная информация
| Тема | Статья |
| Файлы и устройства ввода-вывода |