扩展QML - 插件示例

这是关于使用Python扩展QML的6个示例系列中的最后一个。

此示例指的是Python中QML插件的Python版本。Python中的插件概念是不存在的，因为Python模块本身就可以动态加载。我们使用了这个概念，并结合我们的QML类型注册装饰器 - QmlElement/QmlNamedElement - 将作为导入的模块注册QML模块。pyside6-qml 工具通过简单地指向.qml 文件来做这件事。

运行示例

pyside6-qml examples/qml/tutorials/extending-qml/chapter6-plugins/app.qml -I examples/qml/tutorials/extending-qml/chapter6-plugins/Charts

下载 此示例

app.qml

// Copyright (C) 2022 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause

import QtQuick
import Charts 1.0

Item {
    width: 300; height: 200

    PieChart {
        anchors.centerIn: parent
        width: 100; height: 100

        slices: [
            PieSlice {
                anchors.fill: parent
                color: "red"
                fromAngle: 0; angleSpan: 110
            },
            PieSlice {
                anchors.fill: parent
                color: "black"
                fromAngle: 110; angleSpan: 50
            },
            PieSlice {
                anchors.fill: parent
                color: "blue"
                fromAngle: 160; angleSpan: 100
            }
        ]
    }
}

Charts/piechart.py

# Copyright (C) 2022 The Qt Company Ltd.
# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause

from PySide6.QtCore import Property
from PySide6.QtQml import QmlElement, ListProperty
from PySide6.QtQuick import QQuickItem

from pieslice import PieSlice

# To be used on the @QmlElement decorator
# (QML_IMPORT_MINOR_VERSION is optional)
QML_IMPORT_NAME = "Charts"
QML_IMPORT_MAJOR_VERSION = 1


@QmlElement
class PieChart(QQuickItem):
    def __init__(self, parent=None):
        super().__init__(parent)
        self._slices = []
        self._name = ''

    @Property(str, final=True)
    def name(self):
        return self._name

    @name.setter
    def name(self, name):
        self._name = name

    def slice(self, n):
        return self._slices[n]

    def sliceCount(self):
        return len(self._slices)

    def append_and_setparent(self, slice):
        self._slices.append(slice)
        slice.setParentItem(self)

    slices = ListProperty(PieSlice, append_and_setparent)

Charts/pieslice.py

# Copyright (C) 2022 The Qt Company Ltd.
# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause

from PySide6.QtCore import Property, QRectF
from PySide6.QtGui import QColor, QPainter, QPen
from PySide6.QtQuick import QQuickPaintedItem
from PySide6.QtQml import QmlElement

# To be used on the @QmlElement decorator
# (QML_IMPORT_MINOR_VERSION is optional)
QML_IMPORT_NAME = "Charts"
QML_IMPORT_MAJOR_VERSION = 1


@QmlElement
class PieSlice(QQuickPaintedItem):
    def __init__(self, parent=None):
        super().__init__(parent)

        self._color = QColor()
        self._from_angle = 0
        self._angle_span = 0

    @Property(QColor, final=True)
    def color(self):
        return self._color

    @color.setter
    def color(self, color):
        self._color = QColor(color)

    @Property(int, final=True)
    def fromAngle(self):
        return self._from_angle

    @fromAngle.setter
    def fromAngle(self, fromAngle):
        self._from_angle = fromAngle

    @Property(int, final=True)
    def angleSpan(self):
        return self._angle_span

    @angleSpan.setter
    def angleSpan(self, angleSpan):
        self._angle_span = angleSpan

    def paint(self, painter):
        painter.setPen(QPen(self._color, 2))
        painter.setRenderHint(QPainter.RenderHint.Antialiasing, True)

        rect = QRectF(0, 0, self.width(), self.height()).adjusted(1, 1, -1, -1)
        painter.drawPie(rect, self._from_angle * 16, self._angle_span * 16)