objectARX开发：扩展数据XData、扩展记录XRecord和有名对象字典NameDict

qq1254582201

摘要
本文详细介绍了AutoCAD开发中扩展数据XData、扩展记录XRecord以及有名对象字典NameDict的使用。XData用于向实体添加用户数据，但有限;XRecord存储能力更强，常用于替代XData;而NameDict作为图形数据库的一部分，用于保存与实体无关的设计参数。文章涵盖如何添加、查看和删除这些数据，并提供了源码地址供进一步研究。
1、实体-扩展数据XData
扩展数据能被添加到任何实体上，由一个结果缓冲区链表组成，并且随AutoCAD图形一起保存(AutoCAD不会使用扩展数据)。在许多情况下，扩展数据是向实体追加用户数据的一个有效途径，但是每个实体上所附加的扩展数据不能超过16K。
1)添加扩展数据

1. static void ZYMyGroupAddXData()
   
2.   {
   
3.     // Put your command code here
   
4.     // 提示用户选择所要添加扩展数据的图形对象
   
5.     AcDbEntity *pEnt = nullptr;
   
6.     AcGePoint3d pickPoint;
   
7.     if (CSelectUtil::PromptSelectEntity(TEXT("\n选择所要添加扩展数据的实体:"), AcDbEntity::desc(), pEnt, pickPoint))
   
8.     {
   
9.       CString appName = TEXT("CustomXDataApp");
   
10. 
    
11.       // 注册应用程序名称
    
12.       acdbRegApp(appName);
    
13. 
    
14.       // 创建结果缓冲区链表
    
15.       struct resbuf* rb = acutBuildList(AcDb::kDxfRegAppName, appName,    // 应用程序名称
    
16.         AcDb::kDxfXdAsciiString, TEXT("扩展数据字符串"),  // 字符串
    
17.         AcDb::kDxfXdInteger32, 2,              // 整数
    
18.         AcDb::kDxfXdReal, 3.14,                // 实数
    
19.         AcDb::kDxfXdWorldXCoord, asDblArray(pickPoint),            // 点坐标值
    
20.         RTNONE);
    
21. 
    
22.       // 为选择的实体添加扩展数据
    
23.       pEnt->setXData(rb);
    
24.       acutRelRb(rb);
    
25. 
    
26.       acutPrintf(TEXT("\n成功为实体添加了扩展数据！"));
    
27. 
    
28.       pEnt->close();
    
29.     }
    
30.   }
    

复制代码

2)查看扩展数据

1. static void ZYMyGroupViewXData()
   
2.   {
   
3.     // 提示用户选择所要查看扩展数据的图形对象
   
4.     AcDbEntity *pEnt = NULL;
   
5.     AcGePoint3d pickPoint;
   
6.     if (CSelectUtil::PromptSelectEntity(TEXT("\n选择所要查看扩展数据的实体:"), AcDbEntity::desc(), pEnt, pickPoint))
   
7.     {
   
8.       CString appName = TEXT("CustomXDataApp");
   
9. 
   
10.       // 获取实体的扩展数据
    
11.       struct resbuf *pRb = pEnt->xData(appName);
    
12.       if (pRb != NULL)
    
13.       {
    
14.         // 在命令行显示所有的扩展数据
    
15.         struct resbuf *pTemp = pRb;    // 使用临时的结果缓冲区指针进行遍历，pRb不修改便于释放
    
16. 
    
17.         // 首先要跳过应用程序的名称这一项
    
18.         pTemp = pTemp->rbnext;
    
19.         acutPrintf(TEXT("\n字符串类型的扩展数据是: %s"), pTemp->resval.rstring);
    
20. 
    
21.         pTemp = pTemp->rbnext;
    
22.         acutPrintf(TEXT("\n整数类型的扩展数据是: %d"), pTemp->resval.rint);
    
23. 
    
24.         pTemp = pTemp->rbnext;
    
25.         acutPrintf(TEXT("\n实数类型的扩展数据是: %.2f"), pTemp->resval.rreal);
    
26. 
    
27.         pTemp = pTemp->rbnext;
    
28.         acutPrintf(TEXT("\n点坐标类型的扩展数据是: (%.2f, %.2f, %.2f)"),
    
29.           pTemp->resval.rpoint[X], pTemp->resval.rpoint[Y],
    
30.           pTemp->resval.rpoint[Z]);
    
31. 
    
32.         acutRelRb(pRb);
    
33.       }
    
34.       else
    
35.       {
    
36.         acutPrintf(TEXT("\n所选择的实体不包含任何的扩展数据!"));
    
37.       }
    
38. 
    
39.       pEnt->close();
    
40.     }
    
41.   }
    

复制代码

3）删除扩展数据

1. static void ZYMyGroupDeleteXData()
   
2.   {
   
3.     // 提示用户选择所要删除扩展数据的图形对象
   
4.     AcDbEntity *pEnt = NULL;
   
5.     AcGePoint3d pickPoint;
   
6.     if (CSelectUtil::PromptSelectEntity(TEXT("\n选择所要删除扩展数据的实体:"), AcDbEntity::desc(), pEnt, pickPoint))
   
7.     {
   
8.       CString appName = TEXT("CustomXDataApp");
   
9. 
   
10.       // 注册应用程序名称
    
11.       acdbRegApp(appName);
    
12. 
    
13.       // 创建结果缓冲区链表
    
14.       struct resbuf* rb = acutBuildList(AcDb::kDxfRegAppName, appName,RTNONE);
    
15. 
    
16.       // 设置内容为空的结果缓冲区链表就是删除扩展数据
    
17.       pEnt->setXData(rb);
    
18.       acutRelRb(rb);
    
19. 
    
20.       acutPrintf(TEXT("\n成功为实体删除了扩展数据！"));
    
21. 
    
22.       pEnt->close();
    
23.     }
    
24.   }
    

复制代码

2、实体–扩展记录Data
  扩展记录与扩展数据类似，但是其数据存储量和能够存储的数据类型都要多于扩展数据。扩展记录可以保存在实体的扩展字典中。扩展字典隶属于特定的实体，每个实体只能包含一个扩展字典，它为实体保存自定义数据提供了一种途径，实际上， Autodesk 也建议开发者用扩展字典和扩展记录来代替传统的扩展数据。有名对象字典直接保存在图形数据库中，不与特定的实体有关，因此可用于保存与实体无关的设计参数。字典与符号表类似，其中包含一个惟一的字符串关键字索引和对象 ID 号，通过关键字来访问字典中保存的内容。
1）添加扩展记录

1. static void ZYMyGroupAddXRecord()
   
2.   {
   
3.     // 提示用户选择所要添加扩展记录的图形对象
   
4.     AcDbEntity *pEnt = NULL;
   
5.     AcGePoint3d pickPoint;
   
6.     if (CSelectUtil::PromptSelectEntity(TEXT("\n选择所要添加扩展记录的实体:"), AcDbEntity::desc(), pEnt, pickPoint))
   
7.     {
   
8.       // 向实体中添加扩展字典
   
9.       pEnt->createExtensionDictionary();
   
10.       AcDbObjectId dictObjId = pEnt->extensionDictionary();
    
11.       pEnt->close();
    
12. 
    
13.       // 创建扩展记录
    
14.       AcDbXrecord *pXrec = new AcDbXrecord;
    
15. 
    
16.       // 向扩展字典中添加一条记录
    
17.       AcDbObjectId xRecObjId;
    
18.       AcDbDictionary *pDict = NULL;
    
19.       if (acdbOpenObject(pDict, dictObjId, AcDb::kForWrite) == Acad::eOk)
    
20.       {
    
21.         pDict->setAt(TEXT("XRecord"), pXrec, xRecObjId);
    
22.         pDict->close();
    
23.       }
    
24. 
    
25.       // 设置扩展记录的内容
    
26.       struct resbuf* pRb = acutBuildList(AcDb::kDxfText, TEXT("测试字符串数据"),
    
27.         AcDb::kDxfInt32, 12,
    
28.         AcDb::kDxfReal, 3.14,
    
29.         AcDb::kDxfXCoord, asDblArray(pickPoint),
    
30.         RTNONE);
    
31.       pXrec->setFromRbChain(*pRb);  // 扩展数据内容填充扩展记录对象
    
32.       pXrec->close();
    
33.       acutRelRb(pRb);
    
34.     }
    
35.   }
    

复制代码

2)查看扩展记录

1. static void ZYMyGroupViewXRecord()
   
2.   {
   
3.     // 提示用户选择所要查看扩展记录的图形对象
   
4.     AcDbEntity *pEnt = NULL;
   
5.     AcGePoint3d pickPoint;
   
6.     if (CSelectUtil::PromptSelectEntity(TEXT("\n选择所要查看扩展记录的实体:"), AcDbEntity::desc(), pEnt, pickPoint))
   
7.     {
   
8.       // 获得实体的扩展字典
   
9.       AcDbObjectId dictObjId = pEnt->extensionDictionary();
   
10.       pEnt->close();
    
11.       if (dictObjId.isNull())
    
12.       {
    
13.         acutPrintf(TEXT("\n所选择的实体不包含扩展字典!"));
    
14.         return;
    
15.       }
    
16. 
    
17.       // 打开扩展字典，获得与关键字"XRecord"关联的扩展记录
    
18.       AcDbDictionary *pDict = NULL;
    
19.       AcDbXrecord *pXrec = NULL;
    
20.       struct resbuf *pRb = NULL;
    
21.       if (acdbOpenObject(pDict, dictObjId, AcDb::kForRead) == Acad::eOk)
    
22.       {
    
23.         pDict->getAt(TEXT("XRecord"), (AcDbObject*&)pXrec, AcDb::kForRead);
    
24. 
    
25.         // 获得扩展记录的数据链表并关闭扩展数据对象      
    
26.         pXrec->rbChain(&pRb);
    
27.         pXrec->close();
    
28. 
    
29.         pDict->close();
    
30.       }
    
31. 
    
32.       if (pRb != NULL)
    
33.       {
    
34.         // 在命令行显示扩展记录内容
    
35.         struct resbuf *pTemp = pRb;
    
36. 
    
37.         acutPrintf(TEXT("\n字符串类型的扩展数据是：%s"), pTemp->resval.rstring);
    
38. 
    
39.         pTemp = pTemp->rbnext;
    
40.         acutPrintf(TEXT("\n整数类型的扩展数据是：%d"), pTemp->resval.rint);
    
41. 
    
42.         pTemp = pTemp->rbnext;
    
43.         acutPrintf(TEXT("\n实数类型的扩展数据是：%.2f"), pTemp->resval.rreal);
    
44. 
    
45.         pTemp = pTemp->rbnext;
    
46.         acutPrintf(TEXT("\n点坐标类型的扩展数据是：(%.2f, %.2f, %.2f)"),
    
47.           pTemp->resval.rpoint[X], pTemp->resval.rpoint[Y],
    
48.           pTemp->resval.rpoint[Z]);
    
49. 
    
50.         acutRelRb(pRb);
    
51.       }
    
52.     }
    
53.   }
    

复制代码

3）删除扩展记录
3、图形数据库–有名对象字典
   AutoCAD 每个图形数据库中都包含一个有名对象字典，默认情况下该字典中包含了组、多线样式、布局和打印等信息。例如，用户在 AutoCAD 创建一个组，就会有一个代表改组的元素被添加到组字典中。如果需要在有名对象字典中保存自己的数据，一般可以在有名对象字典中添加一个根字典，然后再向根字典中添加新的字典，进而在新字典中保存数据。这样的好处是不会与有名对象字典的基本字典相混淆。使用 AcDbDatabase 对象的 getNamedObjectsDictionary 函数可以获得图形的有名对象字典（根字典），可以通过 setAt 函数向根字典添加一个字典，或者通过 getAt 函数获得其中的一个字典。获得字典之后，向字典中保存数据的方法与扩展字典完全一致。
1)添加有名对象字典

1. static void ZYMyGroupAddNameDict()
   
2.   {
   
3.     // 获得有名对象字典，向其中添加指定的字典项
   
4.     AcDbDictionary *pNameObjDict = NULL;//,
   
5.     acdbHostApplicationServices()->workingDatabase()
   
6.       ->getNamedObjectsDictionary(pNameObjDict, AcDb::kForWrite);
   
7.     // 检查所要添加的字典项是否已经存在
   
8.     AcDbObjectId dictObjId;
   
9.     AcDbDictionary *pDict = NULL;
   
10.     if (pNameObjDict->getAt(TEXT("MyDict"), (AcDbObject*&)pDict, AcDb::kForWrite) == Acad::eKeyNotFound)
    
11.     {
    
12.       pDict = new AcDbDictionary;
    
13.       pNameObjDict->setAt(TEXT("MyDict"), pDict, dictObjId);
    
14.       pDict->close();
    
15.     }
    
16.     pNameObjDict->close();
    
17. 
    
18.     // 向新建的字典中添加一个块记录对象
    
19.     if (acdbOpenObject(pDict, dictObjId, AcDb::kForWrite) == Acad::eOk)
    
20.     {
    
21.       CString sLinkName = _T("linkFilePath");
    
22.       CString sLinkPath = _T("C:\\Users\\zhangly-e\\Desktop\ggf.dwg");
    
23.       AcDbBlockTableRecord* pBlockRecord = new AcDbBlockTableRecord();
    
24.       pBlockRecord->setName(sLinkName);
    
25.       pBlockRecord->setPathName(sLinkPath);
    
26. 
    
27.       AcDbObjectId objectId;
    
28.       Acad::ErrorStatus es = pDict->setAt(TEXT("BlockKey"), pBlockRecord, objectId);
    
29.       pBlockRecord->close();
    
30.       pDict->close();
    
31.     }
    
32.   }
    

复制代码

2)查看有名对象字典

1. static void ZYMyGroupViewNameDict()
   
2.   {
   
3.     // 获得对象有名字典中指定的字典项
   
4.     AcDbDictionary *pNameObjDict = NULL;
   
5.     Acad::ErrorStatus es;
   
6.     acdbHostApplicationServices()->workingDatabase()
   
7.       ->getNamedObjectsDictionary(pNameObjDict, AcDb::kForRead);
   
8.     AcDbDictionary *pDict = NULL;
   
9.     es = pNameObjDict->getAt(TEXT("MyDict"), (AcDbObject*&)pDict, AcDb::kForRead);
   
10.     pNameObjDict->close();
    
11. 
    
12.     // 如果不存在指定的字典项，退出程序
    
13.     if (es == Acad::eKeyNotFound)
    
14.     {
    
15.       acutPrintf(TEXT("\n不存在字典项MyDict."));
    
16.       return;
    
17.     }
    
18. 
    
19.     // 获得指定的对象字典中的对象
    
20.     AcDbBlockTableRecord *pBlockRecord = NULL;
    
21.     if (pDict->getAt(TEXT("BlockKey"), (AcDbObject*&)pBlockRecord, AcDb::kForRead) == Acad::eOk)
    
22.     {
    
23.       CString sName;
    
24.       ACHAR* chName = new ACHAR;
    
25.       pBlockRecord->pathName(chName);
    
26.       pBlockRecord->close();
    
27.       acutPrintf(TEXT("\n当前文件链接的文件为: %s"), chName);
    
28.       if (chName)
    
29.       {
    
30.         delete chName;
    
31.         chName = nullptr;
    
32.       }
    
33.     }
    
34.     pDict->close();
    
35.   }
    

复制代码

4、源码地址
下载地址
转载自＜四＞objectARX开发：扩展数据XData、扩展记录XRecord和有名对象字典NameDict_arx2017开发输入命令输出xdata-CSDN博客