nodeeditor 源码阅读 - NumberSourceDataModel 自定义输入节点模型

 

 NumberSourceDataModel.hpp

#pragma once

#include <QtNodes/NodeDelegateModel> // 引入 QtNodes 的节点代理模型

#include <QtCore/QObject>  

#include <iostream> 

// 前向声明通常在头文件中使用，以帮助解决头文件之间的循环依赖问题。
//这可以减少编译时的依赖关系，提高编译效率。
//在此处，只是告诉编译器有一个名为 DecimalData 的类存在，但不提供其完整的定义。
//这可以让编译器知道 DecimalData 类的存在，而无需包含它的头文件。
class DecimalData; // 前向声明 DecimalData 类

using QtNodes::NodeData;  
using QtNodes::NodeDataType; 
using QtNodes::NodeDelegateModel; 
using QtNodes::PortIndex; 
using QtNodes::PortType; 

class QLineEdit; // 前向声明 QLineEdit 类

// The model dictates the number of inputs and outputs for the Node.
// In this example it has no logic.
class NumberSourceDataModel : public NodeDelegateModel // 定义一个名为 NumberSourceDataModel 的类，继承自 NodeDelegateModel
{
    Q_OBJECT // 使用 Qt 的元对象系统

public:
    NumberSourceDataModel(); // 构造函数

    virtual ~NumberSourceDataModel() {} // 虚析构函数

public:
    QString caption() const override { return QStringLiteral("Number Source"); } // 返回节点的标题

    bool captionVisible() const override { return false; } // 返回标题是否可见

    QString name() const override { return QStringLiteral("NumberSource"); } // 返回节点的名称

public:
    QJsonObject save() const override; // 保存节点数据为 JSON 格式

    void load(QJsonObject const &p) override; // 从 JSON 数据加载节点状态

public:
    unsigned int nPorts(PortType portType) const override; // 返回节点输入或输出端口的数量

    NodeDataType dataType(PortType portType, PortIndex portIndex) const override; // 返回指定端口的数据类型信息

    std::shared_ptr<NodeData> outData(PortIndex port) override; // 返回指定输出端口的数据

    void setInData(std::shared_ptr<NodeData>, PortIndex) override {} // 设置输入端口的数据

    QWidget *embeddedWidget() override; // 返回嵌入的小部件（此处为 QLineEdit）

public:
    void setNumber(double number); // 设置节点的数字值

private Q_SLOTS:
    void onTextEdited(QString const &string); // 文本编辑时的槽函数

private:
    std::shared_ptr<DecimalData> _number; // 存储节点的数字数据

    QLineEdit *_lineEdit; // 存储节点的文本输入框
};

待续。。。