STNodeEditor是一款基于.Net WinForm的节点编辑器。

纯GDI+绘制使用方式非常简洁提供了丰富的属性以及事件可以非常方便的完成节点之间数据的交互及通知大量的虚函数供开发者重写具有很高的自由性。

目前已经进入3.0的开发，对于快速式开发很好用。

项目主页 (Project home): DebugST.github.io/STNodeEditor (简体中文, English)

教程文档: DebugST.github.io/STNodeEditor/doc_cn.html

Tutorials and API: DebugST.github.io/STNodeEditor/doc_en.html

Mail: ([email protected])

NuGet: https://www.nuget.org/packages/ST.Library.UI/

PM> Install-Package ST.Library.UI -Version 2.0.0

像流程图一样使用你的功能

你是否有设想过流程图不再是流程图而是直接可以执行的？

在一些开发过程中我们可能会为整个程序设计一个流程图上面包含了我们存在的功能模块以及执行流程然后由开发者逐一实现

但是这样会带来一些问题程序的执行流程可能会被硬编码到程序中去如果突然有一天可能需要改变执行顺序或者添加删除一个执行模块可能需要开发者对代码重新编辑然后编译而且各个功能模块之间的调用也需要开发者进行编码调度增加开发成本等一系列的问题

而 STNodeEditor 就是为此诞生

STNodeEditor 包含3部分 TreeView PropertyGrid NodeEditor 这三部分组成了一套完整的可使用框架

TreeView

可以把执行功能编码到一个节点中而 TreeView 则负责展示以及检索节点在 TreeView 中的节点可直接拖拽添加到 NodeEditor 中

PropertyGrid

类似与 WinForm 开发使用的属性窗口作为一个节点它也是可以有属性的而作者在编辑器进行设计的过程中也把一个节点视作一个 Form 让开发者几乎没有什么学习成本直接上手一个节点的开发 *NodeEditor *NodeEditor 是用户组合自己执行流程的地方使得功能模块执行流程可视化

如何使用它？

STNodeEditor的使用非常简单你几乎可以没有任何学习成本的去使用的当然最重要的一点就是你需要知道如何去创建一个节点

你可以像创建一个Form一样去创建一个Node

using ST.Library.UI.NodeEditor;
 
public class MyNode : STNode
{
    public MyNode() { //等同于 [override void Oncreate(){}]
        this.Title = "MyNode";
        this.TitleColor = Color.FromArgb(200, Color.Goldenrod);
        this.AutoSize = false;
        this.Size = new Size(100, 100);
 
        var ctrl = new STNodeControl();
        ctrl.Text = "Button";
        ctrl.Location = new Point(10, 10);
        this.Controls.Add(ctrl);
        ctrl.MouseClick += new MouseEventHandler(ctrl_MouseClick);
    }
 
    void ctrl_MouseClick(object sender, MouseEventArgs e) {
        MessageBox.Show("MouseClick");
    }
}
//添加到编辑器中
stNodeEditor.Nodes.Add(new MyNode());

可以看到它的使用方式和 Form 确实很像其实目前还暂时没有提供所见即所得的UI设计器而且一个 STNode 它同样有它的控件集合且数据类型为 STNodeControl

STNodeControl 作为 STNode 控件的基类它拥有着和 System.Windows.Forms.Control 许多同名的属性和事件一切的初衷都只为与 WinForm 靠近

注意：在目前的版本中(2.0) STNodeEditor仅仅提供了STNodeControl基类并未提供任何一个可用控件当然在附随的Demo工程中包含了部分示例演示如何自定义一个控件由于这属于自定义控件的范畴所以演示并未太多若需了解关于自定义控件如何开发可参考作者：自定义控件开发系列文章当然在后续的版本中作者将提供部分常用控件虽说作者想把使用方式往WinForm上靠单仅仅是把它当作WinForm使用并不是作者的初衷

上面的演示仅仅是为了让大家感到亲切感毕竟 WinForm 可能是大家熟悉的一个东西但是如果仅仅是把它当作 WinForm 使用毫无意义对于一个节点来说最重要的属性当然是数据的输入和输出

public class MyNode : STNode
{
    protected override void OnCreate() {//等同 [public MyNode(){}]
        base.OnCreate();
        this.Title = "TestNode";
        //可以得到添加的索引位置
        int nIndex = this.InputOptions.Add(new STNodeOption("IN_1", typeof(string), false));
        //可以得到添加的 STNodeOption
        STNodeOption op = this.InputOptions.Add("IN_2", typeof(int), true);
        this.OutputOptions.Add("OUT", typeof(string), false);
    }
    //当所有者发生改变(即：在NodeEditor中被添加或移除)
    //应当像容器提交自己拥有数据类型的连接点 所期望显示的颜色
    //颜色主要用于区分不同的数据类型
    protected override void OnOwnerChanged() {
        base.OnOwnerChanged();
        if (this.Owner == null) return;
        this.Owner.SetTypeColor(typeof(string), Color.Yellow);
        //当前容器中已有的颜色会被替换
        this.Owner.SetTypeColor(typeof(int), Color.DodgerBlue, true); 
        //下面的代码将忽略容器中已有的颜色
        //this.SetOptionDotColor(op, Color.Red); //无需在OnOwnerChanged()中设置
    }
}

通过上面的案例你可以看到 STNode 有两个重要的属性 InputOptions 和 OutputOptions 其数据类型为 STNodeOption 而 STNodeOption 有两种连接模式 single-connection 和 multi-connection

single-connection

单连接模式在单连接模式下一个连接点同时只能被一个同数据类型点的连接

multi-connection

多连接模式在多连接模式下一个连接点同时可以被多个同数据类型点连接

public class MyNode : STNode {
    protected override void OnCreate() {
        base.OnCreate();
        this.Title = "MyNode";
        this.TitleColor = Color.FromArgb(200, Color.Goldenrod);
        //multi-connection
        this.InputOptions.Add("Single", typeof(string), true);
        //single-connection
        this.OutputOptions.Add("Multi", typeof(string), false);

分享一个基于流程图的C#编辑器开发

像流程图一样使用你的功能

如何使用它？