PySide6.QtQuickControls2.QQuickStyle

class QQuickStyle

QQuickStyle 类允许配置应用程序样式。更多…

概要

静态函数

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述

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快速控件

static name()
Return type:

字符串

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

注意

应用程序样式可以通过传递-style命令行参数来指定。因此，如果在构建QGuiApplication之前调用name()，可能不会返回完全解析的值。

static setFallbackStyle(style)
Parameters:

style – str

将应用程序的回退样式设置为 style。

注意

回退样式必须是内置Qt Quick Controls样式的名称之一，例如“Material”。

注意

样式必须在加载导入Qt Quick Controls的QML之前进行配置。在QML类型注册后，无法更改样式。

回退样式也可以通过设置QT_QUICK_CONTROLS_FALLBACK_STYLE 环境变量来指定。

static setStyle(style)
Parameters:

style – str

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

注意

样式必须在加载导入Qt Quick Controls的QML之前进行配置。在QML类型注册后，无法更改样式。

另请参阅

setFallbackStyle() 在Qt Quick Controls中使用样式