「Qt」の版間の差分
(UI) |
(QSettings) |
||
267行目: | 267行目: | ||
エンコーディングはUTF-8。 | エンコーディングはUTF-8。 | ||
== Qt Core == | |||
=== QSettings === | |||
出典: [https://doc.qt.io/qt-6/qsettings.html QSettings Class | Qt Core 6.6.1]。 | |||
アプリ設定の保存のためのクラス。フォームの内容などを、次回のアプリ起動時に維持可能になる。 | |||
まず、引数に著者名、製品名でインスタンスを作成する。 | |||
QSettings settings("MySoft", "Star Runner"); | |||
その後、setValue()でキーバリュー形式で値を保存する。 | |||
settings.setValue("editor/wrapMargin", 68); | |||
保存した値はvalue()で参照できる。 | |||
int margin = settings.value("editor/wrapMargin").toInt(); | |||
値がなければ、nullになる。デフォルト値を第2引数で指定もできる。 |
2024年1月4日 (木) 11:10時点における版
About
参考になる情報源がいくつかある。
- GitHub - PacktPublishing/Mastering-Qt-5: Code repository for Mastering Qt 5 published by Packt
- Mastering Qt5に沿って勉強するページ | taro3.github.io
- examples - qt/qtbase.git - Qt Base (Core, Gui, Widgets, Network, ...): Qtのチュートリアルやサンプルの格納場所。
Mastering Qt5という本があり、それを翻訳している人がいる。
General
License
情報源:
- Qt - Obligations of the GPL and LGPL
- Open Source Development | Open Source License | Qt
- Qt ライセンスについて #Qt - Qiita
- ios - Does App Store accept Qt app linked with QT Library LGPLv3 - Stack Overflow
Qtには3種類のライセンス形態がある。
- 商用: 有償。不自由ソフトの開発用。
- GPLv3: 自由ソフト用。
- LGPLv3: 無償で不自由ソフトの開発に使用可能。ただし、ユーザーにQt部分のライブラリーを置換可能な手順・プロジェクトファイル群の提供が必要で、使用可能なモジュールの制限が多い。Stack Overflowや公式サイト (Open Source Development | Open Source License | Qt) 説明がわかりやすい。
LGPLv3の義務は以下。
Business
OSSライセンスで開発後、商用ライセンスに移行する場合、不可能ではないが条件がある。
まず、Qtの営業に連絡する。商用ライセンスのモジュールは不自由ソフトなので、そこを維持するために、OSS部分を移行する必要があり、以降の支援の業務契約がおそらく必要。そうとう金額がかかるだろう。
Module
ライセンス形態ごとに使用可能なモジュールが変わる (Qt Features, Framework Essentials, Modules, Tools & Add-Ons)。これが個人的には大きい。
2023-12-13 Wed。
GPLv3で使用不能モジュール
- Development Tools
- Qt Quick Compiler Extensions
- Qt Quick Ultralight Compiler
- Qt Quick Ultralight Project Exporter
- Framework Add-Ons
- Qt Digital Advertising
- Active Qt
- Qt WebEngine
- Qt Safe Renderer
- Qt Quick Ultralite Controls
- Qt Quick Ultralite
- Non-automotive MCU Deployment Platforms
- Automotive MCU Deployment Platforms
- Qt Design Studio Bridge
- Qt for Android Automotive OS Car Service API
- Simulink support for Qt Design Studio
- Boot to Qt
- Qt for Python commercial add-ons
LGPLv3で使用不能なもの
- GPLv3で使用不能なもの
- Framework Add-Ons
- Qt Wayland Compositor
- Qt Charts
- Qt Data Visualization
- Qt Network Authorization
- Qt Virtual Keyboard
- Qt Safe Renderer
- In-Vehicle Infotainment Reference UI
- Qt Application Manager
- Qt Device Utilities
- Qt MQTT
- Qt CoAP
- Qt Design Studio Bridge
- Qt Quick Calendar
- Qt Quick TreeView n
- Qt Quick Timeline
- Qt Lottie Animation
- Qt Quick 3D
- Qt HTTP Server
- Qt Quick 3D Physics
- Qt gRPC
- Qt Protobuf
使用不能なモジュールを見る限り、別にLGPLv3でも通常利用には問題ないように感じる。どうせ元々使いたいものはGPLv3でも使用不能だし。
Style
Qtでの開発のコーディング規約が気になったので調べた。
- Member variable naming convention in Qt and the QtDN wiki | Qt Forum
- Qt Coding Style - Qt Wiki
- Coding Conventions - Qt Wiki
- c++ - Qt naming convention for variables and getters so they don't collide? - Stack Overflow
- The Property System | Qt Core 6.6.1
特に特徴的なものを以下に記載する。
- 関数の波括弧のみ次の行。
- メンバー変数はm_のプレフィクスでmixedCase。
Platform
iOS
出典: Qt for iOS | Qt 6.6。
Xcodeが必須。それ以外はソースコードに手を付けなくてもビルドはできる。
Qt Creator
出典: Qt Creator Manual。
Qtの標準IDE。Qtの開発で非常に重要。
Tutorial
出典: Creating a Qt Widget Based Application | Qt Creator Manual。
Other
MacのBackspace
出典: [QTCREATORBUG-26764] Backspace is not working in Mac Qt Creator 6.0.1 - Qt Bug Tracker。
MacのQt Createorだと、Google日本語入力のIMEだとBackspaceやDeleteキーがうまく動作しない模様。
しかたないので、開発作業中だけデフォルトIMEのKotoeriを使う。
Qt Widgets
出典: Qt Widgets 6.6.1。
Qtの原点。昔ながらのC++デスクトップアプリ用のモジュール。古くから存在していて、一番安定している。C++のフル機能を利用できる。Qt Quickも悪くはないが、こちらはモバイルファースト。C++技術者ならC++の勉強のためにもQt Widgetsを使うのがいい。Qt QuickはC++をあまり使わなくて、C++の知識の流用・学習が利かない。
main.cpp
出典: Widgets Tutorial | Qt Widgets 6.6.1。
Qt Widgetを使ったアプリは以下のmain.cppから始まるのが基本。
#include <QtWidgets> // Include header files for application components. // ... int main(int argc, char *argv[]) { QApplication app(argc, argv); // Set up and show widgets. // ... return app.exec(); }
QtのアプリはQObjectクラスを全て継承しており、内部で連携している。
QApplicationでインスタンスを生成したら、それ以後にQObject派生クラスを生成したりすると、内部的に連携しているこれでアプリを作っていく感じになる。
Getting Started Programming with Qt Widgets
出典: Getting Started Programming with Qt Widgets | Qt Widgets 6.6.1。
このチュートリアルが良くできている。この中身を理解できれば、それで基本的なアプリを作れると思う。
signal/slot
slots named on_foo_bar are error prone
Qt Deisgnerで [Go to slot] で自動生成されるslotはon_[widget name]_[signal]() のような命名規則になっている。この命名規則だと自分でconnectで結び付けなくてもいい。ただ、Qt Creatorで以下の警告がでる。
slots named on_foo_bar are error prone [clazy-connect-by-name]
出典:
- qt - How may I fix my error prone on_foo_bar slots - Stack Overflow
- what does 'Slots named on_foo_bar are error prone' mean? | Qt Forum
- clazy/docs/checks/README-connect-by-name.md at master · KDE/clazy · GitHub
- QObject Class | Qt Core 6.6.1
- Using a Designer UI File in Your C++ Application | Qt Designer Manual
この規則は便利ではあるが、例えばウィジェット名を変更した場合に反映されないので問題になりやすいので警告が出る模様。
自分でconnectで指定するのがよいとか。後で理解できたところで対応する。
Qt Designer
出典: Qt Designer Manual。
Qt DesignerはQt WidgetsのGUIエディター。画面でUI部品を構築できて、UI部品をxmlにしてくれる。
Qt Widgetsでの画面開発をかなり簡単にしてくれる。Qt Widgetsの基本を学習したら、たぶんQt Designerを使ったほうがいい。
元々は専用のアプリだったが、今はQt Creatorに組み込まれている。
Connect the signals to the slots
出典: A Quick Start to Qt Designer | Qt Designer Manual。
Qt Designerでウィジェットを右クリック-[Go to slot] を選ぶと、スロットを設定できる。
[Select signal] 画面で対象のsignalを選択して、該当slotの作成となる。
Menu
左上のツールバー?部分に [Type Here] と表示されている。ここにメニューの項目名を入力する (例: File)。
するとメニューが生成されて、メニュー項目に対して [Type Here] が表示される。同じようにここを入力すると (例: New)、メニューのサブ項目が生成される。そして、[Action Editor] にActionも追加される。
追加されたActionに対して、右クリック-[Go to slot]-[triggered()] を選ぶと、該当slot関数の雛形が生成される。
UI
Qt Designerでは.uiファイルで画面を定義する。これはXMLファイルになっていて「Qt Designer's UI File Format | Qt Designer Manual」がXML schema。
デフォルトのMainWindowクラスをみると、mainwindows.hに以下の記載がある。
QT_BEGIN_NAMESPACE namespace Ui { class MainWindow; } QT_END_NAMESPACE
Ui名前空間がuiファイルになっている。
<?xml version="1.0" encoding="UTF-8"?> <ui version="4.0"> <class>MainWindow</class> <widget class="QMainWindow" name="MainWindow">
uiファイル側 (mainwindow.ui) には同名のクラス定義が上記のようにあり、基本的にuiファイルと一対一の関係になっている。
uiファイルはビルド時にuicツールでコンパイルされ、その際にui_mainwindow.hでうまく連動される模様。
わかりにくいが、Ui::MainWindowのUiの名前空間有無で2個のクラスがあり、Ui側はuiファイルのもの。
MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) , m_httpRequest(parent) , m_ui(new Ui::MainWindow) { m_ui->setupUi(this); }
コンストラクターで上記のようにm_uiでUI側インスタンスを保持している。m_uiでuiのウィジェットにアクセスできる。
例えば、以下のような感じ。
void Notepad::newDocument() { currentFile.clear(); ui->textEdit->setText(QString()); }
ビルドディレクトリーに生成されるui_mainwindow.hを見ると、全ウィジェットがui->直下に存在する模様。
HTTP
情報源:
- HTTPデータの送受信 | taro3.github.io
- c++ - How do I write a Qt HTTP GET request? - Stack Overflow
- HTTP Client | Qt Network 6.6.1
HTTPサーバーへのリクエストは頻出処理。curlで自分で実装してもいいが、Qtで専用のクラス類が用意されているので使うといい。
具体的には以下の3クラスにお世話になる。
- QNetworkAccessManager: このクラスは、アプリケーションが要求を送信し、応答を受信することを可能にします。
- QNetworkRequest: このクラスは、送信するリクエストをすべての情報(ヘッダ、URL、データなど)と一緒に保持します。
- QNetworkReply: このクラスは、ヘッダーとデータを持つQNetworkRequestクラスの結果を含みます。
QML
http://doc.qt.io/qt-6/qtqml-documents-structure.html
2種類から構成。
- import文
- rootオブジェクト宣言
importとオブジェクトは空行で分離。
エンコーディングはUTF-8。
Qt Core
QSettings
出典: QSettings Class | Qt Core 6.6.1。
アプリ設定の保存のためのクラス。フォームの内容などを、次回のアプリ起動時に維持可能になる。
まず、引数に著者名、製品名でインスタンスを作成する。
QSettings settings("MySoft", "Star Runner");
その後、setValue()でキーバリュー形式で値を保存する。
settings.setValue("editor/wrapMargin", 68);
保存した値はvalue()で参照できる。
int margin = settings.value("editor/wrapMargin").toInt();
値がなければ、nullになる。デフォルト値を第2引数で指定もできる。