Back to Qt.io
Contact Us Blog Download Qt

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 Controls のアプリケーションスタイルを照会および設定するための 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 Controls をインポートする QML をロードする前に設定する必要があります。QML タイプが登録された後にスタイルを変更することはできません。

注 : QQuickStyle は、コンパイル時にスタイルを選択する機能には対応していません。

独自のカスタム・スタイルを作成するには、カスタム・スタイルの作成を参照してください。カスタム・スタイルは、すべてのコントロールを実装する必要はありません。デフォルトでは、カスタム・スタイルが提供しないコントロールのフォールバックとして基本スタイルが使用されます。組み込みスタイルをカスタマイズまたは拡張するために、別のフォールバック・スタイルを指定することは可能です。

QQuickStyle::setStyle("MyStyle");
QQuickStyle::setFallbackStyle("Material");

スタイリングQt Quick Controlsも参照してください 。

メンバ関数のドキュメント

[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 Controls の Using Stylesも参照して ください。

[static] void QQuickStyle::setStyle(const QString &style)

アプリケーションのスタイルをstyle に設定します。

注: スタイルは、Qt Quick Controls をインポートする QML をロードする前に設定する必要があります。QMLタイプが登録された後にスタイルを変更することはできません。

setFallbackStyle() および Qt Quick Controls のスタイルの使用も参照してください 。

© 2025 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.