QMLBook项目：Python与QML深度整合指南

QMLBook项目：Python与QML深度整合指南

【免费下载链接】qmlbook The source code for the upcoming qml book 项目地址: https://gitcode.com/gh_mirrors/qm/qmlbook

引言

Qt for Python项目（PySide2）为开发者提供了将Qt强大的GUI框架与Python语言结合的完美方案。通过这个项目，开发者可以使用Python语言实现原本需要C++才能完成的Qt开发工作，包括从无界面的服务到复杂的窗口应用程序开发。本文将重点介绍如何将QML与Python进行深度整合。

环境搭建

安装准备

PySide2可以通过pip工具直接安装，建议在虚拟环境中进行操作：

python3 -m venv qt-for-python
source qt-for-python/bin/activate
pip install pyside2

安装完成后，可以通过简单的测试代码验证安装是否成功：

from PySide2 import QtWidgets
import sys

app = QtWidgets.QApplication(sys.argv)
widget = QtWidgets.QLabel("Hello World!")
widget.show()
app.exec_()

QML与Python基础整合

运行QML程序

要在Python中运行QML程序，我们需要使用QGuiApplication和QQmlApplicationEngine：

from PySide2.QtWidgets import QApplication
from PySide2.QtQuick import QQuickView
from PySide2.QtCore import QUrl

app = QApplication([])
view = QQuickView()
view.setSource(QUrl.fromLocalFile("main.qml"))
view.show()
app.exec_()

对应的QML文件main.qml可以这样写：

import QtQuick 2.0

Rectangle {
    width: 200
    height: 200
    color: "lightblue"
    
    Text {
        text: "Hello Python World!"
        anchors.centerIn: parent
    }
}

深入整合：双向通信

信号与槽机制

Python类可以通过继承QObject来支持Qt的信号槽机制：

from PySide2.QtCore import QObject, Signal, Slot

class NumberGenerator(QObject):
    nextNumber = Signal(int)
    
    def __init__(self):
        QObject.__init__(self)
    
    @Slot()
    def giveNumber(self):
        import random
        self.nextNumber.emit(random.randint(0, 100))

在QML中可以这样使用：

Button {
    text: "Generate Number"
    onClicked: numberGenerator.giveNumber()
}

Connections {
    target: numberGenerator
    onNextNumber: console.log("Number:", number)
}

属性绑定

更强大的功能是通过属性绑定实现数据同步：

class NumberGenerator(QObject):
    def __init__(self):
        QObject.__init__(self)
        self._number = 0
        self._maxNumber = 100
    
    @Property(int, notify=numberChanged)
    def number(self):
        return self._number
    
    @Property(int, notify=maxNumberChanged)
    def maxNumber(self):
        return self._maxNumber
    
    @maxNumber.setter
    def maxNumber(self, value):
        if self._maxNumber != value:
            self._maxNumber = value
            self.maxNumberChanged.emit()

QML中可以这样绑定：

Slider {
    value: numberGenerator.maxNumber
    onValueChanged: numberGenerator.maxNumber = value
}

Text {
    text: numberGenerator.number
}

高级应用：自定义模型

我们可以创建自定义模型来展示系统信息：

from PySide2.QtCore import QAbstractListModel, Qt
import psutil

class CpuLoadModel(QAbstractListModel):
    def __init__(self):
        super().__init__()
        self._cpu_load = [0] * psutil.cpu_count()
        
    def rowCount(self, parent):
        return len(self._cpu_load)
    
    def data(self, index, role):
        if role == Qt.DisplayRole:
            return self._cpu_load[index.row()]
        return None

在QML中使用ListView展示：

ListView {
    model: CpuLoadModel {}
    delegate: Rectangle {
        width: 200
        height: 30
        color: "lightgray"
        
        Rectangle {
            width: parent.width * display/100
            height: parent.height
            color: "green"
        }
        
        Text {
            text: display + "%"
            anchors.centerIn: parent
        }
    }
}

注意事项

1. 目前PySide2不支持移动平台开发
2. 信号参数名称无法自动从Python传递到QML
3. 某些高级特性可能需要额外处理

通过本文介绍的方法，开发者可以充分利用Python的简洁语法和丰富生态，结合QML强大的声明式UI能力，构建出功能丰富、界面美观的跨平台应用程序。

【免费下载链接】qmlbook The source code for the upcoming qml book 项目地址: https://gitcode.com/gh_mirrors/qm/qmlbook