随着基于CAD的应用软件飞速发展，经常需要保存一些与图形可视性无关的数据，即非图形参数。例如在绘制化验样图中包含品位数据。MxCAD定义一类新的参数——实体扩展数据。扩展数据与实体的可视性无关，而是用户根据需要自定义的数据，因此扩展数据的类型与数目都是任意的。扩展数据不能单独地存在，它必须依附于某一个实体，因而它与实体的图形参数共存。由于扩展数据与实体的可视性无关，因而它对图形毫无影响。由此可见，实体扩展数据的引入，既保持了图形的简洁性，又保留了用户必需的信息。因此，它对实现图形的美观性与数据的完备性有重大意义。点击此处在线演示。

扩展数据组码及其说明

视频如下：

主要用到函数说明：

MxDrawEntity::SetXData

设置实体的扩展数据，详细说明如下：

js代码实现如下：

function SetXData(){
    var ent = mxOcx.GetEntity("选择要写扩展数据的实体:");
    if(ent == null)
    {
        return;
    }
    var exData = mxOcx.Call("Mx_NewResbuf","");
    exData.AddStringEx("TestApp",1001);
    exData.AddStringEx("甲",1000);
    ent.SetXData(exData);
}

主要用到函数说明：

MxDrawEntity::GetXData

返回实体的扩展数据。

js代码实现如下：

function GetXData(){
    var ent = mxOcx.GetEntity("选择要读扩展数据的实体:");
    if(ent == null)
    {
        return;
    }
    var exData = ent.GetXData("TestApp");

    if(exData.Count == 0)
    {
        alert("没有扩展数据");

    }
    else
    {
        // 向命令行窗口打印扩展数据。
        exData.PrintData();
        alert(exData.AtString(1));
    }
}

主要用到函数说明：

MxDrawEntity::SetxDataString

写一个字符串扩展数据，详细说明如下：

js代码实现如下：

function WriteXData(){
    var selEnt = mxOcx.NewComObject("IMxDrawUiPrEntity");
    selEnt.message = "选择要写扩展数据的对象";
    if (selEnt.go() != 1)
        return;
    var ent = selEnt.Entity();
    if (ent == null)
        return;
    if (ent.SetxDataString("ExDataName", 0, "ExDataValue")) {
        alert("写扩展数据成功");
    }
    else {
        alert("写扩展数据失败");
    }
}

主要用到函数说明：

MxDrawEntity::GetxDataString2

读取一个字符扩展数据，详细说明如下：

js代码实现如下：

function ReadXData() {
    var selEnt = mxOcx.NewComObject("IMxDrawUiPrEntity");

    selEnt.message = "选择要读取扩展数据的对象";
    if (selEnt.go() != 1)
        return;

    var ent = selEnt.Entity();
    if (ent == null)
        return;

    var val = ent.GetxDataString2("ExDataName", 0);
    if (mxOcx.IsOk()) {
        alert(val);
    }
    else {
        alert("没有扩展数!");
    }

}

主要用到函数说明：

MxDrawEntity::SetxDataDouble

写一个Double扩展数据，详细说明如下：

js代码实现如下：

function SetxDataDouble(){
    var selEnt = mxOcx.NewComObject("IMxDrawUiPrEntity");
    selEnt.message = "选择要写扩展数据的对象";
    if (selEnt.go() != 1)
        return;
    var ent = selEnt.Entity();
    if (ent == null)
        return;
    if (ent.SetxDataDouble("ExDataName", 0, 55.5)) {
        alert("写扩展数据成功");
    }
    else {
        alert("写扩展数据失败");
    }
}

主要用到函数说明：

MxDrawEntity::GetxDataDouble2

读取一个Double扩展数据，详细说明如下：

js代码实现如下：

function GetxDataDouble() {
    var selEnt = mxOcx.NewComObject("IMxDrawUiPrEntity");

    selEnt.message = "选择要读取扩展数据的对象";
    if (selEnt.go() != 1)
        return;

    var ent = selEnt.Entity();
    if (ent == null)
        return;

    var val = ent.GetxDataDouble2("ExDataName", 0);
    if (mxOcx.IsOk()) {
        alert(val);
    }
    else {
        alert("没有扩展数!");
    }

}

主要用到函数说明：

MxDrawEntity::SetxDataLong

写一个long扩展数据，详细说明如下：

js代码实现如下：

function SetxDataLong(){
    var selEnt = mxOcx.NewComObject("IMxDrawUiPrEntity");
    selEnt.message = "选择要写扩展数据的对象";
    if (selEnt.go() != 1)
        return;
    var ent = selEnt.Entity();
    if (ent == null)
        return;
    if (ent.SetxDataLong("ExDataName", 0, 123456)) {
        alert("写扩展数据成功");
    }
    else {
        alert("写扩展数据失败");
    }
}

主要用到函数说明：

MxDrawEntity::GetxDataLong2

读取一个Long扩展数据，详细说明如下：

js代码实现如下：

function GetxDataLong() {
    var selEnt = mxOcx.NewComObject("IMxDrawUiPrEntity");

    selEnt.message = "选择要读取扩展数据的对象";
    if (selEnt.go() != 1)
        return;

    var ent = selEnt.Entity();
    if (ent == null)
        return;

    var val = ent.GetxDataLong2("ExDataName", 0);
    if (mxOcx.IsOk()) {
        alert(val);
    }
    else {
        alert("没有扩展数!");
    }

}

主要用到函数说明：

MxDrawEntity::GetAllAppName

得到所有扩展数据名称，详细说明如下：

js代码实现如下：

function GetAllAppName() {

    var selEnt = mxOcx.NewComObject("IMxDrawUiPrEntity");
    selEnt.message = "选择需要读取的对象";
    if (selEnt.go() != 1)
        return;
    var ent = selEnt.Entity();
    if (ent == null)
        return;
    //得到所有扩展数据名称
    var val = ent.GetAllAppName();
    if (val == null) {
        return;
    }
    for(var i = 0;i < val.Count; i++ ){
        //返回链表中的指定位置字符串变量值
        alert(val.AtString(i));
    }

}

主要用到函数说明：

MxDrawEntity::DeleteXData

删除扩展数据，详细说明如下：

js代码实现如下：

function DeleteXData() {

    var selEnt = mxOcx.NewComObject("IMxDrawUiPrEntity");
    selEnt.message = "选择要删除扩展数据的对象";
    if (selEnt.go() != 1)
        return;
    var ent = selEnt.Entity();
    if (ent == null)
        return;
    if (ent.DeleteXData("ExDataName")) {
        alert("删除扩展数据成功");
    }
    else {
        alert("删除扩展数据失败");
    }

}