Back to Qt.io
Contact Us Blog Download Qt

QQuickStyle Class

QQuickStyleクラスは、アプリケーションのスタイルを設定することができます。詳細...

Header: #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 は、コンパイル時のスタイル選択を使用する場合にはサポートされません。

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

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 でスタイルを使用するも参照してください 。

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

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

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

setFallbackStyle() とQt Quick Controls でスタイルを使用するも参照してください 。

©2024 The Qt Company Ltd. 本書に含まれるドキュメントの著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。