Getting Started on the Commandline/uk: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
(Decode HTML entity names)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Cleanup | reason=Auto-imported from ExpressionEngine.}}
{{Cleanup | reason=Auto-imported from ExpressionEngine.}}


[toc align_right="yes" depth="3"]


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


p=. [[Image:http://doc.qt.nokia.com/4.7/images/gs1.png|http://doc.qt.nokia.com/4.7/images/gs1.png]]
[[Image:http://doc.qt.io/qt-4.8/images/gs1.png|http://doc.qt.io/qt-4.8/images/gs1.png]]


Код програми:
Код програми:
Line 19: Line 18:
#include <QTextEdit>
#include <QTextEdit>


int main(int argc, char *'''argv)
int main(int argc, char **argv)
{
{
  QApplication app(argc, argv);
  QApplication app(argc, argv);
Line 30: Line 29:
</code>
</code>


p. Давайте переглянемо код рядок за рядком. В перших двох рядках ми підключаємо файли заголовків для [http://doc.qt.nokia.com/4.7/qapplication.html QApplication] та [http://doc.qt.nokia.com/4.7/qtextedit.html QTextEdit], двох класів, що потрібні для цього прикладу. Усі класи Qt мають файл заголовків, названий так само як і клас.
Давайте переглянемо код рядок за рядком. В перших двох рядках ми підключаємо файли заголовків для [http://doc.qt.io/qt-4.8/qapplication.html QApplication] та [http://doc.qt.io/qt-4.8/qtextedit.html QTextEdit], двох класів, що потрібні для цього прикладу. Усі класи Qt мають файл заголовків, названий так само як і клас.


p. В рядку 6 створюється об'єкт [http://doc.qt.nokia.com/4.7/qapplication.html QApplication]. Цей об'єкт керує ресурсами програми і має бути запущений в будь-який програмі Qt, що має ГІК. Йому передаються <code>argc</code> та <code>argv</code>, оскільки Qt обробляє деякі параметри командного рядка.
В рядку 6 створюється об'єкт [http://doc.qt.io/qt-4.8/qapplication.html QApplication]. Цей об'єкт керує ресурсами програми і має бути запущений в будь-який програмі Qt, що має ГІК. Йому передаються '''argc''' та '''argv''', оскільки Qt обробляє деякі параметри командного рядка.


p. В рядку 8 створюється об'єкт [http://doc.qt.nokia.com/4.7/qtextedit.html QTextEdit]. Текстовий редактор є візуальним елементом ГІК. Ми називаємо такі елементи віджетами в Qt. Прикладами інших віджетів є панелі прокрутки, мітки та перемикачі. Віджет також може бути контейнером для інших віджетів, як, наприклад, діалог або головне вікно програми.
В рядку 8 створюється об'єкт [http://doc.qt.io/qt-4.8/qtextedit.html QTextEdit]. Текстовий редактор є візуальним елементом ГІК. Ми називаємо такі елементи віджетами в Qt. Прикладами інших віджетів є панелі прокрутки, мітки та перемикачі. Віджет також може бути контейнером для інших віджетів, як, наприклад, діалог або головне вікно програми.


p. В рядку 9 текстовий редактор відображується на екрані у його власному вікні. Оскільки віджети також функціонують як контейнери (наприклад, [http://doc.qt.nokia.com/4.7/qmainwindow.html QMainWindow], який має панелі інструментів, меню, рядок статусу та декілька інших віджетів), то можна відобразити один віджет у його власному вікні. Віджети не відображаються за замовчанням; функція [http://doc.qt.nokia.com/4.7/qwidget.html#show show()] робить віджет видимим.
В рядку 9 текстовий редактор відображується на екрані у його власному вікні. Оскільки віджети також функціонують як контейнери (наприклад, [http://doc.qt.io/qt-4.8/qmainwindow.html QMainWindow], який має панелі інструментів, меню, рядок статусу та декілька інших віджетів), то можна відобразити один віджет у його власному вікні. Віджети не відображаються за замовчанням; функція [http://doc.qt.io/qt-4.8/qwidget.html#show show()] робить віджет видимим.


p. В рядку 11 відбувається вхід до циклу подій [http://doc.qt.nokia.com/4.7/qapplication.html QApplication]. Коли програма Qt виконується, генеруються події, що доставляються до віджетів програми. Прикладами подій є натискання на кнопки миші та клавіші клавіатури. Коли ви набираєте текст в віджеті текстового редактора, він отримує події натискання клавіш та реагує промальовуванням тексту, що набирається.
В рядку 11 відбувається вхід до циклу подій [http://doc.qt.io/qt-4.8/qapplication.html QApplication]. Коли програма Qt виконується, генеруються події, що доставляються до віджетів програми. Прикладами подій є натискання на кнопки миші та клавіші клавіатури. Коли ви набираєте текст в віджеті текстового редактора, він отримує події натискання клавіш та реагує промальовуванням тексту, що набирається.


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


<code>
<code>
Line 48: Line 47:
</code>
</code>


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


=== Дізнайтесь більше ===
=== Дізнайтесь більше ===
table{border:1px solid lightgray}.
table{border:1px solid lightgray}.
{background:lightgray }. |''. Про |''. Тут |
{background:lightgray }. |''. Про |''. Тут |
|Віджети та геометрія вікна|'''[http://doc.qt.nokia.com/4.7/application-windows.html'''| Віджети вікна та діалогу]
|Віджети та геометрія вікна|'''[http://doc.qt.io/qt-4.8/application-windows.html'''| Віджети вікна та діалогу]
|Події та обробка подій|'''[http://doc.qt.nokia.com/4.7/eventsandfilters.html'''| Система подій]
|Події та обробка подій|'''[http://doc.qt.io/qt-4.8/eventsandfilters.html'''| Система подій]


== Додаємо кнопку виходу ==
== Додаємо кнопку виходу ==
p. В справжній програмі вам, зазвичай, буде потрібен більше ніж один віджет. Зараз ми додамо [http://doc.qt.nokia.com/4.7/qpushbutton.html QPushButton] нижче текстового редактора. Кнопка буде здійснювати вихід з програми Нотатник, коли на неї будуть натискати (наприклад, клацнуть мишею).
В справжній програмі вам, зазвичай, буде потрібен більше ніж один віджет. Зараз ми додамо [http://doc.qt.io/qt-4.8/qpushbutton.html QPushButton] нижче текстового редактора. Кнопка буде здійснювати вихід з програми Нотатник, коли на неї будуть натискати (наприклад, клацнуть мишею).


p=. [[Image:http://doc.qt.nokia.com/4.7/images/gs2.png|http://doc.qt.nokia.com/4.7/images/gs2.png]]
[[Image:http://doc.qt.io/qt-4.8/images/gs2.png|http://doc.qt.io/qt-4.8/images/gs2.png]]


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


<code>
<code>
Line 88: Line 87:
</code>
</code>


p. Рядок 1 включає [http://doc.qt.nokia.com/4.7/qtgui.html QtGui], який містить усі класи ГІК Qt.
Рядок 1 включає [http://doc.qt.io/qt-4.8/qtgui.html QtGui], який містить усі класи ГІК Qt.


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


p. [http://doc.qt.nokia.com/4.7/qcoreapplication.html#quit quit()] є слотом [http://doc.qt.nokia.com/4.7/qapplication.html QApplication], який завершує програму. [http://doc.qt.nokia.com/4.7/qabstractbutton.html#clicked clicked()] є сигналом, який [http://doc.qt.nokia.com/4.7/qpushbutton.html QPushButton] видає, коли натискається. Статична функція [http://doc.qt.nokia.com/4.7/qobject.html#connect QObject::connect]() піклується про з'єднання слота із сигналом. SIGNAL() та SLOT() - це два макроси, що приймають сигнатури функцій сигналу та слота, що з'єднуються. Також ми повинні передати вказівники на об'єкти, що мають надіслати та отримати сигнал.
[http://doc.qt.io/qt-4.8/qcoreapplication.html#quit quit()] є слотом [http://doc.qt.io/qt-4.8/qapplication.html QApplication], який завершує програму. [http://doc.qt.io/qt-4.8/qabstractbutton.html#clicked clicked()] є сигналом, який [http://doc.qt.io/qt-4.8/qpushbutton.html QPushButton] видає, коли натискається. Статична функція [http://doc.qt.io/qt-4.8/qobject.html#connect QObject::connect]() піклується про з'єднання слота із сигналом. SIGNAL() та SLOT() - це два макроси, що приймають сигнатури функцій сигналу та слота, що з'єднуються. Також ми повинні передати вказівники на об'єкти, що мають надіслати та отримати сигнал.


p. В рядку 12 створюється [http://doc.qt.nokia.com/4.7/qvboxlayout.html QVBoxLayout]. Як вже згадувалось, віджети можуть містити інші віджети. Можна встановити границі (розташування та розмір) дочірніх віджетів безпосередньо, однак, зазвичай легше використати компонувальник. Компонувальник керує границями дочірніх віджетів. Наприклад, [http://doc.qt.nokia.com/4.7/qvboxlayout.html QVBoxLayout] розташовує дітей у вертикальному рядку.
В рядку 12 створюється [http://doc.qt.io/qt-4.8/qvboxlayout.html QVBoxLayout]. Як вже згадувалось, віджети можуть містити інші віджети. Можна встановити границі (розташування та розмір) дочірніх віджетів безпосередньо, однак, зазвичай легше використати компонувальник. Компонувальник керує границями дочірніх віджетів. Наприклад, [http://doc.qt.io/qt-4.8/qvboxlayout.html QVBoxLayout] розташовує дітей у вертикальному рядку.


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


=== Дізнайтесь більше ===
=== Дізнайтесь більше ===
table{border:1px solid lightgray}.
table{border:1px solid lightgray}.
{background:lightgray }. |''. Про |''. Тут |
{background:lightgray }. |''. Про |''. Тут |
|Сигнали та слоти|'''[http://doc.qt.nokia.com/4.7/signalsandslots.html*| Сигнали та слоти]
|Сигнали та слоти|'''[http://doc.qt.io/qt-4.8/signalsandslots.html*| Сигнали та слоти]
|Компонування|'''[http://doc.qt.nokia.com/4.7/layout.html Управління компонуванням]''', '''[http://doc.qt.nokia.com/4.7/widgets-and-layouts.html Віджети та компонування]''', '''[http://doc.qt.nokia.com/4.7/examples-layouts.html'''| Приклади компонування]
|Компонування|'''[http://doc.qt.io/qt-4.8/layout.html Управління компонуванням]''', '''[http://doc.qt.io/qt-4.8/widgets-and-layouts.html Віджети та компонування]''', '''[http://doc.qt.io/qt-4.8/examples-layouts.html'''| Приклади компонування]
|Віджети, що входять до Qt|'''[http://doc.qt.nokia.com/4.7/gallery.html Галерея віджетів Qt]''', '''[http://doc.qt.nokia.com/4.7/examples-widgets.html'''| Приклади віджетів]
|Віджети, що входять до Qt|'''[http://doc.qt.io/qt-4.8/gallery.html Галерея віджетів Qt]''', '''[http://doc.qt.io/qt-4.8/examples-widgets.html'''| Приклади віджетів]


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


Коли користувач бажає завершити програму, ви можете хотіти відобразити діалог, в якому запитаєте чи дійсно він хоче вийти. В цьому прикладі ми успадкуємось від [http://doc.qt.nokia.com/4.7/qwidget.html QWidget] та додамо слот, який під'єднаємо до '''кнопки Вихід'''.
Коли користувач бажає завершити програму, ви можете хотіти відобразити діалог, в якому запитаєте чи дійсно він хоче вийти. В цьому прикладі ми успадкуємось від [http://doc.qt.io/qt-4.8/qwidget.html QWidget] та додамо слот, який під'єднаємо до '''кнопки Вихід'''.


p=. [[Image:http://doc.qt.nokia.com/4.7/images/gs3.png|http://doc.qt.nokia.com/4.7/images/gs3.png]]
[[Image:http://doc.qt.io/qt-4.8/images/gs3.png|http://doc.qt.io/qt-4.8/images/gs3.png]]


Давайте поглянемо на код:
Давайте поглянемо на код:
Line 130: Line 129:
</code>
</code>


Макрос <code>Q_OBJECT</code> повинен бути першим у визначенні класу, він оголошує наш клас як <code>QObject</code> (звичайно, він повинен бути успадкованим від [http://doc.qt.nokia.com/4.7/qobject.html QObject]). [http://doc.qt.nokia.com/4.7/qobject.html QObject] додає декілька особливостей до звичайного класу C++. Найважливішим є те, що назва класу та імена слотів можуть бути отримані під час виконання. Також є можливість дізнатись типи параметрів слоту та викликати його.
Макрос '''Q_OBJECT''' повинен бути першим у визначенні класу, він оголошує наш клас як '''QObject''' (звичайно, він повинен бути успадкованим від [http://doc.qt.io/qt-4.8/qobject.html QObject]). [http://doc.qt.io/qt-4.8/qobject.html QObject] додає декілька особливостей до звичайного класу C++. Найважливішим є те, що назва класу та імена слотів можуть бути отримані під час виконання. Також є можливість дізнатись типи параметрів слоту та викликати його.


В рядку 13 оголошено слот <code>quit()</code>. Це легко зробити завдяки макросу <code>slots</code>. Слот <code>quit()</code> тепер може бути під'єднаним до сигналів з відповідними сигнатурами (будь-який сигнал, що не приймає параметрів).
В рядку 13 оголошено слот '''quit()'''. Це легко зробити завдяки макросу '''slots'''. Слот '''quit()''' тепер може бути під'єднаним до сигналів з відповідними сигнатурами (будь-який сигнал, що не приймає параметрів).


Замість того, щоб встановлювати ГІК та під'єднувати слот в функції <code>main()</code>, тепер ми використаємо конструктор <code>Notepad</code>.
Замість того, щоб встановлювати ГІК та під'єднувати слот в функції '''main()''', тепер ми використаємо конструктор '''Notepad'''.


<code>
<code>
Line 144: Line 143:
connect(quitButton, SIGNAL (clicked()), this, SLOT (quit()));
connect(quitButton, SIGNAL (clicked()), this, SLOT (quit()));


QVBoxLayout '''layout = new QVBoxLayout;
QVBoxLayout *layout = new QVBoxLayout;
  layout->addWidget(textEdit);
  layout->addWidget(textEdit);
  layout->addWidget(quitButton);
  layout->addWidget(quitButton);
Line 154: Line 153:
</code>
</code>


p. Як видно у визначенні класу, ми використовуємо вказівники на наші [http://doc.qt.nokia.com/4.7/qobject.htmls'и QObject] (<code>textEdit</code> та <code>quitButton</code>). Як правило, вам завжди слід виділяти [http://doc.qt.nokia.com/4.7/qobject.htmls'и QObject] в купі та ніколи не копіювати їх.
Як видно у визначенні класу, ми використовуємо вказівники на наші [http://doc.qt.io/qt-4.8/qobject.htmls'и QObject] ('''textEdit''' та '''quitButton'''). Як правило, вам завжди слід виділяти [http://doc.qt.io/qt-4.8/qobject.htmls'и QObject] в купі та ніколи не копіювати їх.


p. Тепер ми використовуємо функцію [http://doc.qt.nokia.com/4.7/qobject.html#tr tr()] навколо рядків, що відображаються користувачу. Ця функція необхідна, якщо ви хочете надавати вашу програму більше ніж однією мовою (наприклад, англійською та китайською). Ми не будемо розглядати деталі тут, однак ви можете перейти за посиланням з таблиці "Дізнайтесь більше" до <code>Qt Linguist</code>.
Тепер ми використовуємо функцію [http://doc.qt.io/qt-4.8/qobject.html#tr tr()] навколо рядків, що відображаються користувачу. Ця функція необхідна, якщо ви хочете надавати вашу програму більше ніж однією мовою (наприклад, англійською та китайською). Ми не будемо розглядати деталі тут, однак ви можете перейти за посиланням з таблиці "Дізнайтесь більше" до '''Qt Linguist'''.


=== Дізнайтесь більше ===
=== Дізнайтесь більше ===
table{border:1px solid lightgray}.
table{border:1px solid lightgray}.
{background:lightgray }. |''. Про |''. Тут |
{background:lightgray }. |''. Про |''. Тут |
|tr() та інтернаціоналізація|'''[http://doc.qt.nokia.com/4.7/linguist-manual.html* Посібник з Qt Linguist], '''[http://doc.qt.nokia.com/4.7/i18n-source-translation.html Написання коду для перекладу]''', Приклад '''[http://doc.qt.nokia.com/4.7/linguist-hellotr.html Привіт tr]'''(), '''[http://doc.qt.nokia.com/4.7/internationalization.html'''| Інтернаціоналізація з Qt]
|tr() та інтернаціоналізація|'''[http://doc.qt.io/qt-4.8/linguist-manual.html* Посібник з Qt Linguist], '''[http://doc.qt.io/qt-4.8/i18n-source-translation.html Написання коду для перекладу]''', Приклад '''[http://doc.qt.io/qt-4.8/linguist-hellotr.html Привіт tr]'''(), '''[http://doc.qt.io/qt-4.8/internationalization.html'''| Інтернаціоналізація з Qt]
|[http://doc.qt.nokia.com/4.7/qtwebkit-bridge.html#qobjects'и QObject] та об'єктна модель Qt (Це необхідний матеріал, щоб зрозуміти Qt)|'''[http://doc.qt.nokia.com/4.7/object.html'''| Об'єктна модель]
|[http://doc.qt.io/qt-4.8/qtwebkit-bridge.html#qobjects'и QObject] та об'єктна модель Qt (Це необхідний матеріал, щоб зрозуміти Qt)|'''[http://doc.qt.io/qt-4.8/object.html'''| Об'єктна модель]
|qmake та система збірки Qt|'''[http://doc.qt.nokia.com/4.7/qmake-manual.html'''| Посібник з qmake]
|qmake та система збірки Qt|'''[http://doc.qt.io/qt-4.8/qmake-manual.html'''| Посібник з qmake]


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


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


<code>
<code>
Line 183: Line 182:
== Використання QMainWindow ==
== Використання QMainWindow ==


Багато програм отримають переваги від використання [http://doc.qt.nokia.com/4.7/qmainwindow.html QMainWindow], який має своє власне компонування, до якого ви можете додавати панель меню, віджети, що прикріплюються, панелі інструментів та рядок статусу. [http://doc.qt.nokia.com/4.7/qmainwindow.html QMainWindow] має центральну область, що може бути зайнята віджетом довільного типу. В нашому випадку ми розташуємо там текстовий редактор.
Багато програм отримають переваги від використання [http://doc.qt.io/qt-4.8/qmainwindow.html QMainWindow], який має своє власне компонування, до якого ви можете додавати панель меню, віджети, що прикріплюються, панелі інструментів та рядок статусу. [http://doc.qt.io/qt-4.8/qmainwindow.html QMainWindow] має центральну область, що може бути зайнята віджетом довільного типу. В нашому випадку ми розташуємо там текстовий редактор.


p=. [[Image:http://doc.qt.nokia.com/4.7/images/gs4.png|http://doc.qt.nokia.com/4.7/images/gs4.png]]
[[Image:http://doc.qt.io/qt-4.8/images/gs4.png|http://doc.qt.io/qt-4.8/images/gs4.png]]


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


<code>
<code>
#include <QtGui>
#include <QtGui>
class Notepad : public QMainWindow
class Notepad : public QMainWindow
{
{
Line 205: Line 204:
  QAction *saveAction;
  QAction *saveAction;
  QAction *exitAction;
  QAction *exitAction;
  QMenu '''fileMenu;
  QMenu *fileMenu;
};
};
</code>
</code>


p. Ми включили ще два слоти, які можуть зберігати та відкривати документ. Ми реалізуємо їх в наступній частині.
Ми включили ще два слоти, які можуть зберігати та відкривати документ. Ми реалізуємо їх в наступній частині.


p. Доволі часто в головному вікні один і той самий слот може бути викликаний декількома різними віджетами. Прикладами є пункти меню та кнопки на панелі інструментів. Щоб полегшити це, Qt надає [http://doc.qt.nokia.com/4.7/qaction.html QAction] (дія), який може бути переданий декільком віджетам та під'єднаний до слота. Наприклад, як [http://doc.qt.nokia.com/4.7/qmenu.html QMenu] так і [http://doc.qt.nokia.com/4.7/qtoolbar.html QToolBar] можуть створювати пункти меню та кнопки на панелі з одного й того ж [http://doc.qt.nokia.com/4.7/qaction.htmls QAction]. Ми скоро побачимо, як це працює.
Доволі часто в головному вікні один і той самий слот може бути викликаний декількома різними віджетами. Прикладами є пункти меню та кнопки на панелі інструментів. Щоб полегшити це, Qt надає [http://doc.qt.io/qt-4.8/qaction.html QAction] (дія), який може бути переданий декільком віджетам та під'єднаний до слота. Наприклад, як [http://doc.qt.io/qt-4.8/qmenu.html QMenu] так і [http://doc.qt.io/qt-4.8/qtoolbar.html QToolBar] можуть створювати пункти меню та кнопки на панелі з одного й того ж [http://doc.qt.io/qt-4.8/qaction.htmls QAction]. Ми скоро побачимо, як це працює.


p. Як і раніше ми використовуємо конструктор <code>Notepad</code> для встановлення ГІК.
Як і раніше ми використовуємо конструктор '''Notepad''' для встановлення ГІК.


<code>
<code>
Line 239: Line 238:
</code>
</code>


p. [http://doc.qt.nokia.com/4.7/qaction.htmls'и QAction] створюються з текстом, що має з'явитись на віджетах, до яких ми їх додаємо (в нашому випадку це пункти меню). Якщо б ми також хотіли додати їх до панелі інструментів, ми б могли призначити до них [http://doc.qt.nokia.com/4.7/qicon.html піктограми].
[http://doc.qt.io/qt-4.8/qaction.htmls'и QAction] створюються з текстом, що має з'явитись на віджетах, до яких ми їх додаємо (в нашому випадку це пункти меню). Якщо б ми також хотіли додати їх до панелі інструментів, ми б могли призначити до них [http://doc.qt.io/qt-4.8/qicon.html піктограми].


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


=== Дізнайтесь більше ===
=== Дізнайтесь більше ===
table{border:1px solid lightgray}.
table{border:1px solid lightgray}.
{background:lightgray }. |''. Про |''. Тут |
{background:lightgray }. |''. Про |''. Тут |
|Головні вікна та класи головного вікна||'''[http://doc.qt.nokia.com/4.7/mainwindow.html* Головне вікно програми], '''[http://doc.qt.nokia.com/4.7/examples-mainwindow.html'''| Приклади головного вікна]
|Головні вікна та класи головного вікна||'''[http://doc.qt.io/qt-4.8/mainwindow.html* Головне вікно програми], '''[http://doc.qt.io/qt-4.8/examples-mainwindow.html'''| Приклади головного вікна]
|Програми з MDI|'''[http://doc.qt.nokia.com/4.7/qmdiarea.html QMdiArea]''', '''[http://doc.qt.nokia.com/4.7/mainwindows-mdi.html'''| Приклад MDI]
|Програми з MDI|'''[http://doc.qt.io/qt-4.8/qmdiarea.html QMdiArea]''', '''[http://doc.qt.io/qt-4.8/mainwindows-mdi.html'''| Приклад MDI]


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


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


p=. [[Image:http://doc.qt.nokia.com/4.7/images/gs5.png|http://doc.qt.nokia.com/4.7/images/gs5.png]]
[[Image:http://doc.qt.io/qt-4.8/images/gs5.png|http://doc.qt.io/qt-4.8/images/gs5.png]]


Ми почнемо зі слоту <code>open()</code>:
Ми почнемо зі слоту '''open()''':


<code>
<code>
QString fileName = QFileDialog::getOpenFileName(this, tr("Open File"), "",
QString fileName = QFileDialog::getOpenFileName(this, tr("Open File"), "",
  tr("Text Files ('''.txt);;C++ Files ('''.cpp '''.h)"));
  tr("Text Files (*.txt);;C++ Files (*.cpp *.h)"));


if (fileName != "") {
if (fileName != "") {
Line 274: Line 273:
</code>
</code>


p. На першому кроці ми запитаємо у користувача ім'я файлу для відкриття. В Qt є [http://doc.qt.nokia.com/4.7/qfiledialog.html QFileDialog] - діалог, з якого користувач може вибрати файл. На зображенні вище показано цей діалог в Kubuntu. Статична функція [http://doc.qt.nokia.com/4.7/qfiledialog.html#getOpenFileName getOpenFileName()] відображує модальний файловий діалог, а повернення з неї не відбувається, доки користувач не вибере файл. Вона повертає шлях до обраного файлу або порожній рядок, якщо користувач скасував діалог.
На першому кроці ми запитаємо у користувача ім'я файлу для відкриття. В Qt є [http://doc.qt.io/qt-4.8/qfiledialog.html QFileDialog] - діалог, з якого користувач може вибрати файл. На зображенні вище показано цей діалог в Kubuntu. Статична функція [http://doc.qt.io/qt-4.8/qfiledialog.html#getOpenFileName getOpenFileName()] відображує модальний файловий діалог, а повернення з неї не відбувається, доки користувач не вибере файл. Вона повертає шлях до обраного файлу або порожній рядок, якщо користувач скасував діалог.


p. Якщо в нас є ім'я файлу, ми намагаємось відкрити файл за допомогою функції [http://doc.qt.nokia.com/4.7/qiodevice.html#open open()], яка повертає істинне значення, якщо файл вдалось відкрити. Ми не будемо тут заглиблюватись в обробку помилок, але ви можете перейти за посиланням з частини "Дізнайтесь більше". Якщо файл не вдалось відкрити, ми використовуємо [http://doc.qt.nokia.com/4.7/qmessagebox.html QMessageBox], щоб відобразити діалог з повідомленням про помилку (див. опис класу [http://doc.qt.nokia.com/4.7/qmessagebox.html QMessageBox] для деталей).
Якщо в нас є ім'я файлу, ми намагаємось відкрити файл за допомогою функції [http://doc.qt.io/qt-4.8/qiodevice.html#open open()], яка повертає істинне значення, якщо файл вдалось відкрити. Ми не будемо тут заглиблюватись в обробку помилок, але ви можете перейти за посиланням з частини "Дізнайтесь більше". Якщо файл не вдалось відкрити, ми використовуємо [http://doc.qt.io/qt-4.8/qmessagebox.html QMessageBox], щоб відобразити діалог з повідомленням про помилку (див. опис класу [http://doc.qt.io/qt-4.8/qmessagebox.html QMessageBox] для деталей).


p. Реальне читання даних є доволі тривіальним з використанням функції [http://doc.qt.nokia.com/4.7/qiodevice.html#readAll readAll()], яка повертає усі дані з файлу в [http://doc.qt.nokia.com/4.7/qbytearray.html QByteArray]. Метод [http://doc.qt.nokia.com/4.7/qbytearray.html#constData constData()] повертає усі дані з масиву як const char''', для якого у [http://doc.qt.nokia.com/4.7/qstring.html QString] є конструктор. Зміст в подальшому може бути відображено в текстовому редакторі. Потім ми закриваємо файл функцією [http://doc.qt.nokia.com/4.7/qiodevice.html#close close()], щоб повернути файловий дескриптор назад операційній системі.
Реальне читання даних є доволі тривіальним з використанням функції [http://doc.qt.io/qt-4.8/qiodevice.html#readAll readAll()], яка повертає усі дані з файлу в [http://doc.qt.io/qt-4.8/qbytearray.html QByteArray]. Метод [http://doc.qt.io/qt-4.8/qbytearray.html#constData constData()] повертає усі дані з масиву як const char*, для якого у [http://doc.qt.io/qt-4.8/qstring.html QString] є конструктор. Зміст в подальшому може бути відображено в текстовому редакторі. Потім ми закриваємо файл функцією [http://doc.qt.io/qt-4.8/qiodevice.html#close close()], щоб повернути файловий дескриптор назад операційній системі.


Тепер, давайте перейдемо до слота <code>save()</code>.
Тепер, давайте перейдемо до слота '''save()'''.


<code>
<code>
QString fileName = QFileDialog::getSaveFileName(this, tr("Save File"), "",
QString fileName = QFileDialog::getSaveFileName(this, tr("Save File"), "",
  tr("Text Files ('''.txt);;C++ Files ('''.cpp '''.h)"));
  tr("Text Files (*.txt);;C++ Files (*.cpp *.h)"));


if (fileName != "") {
if (fileName != "") {
Line 299: Line 298:
</code>
</code>


p. Коли ми записуємо зміст текстового редактора до файлу, ми використовуємо клас [http://doc.qt.nokia.com/4.7/qtextstream.html QTextStream], який обгортає об'єкт [http://doc.qt.nokia.com/4.7/qfile.html QFile]. Текстовий потік може записувати QString'и безпосередньо до файлу; [http://doc.qt.nokia.com/4.7/qfile.html QFile] приймає лише сирі дані (char''') за допомогою функцій [http://doc.qt.nokia.com/4.7/qiodevice.html#write write()] класу [http://doc.qt.nokia.com/4.7/qiodevice.html QIODevice].
Коли ми записуємо зміст текстового редактора до файлу, ми використовуємо клас [http://doc.qt.io/qt-4.8/qtextstream.html QTextStream], який обгортає об'єкт [http://doc.qt.io/qt-4.8/qfile.html QFile]. Текстовий потік може записувати QString'и безпосередньо до файлу; [http://doc.qt.io/qt-4.8/qfile.html QFile] приймає лише сирі дані (char*) за допомогою функцій [http://doc.qt.io/qt-4.8/qiodevice.html#write write()] класу [http://doc.qt.io/qt-4.8/qiodevice.html QIODevice].


=== Дізнайтесь більше ===
=== Дізнайтесь більше ===
Line 305: Line 304:
table{border:1px solid lightgray}.
table{border:1px solid lightgray}.
{background:lightgray }. |''. Про |''. Тут |
{background:lightgray }. |''. Про |''. Тут |
|Файли та пристрої I/O|'''[http://doc.qt.nokia.com/4.7/qfile.html QFile]''', '''[http://doc.qt.nokia.com/4.7/qiodevice.html'''| QIODevice]
|Файли та пристрої I/O|'''[http://doc.qt.io/qt-4.8/qfile.html QFile]''', '''[http://doc.qt.io/qt-4.8/qiodevice.html'''| QIODevice]

Latest revision as of 10:18, 27 February 2017

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, що має ГІК.

http://doc.qt.io/qt-4.8/images/gs1.png

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

#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 нижче текстового редактора. Кнопка буде здійснювати вихід з програми Нотатник, коли на неї будуть натискати (наприклад, клацнуть мишею).

http://doc.qt.io/qt-4.8/images/gs2.png

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

#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 та додамо слот, який під'єднаємо до кнопки Вихід.

http://doc.qt.io/qt-4.8/images/gs3.png

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

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

http://doc.qt.io/qt-4.8/images/gs4.png

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

http://doc.qt.io/qt-4.8/images/gs5.png

Ми почнемо зі слоту 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