GettingStartedWithQtRussian

From Qt Wiki
Jump to: navigation, search

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

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

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

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

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

Исходный код:

  1. include <QApplication>
  2. include <QTextEdit>

int main(int argv, char **args) {

QApplication app(argv, args);

QTextEdit textEdit;

textEdit.show();

return app.exec();; } Давайте рассмотрим каждую строку кода. На первых двух строках мы подключаем заголовочные файлы для QApplication и QTextEdit – двух классов которые потребуются для этого примера. Для каждого класса Qt есть заголовочный файл с соответствующим именем.

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

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

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

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

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

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

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

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

Статья| Window and Dialog Widgets The Event System


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

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

p=. Кнопка выход

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

  1. include <QtGui>

int main(int argv, char **args) {

QApplication app(argv, args);
QTextEdit textEdit;
QPushButton quitButton("Quit");
QObject::connect(&quitButton, SIGNAL (clicked()), qApp, SLOT (quit()));
QVBoxLayout layout;
layout.addWidget(&textEdit);
layout.addWidget(&quitButton);
QWidget window;
window.setLayout(&layout);
window.show();
return app.exec();

}

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

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

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

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

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

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

Статья| Signals & Slots Layout Management, Widgets and Layouts, Layout Examples Qt Widget Gallery, Widget Examples

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

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

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

Давайте взглянем на код: class Notepad : public QWidget {

Q_OBJECT

public:

Notepad();

private slots:

void quit();

private:

QTextEdit *textEdit;
QPushButton *quitButton;

};

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

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

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

textEdit = new QTextEdit;
quitButton = new QPushButton(tr("Quit"));
connect(quitButton, SIGNAL (clicked()), this, SLOT (quit()));
QVBoxLayout layout = new QVBoxLayout;
layout->addWidget(textEdit);
layout->addWidget(quitButton);
setLayout(layout);
setWindowTitle(tr("Notepad"));

}

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

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

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

Статья| Qt Linguist Manual, Writing Source Code for Translation, Hello tr() Example, Internationalization with Qt Object Model qmake Manual

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

Для этого примера мы напишем собственный .pro файл вместо использования опции _qmake -project_. HEADERS = notepad.h SOURCES = notepad.cpp main.cpp

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

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

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

p=. Используем QMainWindow

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

  1. include <QtGui>

class Notepad : public QMainWindow {

Q_OBJECT

public:

Notepad();

private slots:

void open();
void save();
void quit();

private:

QTextEdit *textEdit;
QAction *openAction;
QAction *saveAction;
QAction *exitAction;
QMenu fileMenu;

};

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

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

saveAction = new QAction(tr("&Open"), this);
saveAction = new QAction(tr("&Save"), this);
exitAction = new QAction(tr("E&xit"), this);
connect(openAction, SIGNAL (triggered()), this, SLOT (open()));
connect(saveAction, SIGNAL (triggered()), this, SLOT (save()));
connect(exitAction, SIGNAL (triggered()), qApp, SLOT (quit()));
fileMenu = menuBar()->addMenu(tr("&File"));
fileMenu->addAction(openAction);
fileMenu->addAction(saveAction);
fileMenu->addSeparator();
fileMenu->addAction(exitAction);
textEdit = new QTextEdit;
setCentralWidget(textEdit);
setWindowTitle(tr("Notepad"));

}

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

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

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

Статья| Application Main Window, Main Window Examples QMdiArea, MDI Example

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

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

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

Начнем со слота open(): QString fileName = QFileDialog::getOpenFileName(this, tr("Open File"), "",

tr("Text Files (.txt);;C++ Files (.cpp.h)"));

if (fileName != "") {

QFile file(fileName);
if (!file.open(QIODevice::ReadOnly)) {
QMessageBox::critical(this, tr("Error"),
tr("Could not open file"));
return;
}
QString contents = file.readAll().constData();
textEdit->setPlainText(contents);
file.close();

}

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

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

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

Рассмотрим слот save(): QString fileName = QFileDialog::getSaveFileName(this, tr("Save File"), "",

tr("Text Files (.txt);;C++ Files (.cpp *.h)"));

if (fileName != "") {

QFile file(fileName);
if (!file.open(QIODevice::WriteOnly)) {
// error message
} else {
QTextStream stream(&file);
stream << textEdit->toPlainText();
stream.flush();
file.close();
}

}

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

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

Тема Статья
Файлы и устройства ввода-вывода QFile, QIODevice