（Demo3D 学习笔记）案例1：自创组件，可以一键自动连接场景中的其他相关组件

本文链接：https://blog.csdn.net/vueposer/article/details/123872405

1、模型描述

在场景中自创一个组件，通过该组件，可以一键自动连接场景中的各相关组件。

2、模型布局

首先将自定义组件（绿色）分别连接输送机（左），叉车，输送机（右）后（见左图），通过组件的自定义功能，一键完成输送机（左）连接叉车，再让叉车连接输送机（右）的最终效果（右图）。

3、解决方案

3.1、创建自定义组件

在场景中添加一个Box1，颜色为绿色，高度设置为较小值，使得此Box1呈现扁平状。

对Box1创建自定义属性如下：

定义好后，可以看到此组件的属性栏中只出现了A、B、C、PortA、PortB、PortC 属性（下图左），而 iConnect、iDisconnect 属性类型因为是脚本，故这2个属性实际显示在事件栏中（下图右）。

在自定义组件Box1 的 OnReset 事件中，编写代码如下：

function Box1_OnReset( sender : Demo3D.Visuals.BoxVisual )
{
   var portA: CustomEnumeration = sender.PortA; //定义枚举变量
portA.AllowedValues=New ArrayList(["Start","End"]); //定义枚举变量的值
    var portB: CustomEnumeration = sender.PortB;
   portB.AllowedValues=New ArrayList(["Start","End"]);
    var portC: CustomEnumeration = sender.PortC;
   portC.AllowedValues=New ArrayList(["Start","End"]);
}

3.2、将自定义组件Box1 的A/B/C点分别进行连接

连接后，再到Box1的属性栏中赋值，其中 PortA="End"，PortB="Start"，PortC="Start"。

完成上述一系列操作的目的，在于我们接下来编写代码时，需要通过这些属性来引用各实体组件的端口。右下图很明显，A表示左边3个输送机，B表示叉车，C表示右边3个输送机，这样的话，我们可以在代码中通过 A.PortA 方式，就可以引用左边3个输送机 SR1.End、SR2.End、SR3.End 端口，其他类同。

3.3、编写代码

3.3.1、iConnect 事件（一键连接相关实体的端口连接）

在 Box1 的事件栏中找到 iConnect 事件，选择 New；

编写代码如下：

function Box1_iConnect( sender : Demo3D.Visuals.BoxVisual )
{
   var a:VisualList=sender.A; //定义数组变量，取值为输送机 SR1/SR2/SR3
   var b:VisualList=sender.B;
   var c:VisualList=sender.C;
//针对左边每个输送机做循环
   for(eachA:Visual in a){

//获取左边单个输送机的端口，因PortA="End"，故获取到的是此输送机的输出端口
var aconn:Connector = eachA.FindConnector(sender.PortA.ToString()); //务必要用ToString函数转换为字符串
//针对每个叉车做循环（这里只有1个叉车）
for(eachB:Visual in b){

//获取叉车的端口，因PortB="Start"，故获取到的是叉车的输入端口
var bconn:Connector = eachB.FindConnector(sender.PortB.ToString());

//输送机输出端口与叉车输入端口连接
           aconn.ConnectTo(bconn,0,1,1);
   }
    }
//以下代码同上面类似
   for(eachC:Visual in c){
       var cconn:Connector = eachC.FindConnector(sender.PortC.ToString());

       for(eachB:Visual in b){
           var bconn:Connector;
           if(sender.PortC.ToString()=="Start"){
               bconn = eachB.FindConnector("End");

           }
           else{
               bconn = eachB.FindConnector("Start");
           }
           cconn.ConnectTo(bconn,0,1);

       }

   }

}