QQuickStyle Class
QQuickStyle クラスを使用すると、アプリケーションのスタイルを設定できます。詳細...
| ヘッダー: | #include <QQuickStyle> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS QuickControls2) target_link_libraries(mytarget PRIVATE Qt6::QuickControls2) |
| qmake: | QT += quickcontrols2 |
静的パブリックメンバー
| QString | name() |
| void | setFallbackStyle(const QString &style) |
| void | setStyle(const QString &style) |
詳細な説明
QQuickStyleは、Qt Quick コントロールのアプリケーションスタイルを照会および設定するためのAPIを提供します。
#include <QGuiApplication>
#include <QQmlApplicationEngine>
#include <QQuickStyle>
int main(int argc, char *argv[])
{
QGuiApplication app(argc, argv);
QQuickStyle::setStyle("Material");
QQmlApplicationEngine engine;
engine.load(QUrl("qrc:/main.qml"));
return app.exec();
}注: スタイルは 、Qt Quick コントロールをインポートするQMLをロードする前に設定する必要があります。QMLタイプが登録された後は、スタイルを変更することはできません。
注： コンパイル時のスタイル選択を使用する場合、QQuickStyle は サポートされません。
独自のカスタムスタイルを作成するには、「カスタムスタイルの作成」を参照してください。カスタムスタイルは、すべてのコントロールを実装する必要はありません。デフォルトでは、スタイリングシステムは、カスタムスタイルで提供されていないコントロールに対して、フォールバックとして「Basic」スタイルを使用します。別のフォールバックスタイルを指定して、組み込みスタイルの1つをカスタマイズしたり拡張したりすることも可能です。
QQuickStyle::setStyle("MyStyle");
QQuickStyle::setFallbackStyle("Material");「 Qt Quick コントロールのスタイル設定」も参照してください 。
メンバ関数のドキュメント
[static] QString QQuickStyle::name()
アプリケーションスタイルの名前を返します。
注：アプリケーションスタイルは 、-style というコマンドライン引数を指定することで指定できます。そのため、QGuiApplication を構築する前にname() を呼び出した場合、完全に解決された値が返されない可能性があります。
[static] void QQuickStyle::setFallbackStyle(const QString &style)
アプリケーションのフォールバックスタイルを「style 」に設定します。
注：フォールバックスタイルは 、Qt Quick Controlsに組み込まれているスタイル名（例：「Material」）のいずれかでなければなりません。
注：スタイルは 、Qt Quick Controls をインポートする QMLを読み込む前に設定する必要があります。QML タイプが登録された後は、スタイルを変更することはできません。
フォールバックスタイルは、QT_QUICK_CONTROLS_FALLBACK_STYLE 環境変数を設定することでも指定できます。
「 setStyle()」および「 Qt Quick コントロールでのスタイルの使用」も参照してください 。
[static] void QQuickStyle::setStyle(const QString &style)
アプリケーションのスタイルを「style 」に設定します。
注： Qt Quick コントロールをインポートする QMLを読み込む前に、スタイルを設定しておく 必要があります。QML タイプが登録された後は、スタイルを変更することはできません。
「 setFallbackStyle()」および「 Qt Quick コントロールでのスタイルの使用」も参照してください 。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
