ARX二次开发扩展字典、有名对象字典

admin1

一、本节课程
C++ ARX二次开发扩展字典、有名对象字典
二、本节要讲解的知识点
扩展字典的使用和有名对象字典的使用（AddXRecord、ViewXRecord、AddNameDict、ViewNameDict）。

三、具体内容
1、访问实体的扩展字典？扩展字典与特定的实体关联的，但是一个实体在默认情况下是不包含扩展字典的，如果要利用扩展字典保存与实体关联的数据，可以使用createExtentionDictionary函数来为实体建立扩展字典，如果实体已经包含了扩展字典，那么该函数不产生任何影响。 实体的extentionDictionary函数可以获得扩展字典。

2、访问有名对象字典？每个AUTOCAD图形数据库都有一个有名对象字典，默认情况下字典包含了组，多线样式，布局，打印等信息。例如，用户在AUTOCAD中创建一个组，就会有一个代表该组的元素被添加到组字典中。如果需要在有名对象字典中保存自己的数据，一个可以在有名对象字典中添加一个根字典，然后再向根字典添加新的字典，进而在新字典中保存数据。这样的好处是不会与有名对象字典的基本字典相混淆。

3、建立实体的扩展字典，向其中添加扩展记录：

static void YunyouMyGroupAddXRecord()

{

AcDbEntity *pEnt=NULL;

AcGePoint3d pickPoint;

if (CSelectUtil::PromptSelctEnts(TEXT("\n选择所要添加扩展记录的实体:"),AcDbEntity::desc(),pEnt,pickPoint))

{

//向实体添加扩展字典

pEnt->createExtensionDictionary();

AcDbObjectId dictObjId=pEnt->extensionDictionary();

pEnt->close();



//创建扩展记录实体

AcDbXrecord *pXrec=new AcDbXrecord;



//向扩展字典中添加一条记录

AcDbObjectId xRecObjId;

AcDbDictionary *pDict=NULL;

if (acdbOpenObject(pDict,dictObjId,AcDb::kForWrite)==Acad::eOk)

{

pDict->setAt(TEXT("XRecord"),pXrec,xRecObjId);

pDict->close();

}

//设置扩展记录的内容

struct resbuf *pRb=acutBuildList(AcDb::kDxfText,TEXT("测试字符串数据"),

AcDb::kDxfInt32,12,

AcDb::kDxfReal,3.14,

AcDb::kDxfXCoord,asDblArray(pickPoint),

RTNONE);

pXrec->setFromRbChain(*pRb);

pXrec->close();

acutRelRb(pRb);

}

}

4、显示扩展记录：

static void YunyouMyGroupViewXRecord()

{

AcDbEntity *pEnt=NULL;

AcGePoint3d pickPoint;

if (CSelectUtil::PromptSelctEnts(TEXT("\n选择所要查看扩展记录的实体:"),AcDbEntity::desc(),pEnt,pickPoint))

{

AcDbObjectId dictObjId=pEnt->extensionDictionary();

pEnt->close();



if (dictObjId.isNull())

{

acutPrintf(TEXT("\n所选择的实体不包含扩展字典!"));

return;

}

//打开扩展字典，获得与关键字“XRecord”关联的扩展记录

AcDbDictionary *pDict=NULL;

AcDbXrecord *pXrec=NULL;

struct resbuf * pRb=NULL;if(acdbOpenObject(pDict,dictObjId,AcDb::kForRead)==Acad::eOk)

{

pDict->getAt(TEXT("XRecord"),(AcDbObject*&)pXrec,AcDb::kForRead);

pXrec->rbChain(&pRb);

pXrec->close();

pDict->close();

}

if (pRb!=NULL)

{

//在命令行展示扩展记录的内容

struct  resbuf *pTemp=pRb;

acutPrintf(TEXT("\n字符串类型的扩展数据是:%s"),pTemp->resval.rstring);

pTemp=pTemp->rbnext;

acutPrintf(TEXT("\n整数类型的扩展数据是:%d"),pTemp->resval.rint);

pTemp=pTemp->rbnext;

acutPrintf(TEXT("\n实数类型的扩展数据是:%.2f"),pTemp->resval.rreal);

pTemp=pTemp->rbnext;

acutPrintf(TEXT("\n点坐标类型的扩展数据是:(%.2f,%.2f,%.2f)"),pTemp->resval.rpoint[X],pTemp->resval.rpoint[Y],pTemp->resval.rpoint[Z]);

acutRelRb(pRb);

}

}

}

命令行的提示：

选择所要查看扩展记录的实体:

字符串类型的扩展数据是:测试字符串数据

整数类型的扩展数据是:12

实数类型的扩展数据是:3.14

点坐标类型的扩展数据是:(3080.71,1975.51,0.00)



5、创建有名对象字典：

static void YunyouMyGroupAddNameDict()

{//获取有名对象字典，向其中添加指定的字典项

AcDbDictionary *pNameObjDict=NULL;

acdbHostApplicationServices()->workingDatabase()->getNamedObjectsDictionary(pNameObjDict,AcDb::kForWrite);

AcDbObjectId dictObjId;

AcDbDictionary *pDict=NULL;

if (pNameObjDict->getAt(TEXT("MyDict"),(AcDbObject*&)pDict,AcDb::kForWrite)==Acad::eKeyNotFound)

{

pDict=new AcDbDictionary;

pNameObjDict->setAt(TEXT("MyDict"),pDict,dictObjId);

pDict->close();

}

pNameObjDict->close();

//向新建的字典添加一个图层对象

if (acdbOpenObject(pDict,dictObjId,AcDb::kForWrite)==Acad::eOk)

{

AcDbLayerTableRecord *pLayer=new AcDbLayerTableRecord();

AcCmColor color;

color.setColorIndex(20);

pLayer->setColor(color);

pLayer->setIsOff(true);

pLayer->setIsFrozen(true);

AcDbObjectId layerId;

Acad::ErrorStatus es=pDict->setAt(TEXT("LayerKey"),pLayer,layerId);

pLayer->close();

pDict->close();

}

}

6、显示有名对象字典：

static void YunyouMyGroupViewNameDict()

{

//获取有名对象字典，向其中添加指定的字典项

AcDbDictionary *pNameObjDict=NULL;

Acad::ErrorStatus es;

acdbHostApplicationServices()->workingDatabase()->getNamedObjectsDictionary(pNameObjDict,AcDb::kForRead);

AcDbDictionary *pDict=NULL;

es=pNameObjDict->getAt(TEXT("MyDict"),(AcDbObject*&)pDict,AcDb::kForRead);

pNameObjDict->close();

if (es==Acad::eKeyNotFound)

{

acutPrintf(TEXT("\n不存在字典项MyDict"));

return;

}

AcDbLayerTableRecord *pLayer=NULL;

if (pDict->getAt(TEXT("LayerKey"),(AcDbObject*&)pLayer,AcDb::kForRead)==Acad::eOk)

{

int colorIndex=pLayer->color().colorIndex();

bool bOff=pLayer->isOff();

bool bFrozen=pLayer->isFrozen();

pLayer->close();

acutPrintf(TEXT("\n字典中的图层颜色：%d"),colorIndex);

acutPrintf(TEXT("\n字典中的图层是否是关闭状态：%s"),bOff?TEXT("是"):TEXT("否"));

acutPrintf(TEXT("\n字典中的图层是否是冻结状态:%s"),bFrozen?TEXT("是"):TEXT("否"));

}

pDict->close();



}

在AUTOCAD中调用命令的结果如下：

命令: ADDNAMEDICT

命令: VIEWNAMEDICT

字典中的图层颜色：20

字典中的图层是否是关闭状态：是

字典中的图层是否是冻结状态:是



用ARXDBG工具查看到数据库中已经有MyDict的有名对象字典。



四、总结
1、如何创建扩展记录和查看扩展记录。在开发中尽量采用扩展记录的，避免使用扩展数据。因为扩展记录的功能更强大，也是AUTOCAD推荐的方式。

2、如何创建有名对象字典和查看有名对象字典。并且使用了ARXDBG工具查看了我们自己创建的有名对象字典。

3、以上的代码都可以应用到开发中。课后对照视频和笔记，自己实现一遍如何创建和查看扩展数据、扩展记录、有名对象字典等，进一步巩固以上知识点。