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。

要创建自己的自定义样式，请参阅创建自定义样式。自定义样式不需要实现所有控件。默认情况下，对于自定义样式不提供的控件，样式系统会使用基本样式作为后备。可以指定不同的后备样式来定制或扩展内置样式之一。

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 中使用样式。

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