Getting Started on the Commandline/uk

This article may require cleanup to meet the Qt Wiki's quality standards. Reason: Auto-imported from ExpressionEngine. Please improve this article if you can. Remove the {{cleanup}} tag and add this page to Updated pages list after it's clean.

Перші кроки з Qt

Ласкаво просимо до світу Qt — крос-платформного набору інструментів для ГІК (графічного інтерфейсу користувача). В цьому посібнику з перших кроків ми отримаємо базові знання з Qt, реалізовуючи просту програму Нотатник. Після прочитання цього посібника ви маєте бути готові зануритись до наших оглядів та документації з API та знайти потрібну вам інформацію для програми, що ви розробляєте.

Привіт, Нотатник

В цьому першому прикладі ми просто створимо та відобразимо текстовий редактор у вікні на стільниці. Це буде найпростіша можлива програма Qt, що має ГІК.

Код програми:

#include <QApplication>
#include <QTextEdit>

int main(int argc, char **argv)
{
 QApplication app(argc, argv);

 QTextEdit textEdit;
 textEdit.show();

 return app.exec();
}

Давайте переглянемо код рядок за рядком. В перших двох рядках ми підключаємо файли заголовків для QApplication та QTextEdit, двох класів, що потрібні для цього прикладу. Усі класи Qt мають файл заголовків, названий так само як і клас.

В рядку 6 створюється об'єкт QApplication. Цей об'єкт керує ресурсами програми і має бути запущений в будь-який програмі Qt, що має ГІК. Йому передаються argc та argv, оскільки Qt обробляє деякі параметри командного рядка.

В рядку 8 створюється об'єкт QTextEdit. Текстовий редактор є візуальним елементом ГІК. Ми називаємо такі елементи віджетами в Qt. Прикладами інших віджетів є панелі прокрутки, мітки та перемикачі. Віджет також може бути контейнером для інших віджетів, як, наприклад, діалог або головне вікно програми.

В рядку 9 текстовий редактор відображується на екрані у його власному вікні. Оскільки віджети також функціонують як контейнери (наприклад, QMainWindow, який має панелі інструментів, меню, рядок статусу та декілька інших віджетів), то можна відобразити один віджет у його власному вікні. Віджети не відображаються за замовчанням; функція show() робить віджет видимим.

В рядку 11 відбувається вхід до циклу подій QApplication. Коли програма Qt виконується, генеруються події, що доставляються до віджетів програми. Прикладами подій є натискання на кнопки миші та клавіші клавіатури. Коли ви набираєте текст в віджеті текстового редактора, він отримує події натискання клавіш та реагує промальовуванням тексту, що набирається.

Щоб запустити програму, відкрийте командний рядок та перейдіть до теки, в якій знаходиться файл .cpp програми. Наступні команди оболонки зберуть програму.

qmake -project
qmake
make

При цьому виконуваний модуль з'явиться в теці part1 (майте на увазі, що у Windows вам, можливо, потрібно буде використовувати nmake замість make. Також, виконуваний модуль буде розміщено в part1/debug або part1/release). qmake - це інструмент збірки з Qt, який використовує конфігураційний файл. qmake генерує його для нас, коли запускається з аргументом -project. Коли конфігураційний файл (із суфіксом .pro) існує, qmake створює файл збірки, який збирає для вас програму. Ми розглянемо написання власних файлів .pro пізніше.

Дізнайтесь більше

table{border:1px solid lightgray}. {background:lightgray }. |. Про |. Тут | |Віджети та геометрія вікна|| Віджети вікна та діалогу |Події та обробка подій|| Система подій

Додаємо кнопку виходу

В справжній програмі вам, зазвичай, буде потрібен більше ніж один віджет. Зараз ми додамо QPushButton нижче текстового редактора. Кнопка буде здійснювати вихід з програми Нотатник, коли на неї будуть натискати (наприклад, клацнуть мишею).

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

#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();
}

Рядок 1 включає QtGui, який містить усі класи ГІК Qt.

В рядку 10 використовується механізм сигналів та слотів Qt, щоб завершити програму, коли натискається кнопка Вихід. Слот- це функція, що може бути викликана під час виконання програми за допомогою її назви (як рядкового літералу). Сигналом є функція, яка під час свого виклику, виконає слоти зареєстровані до неї; ми називаємо це "під'єднати слот до сигналу та видати сигнал".

quit() є слотом QApplication, який завершує програму. clicked() є сигналом, який QPushButton видає, коли натискається. Статична функція QObject::connect() піклується про з'єднання слота із сигналом. SIGNAL() та SLOT() - це два макроси, що приймають сигнатури функцій сигналу та слота, що з'єднуються. Також ми повинні передати вказівники на об'єкти, що мають надіслати та отримати сигнал.

В рядку 12 створюється QVBoxLayout. Як вже згадувалось, віджети можуть містити інші віджети. Можна встановити границі (розташування та розмір) дочірніх віджетів безпосередньо, однак, зазвичай легше використати компонувальник. Компонувальник керує границями дочірніх віджетів. Наприклад, QVBoxLayout розташовує дітей у вертикальному рядку.

Рядки 13 та 14 додають текстовий редактор до компонувальника. В рядку 17 ми встановлюємо конмпонувальник на віджет.

Дізнайтесь більше

table{border:1px solid lightgray}. {background:lightgray }. |. Про |. Тут | |Сигнали та слоти|Сигнали та слоти |Компонування|Управління компонуванням, Віджети та компонування, | Приклади компонування |Віджети, що входять до Qt|Галерея віджетів Qt, | Приклади віджетів

Успадкування від QWidget

Коли користувач бажає завершити програму, ви можете хотіти відобразити діалог, в якому запитаєте чи дійсно він хоче вийти. В цьому прикладі ми успадкуємось від 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. Слот quit() тепер може бути під'єднаним до сигналів з відповідними сигнатурами (будь-який сигнал, що не приймає параметрів).

Замість того, щоб встановлювати ГІК та під'єднувати слот в функції 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 в купі та ніколи не копіювати їх.

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

Дізнайтесь більше

table{border:1px solid lightgray}. {background:lightgray }. |. Про |. Тут | |tr() та інтернаціоналізація|Посібник з Qt Linguist, Написання коду для перекладу, Приклад Привіт tr(), | Інтернаціоналізація з Qt |QObject та об'єктна модель Qt (Це необхідний матеріал, щоб зрозуміти Qt)|| Об'єктна модель |qmake та система збірки Qt|| Посібник з qmake

Створення файлу .pro

Для цього прикладу ми напишемо наш власний файл .pro замість використання qmake з опцією -project.

HEADERS = notepad.h
SOURCES = notepad.cpp  main.cpp

Наступні команди оболонки збирають приклад.

qmake
make

Використання QMainWindow

Багато програм отримають переваги від використання QMainWindow, який має своє власне компонування, до якого ви можете додавати панель меню, віджети, що прикріплюються, панелі інструментів та рядок статусу. QMainWindow має центральну область, що може бути зайнята віджетом довільного типу. В нашому випадку ми розташуємо там текстовий редактор.

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

#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()
{
 openAction = 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 створюються з текстом, що має з'явитись на віджетах, до яких ми їх додаємо (в нашому випадку це пункти меню). Якщо б ми також хотіли додати їх до панелі інструментів, ми б могли призначити до них піктограми.

Коли по пункту меню клацнуть, елемент запустить дію і буде викликано відповідний слот.

Дізнайтесь більше

table{border:1px solid lightgray}. {background:lightgray }. |. Про |. Тут | |Головні вікна та класи головного вікна||Головне вікно програми, | Приклади головного вікна |Програми з MDI|QMdiArea, | Приклад MDI

Збереження та завантаження

В цьому прикладі ми реалізуємо функціональність слотів open() та save(), які ми додали в попередньому прикладі.

Ми почнемо зі слоту 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, щоб відобразити діалог з повідомленням про помилку (див. опис класу QMessageBox для деталей).

Реальне читання даних є доволі тривіальним з використанням функції readAll(), яка повертає усі дані з файлу в QByteArray. Метод constData() повертає усі дані з масиву як 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)) {
 // повідомлення про помилку
 } else {
 QTextStream stream(&file);
 stream << textEdit->toPlainText();
 stream.flush();
 file.close();
 }
}

Коли ми записуємо зміст текстового редактора до файлу, ми використовуємо клас QTextStream, який обгортає об'єкт QFile. Текстовий потік може записувати QString'и безпосередньо до файлу; QFile приймає лише сирі дані (char*) за допомогою функцій write() класу QIODevice.

Дізнайтесь більше

table{border:1px solid lightgray}. {background:lightgray }. |. Про |. Тут | |Файли та пристрої I/O|QFile, | QIODevice