QQuickStyle 类

QQuickStyle 类允许配置应用程序风格。更多信息...

头文件 #include <QQuickStyle>
CMakefind_package(Qt6 REQUIRED COMPONENTS QuickControls2)
target_link_libraries(mytarget PRIVATE Qt6::QuickControls2)
qmakeQT += quickcontrols2

静态公共成员

QStringname()
voidsetFallbackStyle(const QString &style)
voidsetStyle(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。

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

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

另请参阅：Qt Quick 控件的样式。

成员函数文档

[静态] QString QQuickStyle::name()

返回应用程序样式的名称。

注意：可以通过传递 -style 命令行参数来指定应用程序样式。因此，如果调用时还未构造 QGuiApplication，则 name() 可能不会返回已解析的值。

[静态] void QQuickStyle::setFallbackStyle(const QString &style)

将应用程序备用样式设置为 style。

注意：备用样式必须是内置 Qt Quick 控件样式的名称，例如 "Material"。

注意：必须在加载导入 Qt Quick 控件的 QML 之前配置样式。一旦注册了 QML 类型，就不可更改样式。

备用样式还可以通过设置 QT_QUICK_CONTROLS_FALLBACK_STYLE 环境变量 来指定。

另请参阅：setStyle() 和 Qt Quick 控件中使用样式。

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

设置应用程序风格为style。

注意：必须在加载导入 Qt Quick 控件的 QML 之前配置样式。一旦注册了 QML 类型，就不可更改样式。

另见setFallbackStyle() 和 在 Qt Quick Controls 中使用样式。

© 2024 Qt 公司有限公司。本文件中包含的文档贡献属于其各自的版权所有者。本文件提供的文档是根据自由软件基金会发布的 GNU 自由文档许可 version 1.3 条款许可的。Qt 及其相应的标志是芬兰和/或其他国家 Qt 公司的商标。所有其他商标均为其各自所有者的财产。