这篇笔记是ObjectARX开发系列的第五篇主题叫“符号表总述”。如果你已经在用ObjectARX做AutoCAD二次开发大概早就和图层、线型、文字样式、标注样式打过照面——这些东西在数据库里都以“符号表”的形式存在。符号表是AutoCAD数据库里最基础、也最集中的一块结构几乎所有命名对象都能在里面找到对应的“档案”理解它之后很多看似零散的ARX操作都能串成一条线。适合正在学ObjectARX的开发者也适合从AutoLISP转型过来的朋友参考。我用“总述”这个词是想先把整个符号表家族讲清楚它在数据库里处于什么位置、由哪些类构成、怎么遍历、怎么增删改查以及实际开发里最容易踩的坑。这应该是目前网上相对少见的一篇系统整理内容不涉及某个具体业务功能但你看完会发现之后的图层管理、块操作、文字样式处理等需求基本都能在这套模板上套出来。1. 符号表到底是什么1.1 从AutoCAD面板背后的数据库说起你在AutoCAD里打开图层面板看到一行行图层名称打开线型管理器看到不同的线型定义打开文字样式对话框看到一堆样式名和字体设置。这些界面操作背后其实就是数据库里的一张张表。ObjectARX把AutoCAD的图形文件DWG看作一个数据库这个数据库包含很多组成部分符号表就是其中一个非常重要的区域。每一张符号表负责管理一种“命名对象”比如图层表记录所有图层定义以及每个图层的颜色、线型、开关状态等线型表记录所有已加载的线型定义文字样式表记录文字样式名、字体、高度、宽度因子等参数标注样式表记录标注样式的各种尺寸参数块表记录图纸里的所有块定义包括模型空间和图纸空间注册应用表记录当前图纸中注册过的扩展程序名。从ARX开发者的眼睛看出去这些表有一个统一的模型数据库下面挂着若干张符号表每张符号表里面有一条条符号表记录。符号表提供“按名称查找”的能力记录则保存具体属性的数据。两者配合就能把用户在界面上看到的那些“定义项”完整地组织起来。1.2 为什么说它是ARX开发的第一道门槛大部分ObjectARX入门者学完“如何打开数据库、如何遍历实体”之后都会卡在同一个地方怎么找到某个图层怎么判断某个文字样式是否存在怎么在模型空间里加一个块引用这些问题只要理清符号表就全部迎刃而解。因为它们的答案都指向同一个流程先拿到对应的符号表再在表里按名称找到或新建一条记录最后把这条记录关联到你的业务上。举个最简单的例子你要在图层“S_DIM”上画线。如果不预先创建这个图层就算你在代码里给直线设置了一个看似正确的图层名图形对象也不会自动获得一个已存在的图层。你必须在图层表里先找到或创建名为“S_DIM”的记录拿到它的对象ID再把这个ID赋给实体。这个三步走的模式贯穿整个符号表开发。另外很多初学者会把符号表和命名对象字典搞混。命名对象字典是另一套按名称组织的容器它更通用可以存放任意对象符号表则是有固定结构和固定记录类型的容器。比如你可以往字典里塞一个自定义对象但你不能往图层表里塞一个文字样式记录。理解这两者的区别能避免后期封装代码时选错容器。如果把AutoCAD数据库比喻成一座城市符号表就是城市的户籍系统记录是每个居民的档案迭代器则是帮你挨家挨户核对档案的工作人员。城市管理、人口统计、房屋分配方方面面都离不开这套底账。ARX开发里处理图层、样式、块定义本质上都是在和这套底账打交道。2. 类族拆解表、记录、迭代器2.1 三个基类一条主线ObjectARX的符号表体系用三个抽象基类撑起整个家族AcDbSymbolTable、AcDbSymbolTableRecord、AcDbSymbolTableIterator。你不需要记住每个派生类但你一定要理解这三个基类之间的关系。AcDbSymbolTable是所有符号表的基类它定义了符号表对外的基本能力比如按名称查找记录getAt、判断记录是否存在has、向表中添加记录add以及创建迭代器newIterator。你在代码里拿到的AcDbLayerTable、AcDbLinetypeTable、AcDbBlockTable全部继承自它。AcDbSymbolTableRecord是所有符号表记录的基类。它本身继承自AcDbObject所以具备对象ID、打开/关闭、擦除、扩展数据等所有数据库对象通用的能力。同时它还自带一个关键属性名称name。每条记录靠名称在同一张表里保持唯一。AcDbSymbolTableIterator是符号表专用的迭代器。它负责按顺序访问符号表里的每一条记录。由于记录本身是对象迭代器不直接返回记录而是返回记录的对象ID或者在你要求时直接打开记录指针。这三个基类合在一起构成了一个非常整齐的访问模式。不管操作哪张符号表代码骨架都一样打开表、创建迭代器、循环遍历、按需处理记录、关闭表。差别只在于表类和记录类的具体类型不同。2.2 符号表如何挂在数据库下面每一张符号表都从当前数据库对象AcDbDatabase里获取。你可以通过数据库提供的方法拿到特定符号表比如getLayerTable拿到图层表、getBlockTable拿到块表。拿到之后表对象就像数据库的子对象一样挂靠在数据库上。这里有个容易被忽略的点符号表本身也是一个数据库对象使用完之后必须关闭。很多人以为只有记录需要close结果表对象一直处于打开状态后面再用写模式打开同一张表时会提示对象已经被打开排查半天找不到原因。以图层表为例标准写法是这样AcDbDatabase* pDb acdbHostApplicationServices()-workingDatabase(); AcDbLayerTable* pLayerTable nullptr; if (pDb-getLayerTable(pLayerTable, AcDb::kForRead) ! Acad::eOk) { return; } // 在这里使用pLayerTable pLayerTable-close();注意这里的AcDbLayerTable指针是从数据库中打开的它和new出来的普通对象不一样不能用delete释放必须调用close。close之后它的对象ID依然存在只是不再被当前进程以打开状态持有。2.3 记录对象的通用行为符号表记录作为AcDbObject的子类有一套统一的“通用行为”。首先是打开方式记录可以通过acdbOpenObject打开也可以通过迭代器直接打开。打开时有三种模式kForRead只读、kForWrite可写、kForNotify通知。日常开发里前两种用得最多。其次是名称属性。每条记录都有name操作时用名称来定位记录。AutoCAD对符号名有一些限制比如不能为空、不能包含非法字符、长度不能超过255个字符。不同符号表对这个上限可能还有额外限制稳妥的做法是控制在255以内但实际项目里通常用不超过31个字符的命名规范可以避免老版本图纸和特殊字符带来的兼容问题。还有一个非常实用的能力是扩展数据XDATA。符号表记录允许挂接自定义数据比如给图层记录加一段备注信息、给文字样式记录打一个程序内部标识。很多图纸管理插件就是靠这个给图层打标记的不需要额外建一张映射表。记录对象同样遵循open与close配对原则。打开记录后如果不close后续对这条记录再进行写操作会失败而且在长时间运行的进程里未关闭对象会持续增长拖慢整个宿主程序。3. 一套通用的遍历模板3.1 从拿表到遍历的完整代码遍历符号表是ObjectARX开发最常用的操作。不管是统计图层数量、批量整理线型还是导出文字样式清单最终都会落到“打开表、建迭代器、逐条处理”这套流程上。下面以遍历图层表为例给出一个完整的可运行骨架AcDbDatabase* pDb acdbHostApplicationServices()-workingDatabase(); AcDbLayerTable* pLayerTable nullptr; if (pDb-getLayerTable(pLayerTable, AcDb::kForRead) ! Acad::eOk) { return; } AcDbLayerTableIterator* pIter nullptr; if (pLayerTable-newIterator(pIter) ! Acad::eOk) { pLayerTable-close(); return; } for (pIter-start(); !pIter-done(); pIter-step()) { AcDbObjectId recordId; if (pIter-getRecordId(recordId) ! Acad::eOk) { continue; } AcDbLayerTableRecord* pRec nullptr; if (acdbOpenObject(pRec, recordId, AcDb::kForRead) Acad::eOk) { const ACHAR* layerName pRec-name(); acutPrintf(L图层%s\n, layerName); pRec-close(); } } delete pIter; pLayerTable-close();这段代码有几点值得展开说。newIterator创建出来的迭代器不是AcDbObject不归数据库管用完要delete。很多人会把delete漏掉短小工具命令里影响不大但在长时间运行的插件里每次遍历都泄漏一个迭代器内存会慢慢涨上去。迭代器内部维护当前位置start把游标移到开头done判断是否到达末尾step推进到下一条。这套接口所有符号表迭代器都一样所以你可以把这套模板抽成一个通用函数只把表指针和记录处理函数作为参数传进去。acdbOpenObject按recordId打开记录。打开成功后要记得close。如果打开失败pRec指针不会被赋值所以后续处理要放在成功分支里避免空指针调用。3.2 遍历时为什么不能随手改表很多新手一开始都会这么写遍历图层表发现某个图层多余了顺手把它erase掉或者遍历文字样式表发现缺了某个样式直接add一条。结果代码跑起来不是崩溃就是行为诡异。原因在于迭代器依赖符号表底层的存储状态。你在遍历过程中对表进行了结构变化比如新增记录或删除记录迭代器内部的索引可能会失效。表现有时候是漏掉几条记录有时候是重复处理某条记录严重的时候直接访问了已经被释放的内存。正确做法是把遍历和修改分成两个阶段。遍历阶段只收集对象ID或者只记录你想处理的对象ID遍历结束后再统一对收集到的ID执行新增、删除、修改操作。这样符号表在整个遍历期间保持稳定不会出幺蛾子。我用这个思路做过一个清理脚本批量删除一批空图层。先遍历图层表把符合条件的图层ID放进一个数组等循环结束后再逐个打开、逐个erase。整个过程非常平稳没有出现过一次崩溃。4. 新增、查询与删除记录4.1 新增一个图层的完整流程新增记录是符号表开发里最经典的操作。不管新增图层、线型还是文字样式流程都一样new一条记录、设置属性、设置名称、把记录add到对应的表里、关闭表和记录。下面以新建图层为例AcDbDatabase* pDb acdbHostApplicationServices()-workingDatabase(); AcDbLayerTable* pLayerTable nullptr; if (pDb-getLayerTable(pLayerTable, AcDb::kForWrite) ! Acad::eOk) { return; } AcDbLayerTableRecord* pRec new AcDbLayerTableRecord(); pRec-setName(LPLAN_A_LAYER); AcCmColor color; color.setColorIndex(1); // 红色 pRec-setColor(color); AcDbObjectId newLayerId; Acad::ErrorStatus es pLayerTable-add(newLayerId, pRec); if (es ! Acad::eOk) { delete pRec; pLayerTable-close(); return; } pLayerTable-close(); pRec-close();这个例子看起来简单但有几个容易踩到的位置需要说明。第一pRec是new出来的对象在add成功之前它还不属于数据库。如果add失败必须自己delete否则就泄漏了。add成功后记录归数据库管理不能再delete只需close。第二add之前表必须以kForWrite打开。很多从教程里复制代码的人会先以kForRead打开表然后调add结果返回eOpenModeMismatch。如果业务上必须先读后写可以用upgradeOpen把只读升级成写模式操作完再downgradeOpen降回只读但最简单的思路就是直接以写模式打开。第三setName后add之前最好先用has判断一下同名记录是否存在。如果已存在直接add会失败也可能重复创建名称相同的记录造成后续混乱。先判断再创建是更稳妥的范式。4.2 查询记录has与getAt查询记录是否存在的标准接口是has传入名称返回布尔值。如果需要拿到记录ID则使用getAtAcDbLayerTable* pLayerTable nullptr; if (pDb-getLayerTable(pLayerTable, AcDb::kForRead) ! Acad::eOk) { return; } if (pLayerTable-has(LPLAN_A_LAYER)) { AcDbObjectId layerId; pLayerTable-getAt(LPLAN_A_LAYER, layerId); // 后续可以用layerId打开记录 } pLayerTable-close();这里有一点要注意AutoCAD的符号表在名称匹配上通常不区分大小写但名称本身会按创建时的写法保存在数据库中。也就是说你创建了一个叫“PLAN_A_LAYER”的图层用getAt(Lplan_a_layer)通常也能查到。这个行为在实际使用中比较友好不过也让一些人养成了随手写名称的坏习惯。一旦项目里的符号名称大小写不统一排查起来很花时间。我的经验是所有符号名称统一使用大写加下划线的风格并且在代码里用常量或宏统一管理绝对不在业务逻辑里散落字符串字面量。这样哪怕底层匹配不区分大小写代码的可读性和可维护性也不会失控。4.3 删除记录的三个前置条件删除符号表记录比新增要谨慎得多。删除本身在ARX层面只是把记录erase掉但这条记录可能被其他对象引用。先看基础删除代码AcDbLayerTable* pLayerTable nullptr; pDb-getLayerTable(pLayerTable, AcDb::kForRead); AcDbObjectId layerId; if (pLayerTable-getAt(LPLAN_A_LAYER, layerId) ! Acad::eOk) { pLayerTable-close(); return; } pLayerTable-close(); AcDbLayerTableRecord* pRec nullptr; if (acdbOpenObject(pRec, layerId, AcDb::kForWrite) Acad::eOk) { pRec-erase(); pRec-close(); }这段代码能执行但实际业务里往往不会这么简单。删除前你要确认三件事。第一这条记录是否被实体或其他对象引用。以图层为例如果图纸里还有实体挂在“PLAN_A_LAYER”图层上直接erase图层轻则报错重则在后续保存或重生成时产生不可预料的状况。很多插件先判断pRec-isUsed()如果有引用就拒绝删除。第二是否存在与这条记录强关联的依赖对象。比如删除一个文字样式而这个样式正被某些标注样式或者文字实体使用就可能触发依赖检查。这种情况下即使erase成功相关实体显示也会异常。第三涉及块表记录时更特殊。块表记录的删除不只是erase因为块表记录里面的实体也需要一并处理。如果你想删除一个块定义但图纸里还存在这个块的引用erase往往会被拒绝。正确顺序是先删除或清理所有块引用再删除块定义。我建议把“删除符号表记录”封装成一个独立的工具函数函数里先做引用检查再执行删除最后把错误码详细记录下来。这样业务代码调用起来非常省心。5. 常用符号表逐个拆解5.1 最常见的四张表符号表记录类获取方式记录内容典型场景图层表 AcDbLayerTableAcDbLayerTableRecordgetLayerTable图层名、颜色、线型、开关、冻结、锁定图层创建、批量设置、图纸整理线型表 AcDbLinetypeTableAcDbLinetypeTableRecordgetLinetypeTable线型名、线型定义数据加载线型、设置实体线型文字样式表 AcDbTextStyleTableAcDbTextStyleTableRecordgetTextStyleTable字体名、字高、宽度因子、倾斜角创建文字、统一替换字体标注样式表 AcDbDimStyleTableAcDbDimStyleTableRecordgetDimStyleTable标注变量集合创建标注、按专业切样式图层表是最常打交道的表。它除了名称还有一大堆绘图状态属性比如颜色、线型、打印样式、透明度、开关状态。ARX里操作这些属性本质上就是对AcDbLayerTableRecord的各种set方法调用。线型表要留意的点是图纸中线型必须先“加载”到线型表里实体才能引用。你在界面上加载过线型ARX里就不用重复做但如果是脚本批量处理经常要检查线型是否存在不存在时先把线型定义写入线型表然后再给实体赋值。文字样式表和标注样式表在工程图纸里尤其重要。很多项目要求所有文字统一使用某一种样式或者某张图纸的标注样式必须符合单位标准。这类批量修正任务几乎都是“遍历符号表记录按名称匹配更新属性”的模式。5.2 块表符号表里的“异类”块表虽然也是符号表但它比前面几张表特殊很多。它的记录不是普通的样式定义而是实实在在的“容器”——AcDbBlockTableRecord。模型空间、图纸空间以及所有块定义都是块表里的一条记录。初学者最容易在这里绕晕想在模型空间里加一条直线结果去块表里add记录搞了半天直线却跑进了一个莫名其妙的新块定义里。正确思路是实体对象不是直接加到块表而是加到块表记录里。模型空间本身就是一个块表记录你要先通过块表拿到模型空间的记录ID再往这条记录里追加实体。典型代码AcDbDatabase* pDb acdbHostApplicationServices()-workingDatabase(); AcDbBlockTable* pBlockTable nullptr; if (pDb-getBlockTable(pBlockTable, AcDb::kForRead) ! Acad::eOk) { return; } AcDbObjectId modelSpaceId; if (pBlockTable-getAt(ACDB_MODEL_SPACE, modelSpaceId) ! Acad::eOk) { pBlockTable-close(); return; } pBlockTable-close(); AcDbBlockTableRecord* pModelSpace nullptr; if (acdbOpenObject(pModelSpace, modelSpaceId, AcDb::kForWrite) Acad::eOk) { AcDbLine* pLine new AcDbLine(startPt, endPt); AcDbObjectId lineId; pModelSpace-appendAcDbEntity(lineId, pLine); pLine-close(); pModelSpace-close(); }这段代码把“块表”和“块表记录”两个层次区分得很清楚。块表负责按名称找记录块表记录负责装实体。理解这个层次后你对AutoCAD数据库的认知就会从“一张大表”升级为“数据库下面挂表、表下面挂记录、记录里再挂实体”的树状结构。5.3 容易被忽略的注册应用表在所有符号表里注册应用表AcDbRegAppTable的存在感最低但它其实值得单独记一笔。它的记录类型是AcDbRegAppTableRecord保存的是图纸中出现的扩展程序注册名。什么时候会用上它呢当你给实体或符号表记录写扩展数据XDATA时系统要求注册一个应用名这个名字就保存在注册应用表里。如果名字不存在写入扩展数据会失败或者产生警告。很多插件会先检查注册应用表没有对应记录就主动创建一条这样后面写XDATA才顺畅。注册应用表的操作和图层表完全一致只是记录类不同。这也再次说明把符号表当成一个统一模型来学比一项项孤立地背API效率高得多。你只要把“表、记录、迭代器、增删改查”这套骨架搭起来任何一张符号表都能快速上手。6. 踩过的坑和排查思路6.1 名称大小写不一致符号表名称匹配不区分大小写但名称保存时会保留创建时的写法。这个特性本身不是坑真正的坑出现在团队协作中有人用大写建图层有人用驼峰引用代码里getAt传参五花八门结果排查问题时很难一眼看出“代码里引用的图层”和“表里实际存在的图层”是不是同一个。排查思路很简单统一命名规范必要时在工具启动时把图层名全部转成大写打印出来。另外一个实用技巧是不要相信记忆遇到符号不存在时先用has判断再把表里相近名称的记录打印出来核对。很多“找不到图层”的问题最后都是少了一个下划线或者多了个空格。符号名里的空格也是隐性杀手。用户在界面上可以创建带空格的图层名比如“S - DIM”代码里拼字符串时很容易多拼一个或少拼一个空格。建议在解析外部配置或用户输入时对符号名称做一次trim处理。6.2 open与close不成对这是对象ARX开发里出现频率最高的问题没有之一。每open一个对象就对应一次close。很多人只记着open忘了close短期内程序不会报错但对象长时间保持打开状态后面再以写模式打开同一个对象时会失败或者出现无法预料的锁定问题。我调试过这样一个案例某个批量处理命令运行第二次时总是报“对象已锁定”重启AutoCAD后又正常。最后定位到是第一次运行里有个记录没有close导致对象一直处于打开状态后续命令再次以写模式打开直接冲突。排查这类问题有一个笨办法在可疑代码附近加日志打印每个open和close的配对情况。也可以借助调试器查看对象状态。最有效的还是养成写完代码回头数一遍open和close的习惯每个代码块的尾部必须保证配对。6.3 迭代器失效前面提到遍历过程中不要结构性修改符号表这里再说一个更隐蔽的变体遍历时虽然没修改符号表本身但打开了某条记录并把它erase。这个操作同样会影响迭代器。建议把“遍历”和“修改”严格分成两步。先循环收集对象ID再循环处理对象ID两个循环之间没有任何交错。这个方法简单却能让代码稳很多。我自己写清理工具时已经固定用这个模式没有再出现过迭代器相关崩溃。6.4 删图层把实体“删没了”很多人在ARX里删图层时做过这样的假设图层删掉图层上的实体还在只是变成无图层状态。实际情况没有那么乐观尤其在引用关系复杂时直接erase图层可能导致实体显示异常甚至数据错误。正确做法是分三步先把该图层上的实体转移到其他图层或者删除这些实体再检查块表里是否有块定义引用该图层最后才执行图层记录的erase。有一个保险做法是使用pRec-isUsed()先判断如果有引用就中止删除并把涉及的对象ID收集起来打印给调用方。我建议在业务代码里不要直接调用图层记录的erase而是封装一个名为“DeleteLayerSafe”的函数内部处理引用检查和转移逻辑。这样即便以后需求变化也只需要改一个工具函数不用满项目去查找删图层的调用点。写到这里顺便说点我自己的习惯。我每次接触一张新的符号表不会急着看它有哪些专属API而是先写一个通用遍历工具把这张表的所有记录名称和类别打印出来。跑一次心里就有底了。你想掌握符号表最快的方式就是拿图层表和文字样式表练手新建、查询、修改、删除各写一遍再把块表的模型空间操作过一遍。这几张表跑通之后整个符号表体系对你来说就不再是一个抽象概念而是非常具体的代码模式了。后续做批量图纸处理、样式统一、图层标准化这些需求时你会发现这套功底相当值钱。
这篇笔记是ObjectARX开发系列的第五篇主题叫“符号表总述”。如果你已经在用ObjectARX做AutoCAD二次开发大概早就和图层、线型、文字样式、标注样式打过照面——这些东西在数据库里都以“符号表”的形式存在。符号表是AutoCAD数据库里最基础、也最集中的一块结构几乎所有命名对象都能在里面找到对应的“档案”理解它之后很多看似零散的ARX操作都能串成一条线。适合正在学ObjectARX的开发者也适合从AutoLISP转型过来的朋友参考。我用“总述”这个词是想先把整个符号表家族讲清楚它在数据库里处于什么位置、由哪些类构成、怎么遍历、怎么增删改查以及实际开发里最容易踩的坑。这应该是目前网上相对少见的一篇系统整理内容不涉及某个具体业务功能但你看完会发现之后的图层管理、块操作、文字样式处理等需求基本都能在这套模板上套出来。1. 符号表到底是什么1.1 从AutoCAD面板背后的数据库说起你在AutoCAD里打开图层面板看到一行行图层名称打开线型管理器看到不同的线型定义打开文字样式对话框看到一堆样式名和字体设置。这些界面操作背后其实就是数据库里的一张张表。ObjectARX把AutoCAD的图形文件DWG看作一个数据库这个数据库包含很多组成部分符号表就是其中一个非常重要的区域。每一张符号表负责管理一种“命名对象”比如图层表记录所有图层定义以及每个图层的颜色、线型、开关状态等线型表记录所有已加载的线型定义文字样式表记录文字样式名、字体、高度、宽度因子等参数标注样式表记录标注样式的各种尺寸参数块表记录图纸里的所有块定义包括模型空间和图纸空间注册应用表记录当前图纸中注册过的扩展程序名。从ARX开发者的眼睛看出去这些表有一个统一的模型数据库下面挂着若干张符号表每张符号表里面有一条条符号表记录。符号表提供“按名称查找”的能力记录则保存具体属性的数据。两者配合就能把用户在界面上看到的那些“定义项”完整地组织起来。1.2 为什么说它是ARX开发的第一道门槛大部分ObjectARX入门者学完“如何打开数据库、如何遍历实体”之后都会卡在同一个地方怎么找到某个图层怎么判断某个文字样式是否存在怎么在模型空间里加一个块引用这些问题只要理清符号表就全部迎刃而解。因为它们的答案都指向同一个流程先拿到对应的符号表再在表里按名称找到或新建一条记录最后把这条记录关联到你的业务上。举个最简单的例子你要在图层“S_DIM”上画线。如果不预先创建这个图层就算你在代码里给直线设置了一个看似正确的图层名图形对象也不会自动获得一个已存在的图层。你必须在图层表里先找到或创建名为“S_DIM”的记录拿到它的对象ID再把这个ID赋给实体。这个三步走的模式贯穿整个符号表开发。另外很多初学者会把符号表和命名对象字典搞混。命名对象字典是另一套按名称组织的容器它更通用可以存放任意对象符号表则是有固定结构和固定记录类型的容器。比如你可以往字典里塞一个自定义对象但你不能往图层表里塞一个文字样式记录。理解这两者的区别能避免后期封装代码时选错容器。如果把AutoCAD数据库比喻成一座城市符号表就是城市的户籍系统记录是每个居民的档案迭代器则是帮你挨家挨户核对档案的工作人员。城市管理、人口统计、房屋分配方方面面都离不开这套底账。ARX开发里处理图层、样式、块定义本质上都是在和这套底账打交道。2. 类族拆解表、记录、迭代器2.1 三个基类一条主线ObjectARX的符号表体系用三个抽象基类撑起整个家族AcDbSymbolTable、AcDbSymbolTableRecord、AcDbSymbolTableIterator。你不需要记住每个派生类但你一定要理解这三个基类之间的关系。AcDbSymbolTable是所有符号表的基类它定义了符号表对外的基本能力比如按名称查找记录getAt、判断记录是否存在has、向表中添加记录add以及创建迭代器newIterator。你在代码里拿到的AcDbLayerTable、AcDbLinetypeTable、AcDbBlockTable全部继承自它。AcDbSymbolTableRecord是所有符号表记录的基类。它本身继承自AcDbObject所以具备对象ID、打开/关闭、擦除、扩展数据等所有数据库对象通用的能力。同时它还自带一个关键属性名称name。每条记录靠名称在同一张表里保持唯一。AcDbSymbolTableIterator是符号表专用的迭代器。它负责按顺序访问符号表里的每一条记录。由于记录本身是对象迭代器不直接返回记录而是返回记录的对象ID或者在你要求时直接打开记录指针。这三个基类合在一起构成了一个非常整齐的访问模式。不管操作哪张符号表代码骨架都一样打开表、创建迭代器、循环遍历、按需处理记录、关闭表。差别只在于表类和记录类的具体类型不同。2.2 符号表如何挂在数据库下面每一张符号表都从当前数据库对象AcDbDatabase里获取。你可以通过数据库提供的方法拿到特定符号表比如getLayerTable拿到图层表、getBlockTable拿到块表。拿到之后表对象就像数据库的子对象一样挂靠在数据库上。这里有个容易被忽略的点符号表本身也是一个数据库对象使用完之后必须关闭。很多人以为只有记录需要close结果表对象一直处于打开状态后面再用写模式打开同一张表时会提示对象已经被打开排查半天找不到原因。以图层表为例标准写法是这样AcDbDatabase* pDb acdbHostApplicationServices()-workingDatabase(); AcDbLayerTable* pLayerTable nullptr; if (pDb-getLayerTable(pLayerTable, AcDb::kForRead) ! Acad::eOk) { return; } // 在这里使用pLayerTable pLayerTable-close();注意这里的AcDbLayerTable指针是从数据库中打开的它和new出来的普通对象不一样不能用delete释放必须调用close。close之后它的对象ID依然存在只是不再被当前进程以打开状态持有。2.3 记录对象的通用行为符号表记录作为AcDbObject的子类有一套统一的“通用行为”。首先是打开方式记录可以通过acdbOpenObject打开也可以通过迭代器直接打开。打开时有三种模式kForRead只读、kForWrite可写、kForNotify通知。日常开发里前两种用得最多。其次是名称属性。每条记录都有name操作时用名称来定位记录。AutoCAD对符号名有一些限制比如不能为空、不能包含非法字符、长度不能超过255个字符。不同符号表对这个上限可能还有额外限制稳妥的做法是控制在255以内但实际项目里通常用不超过31个字符的命名规范可以避免老版本图纸和特殊字符带来的兼容问题。还有一个非常实用的能力是扩展数据XDATA。符号表记录允许挂接自定义数据比如给图层记录加一段备注信息、给文字样式记录打一个程序内部标识。很多图纸管理插件就是靠这个给图层打标记的不需要额外建一张映射表。记录对象同样遵循open与close配对原则。打开记录后如果不close后续对这条记录再进行写操作会失败而且在长时间运行的进程里未关闭对象会持续增长拖慢整个宿主程序。3. 一套通用的遍历模板3.1 从拿表到遍历的完整代码遍历符号表是ObjectARX开发最常用的操作。不管是统计图层数量、批量整理线型还是导出文字样式清单最终都会落到“打开表、建迭代器、逐条处理”这套流程上。下面以遍历图层表为例给出一个完整的可运行骨架AcDbDatabase* pDb acdbHostApplicationServices()-workingDatabase(); AcDbLayerTable* pLayerTable nullptr; if (pDb-getLayerTable(pLayerTable, AcDb::kForRead) ! Acad::eOk) { return; } AcDbLayerTableIterator* pIter nullptr; if (pLayerTable-newIterator(pIter) ! Acad::eOk) { pLayerTable-close(); return; } for (pIter-start(); !pIter-done(); pIter-step()) { AcDbObjectId recordId; if (pIter-getRecordId(recordId) ! Acad::eOk) { continue; } AcDbLayerTableRecord* pRec nullptr; if (acdbOpenObject(pRec, recordId, AcDb::kForRead) Acad::eOk) { const ACHAR* layerName pRec-name(); acutPrintf(L图层%s\n, layerName); pRec-close(); } } delete pIter; pLayerTable-close();这段代码有几点值得展开说。newIterator创建出来的迭代器不是AcDbObject不归数据库管用完要delete。很多人会把delete漏掉短小工具命令里影响不大但在长时间运行的插件里每次遍历都泄漏一个迭代器内存会慢慢涨上去。迭代器内部维护当前位置start把游标移到开头done判断是否到达末尾step推进到下一条。这套接口所有符号表迭代器都一样所以你可以把这套模板抽成一个通用函数只把表指针和记录处理函数作为参数传进去。acdbOpenObject按recordId打开记录。打开成功后要记得close。如果打开失败pRec指针不会被赋值所以后续处理要放在成功分支里避免空指针调用。3.2 遍历时为什么不能随手改表很多新手一开始都会这么写遍历图层表发现某个图层多余了顺手把它erase掉或者遍历文字样式表发现缺了某个样式直接add一条。结果代码跑起来不是崩溃就是行为诡异。原因在于迭代器依赖符号表底层的存储状态。你在遍历过程中对表进行了结构变化比如新增记录或删除记录迭代器内部的索引可能会失效。表现有时候是漏掉几条记录有时候是重复处理某条记录严重的时候直接访问了已经被释放的内存。正确做法是把遍历和修改分成两个阶段。遍历阶段只收集对象ID或者只记录你想处理的对象ID遍历结束后再统一对收集到的ID执行新增、删除、修改操作。这样符号表在整个遍历期间保持稳定不会出幺蛾子。我用这个思路做过一个清理脚本批量删除一批空图层。先遍历图层表把符合条件的图层ID放进一个数组等循环结束后再逐个打开、逐个erase。整个过程非常平稳没有出现过一次崩溃。4. 新增、查询与删除记录4.1 新增一个图层的完整流程新增记录是符号表开发里最经典的操作。不管新增图层、线型还是文字样式流程都一样new一条记录、设置属性、设置名称、把记录add到对应的表里、关闭表和记录。下面以新建图层为例AcDbDatabase* pDb acdbHostApplicationServices()-workingDatabase(); AcDbLayerTable* pLayerTable nullptr; if (pDb-getLayerTable(pLayerTable, AcDb::kForWrite) ! Acad::eOk) { return; } AcDbLayerTableRecord* pRec new AcDbLayerTableRecord(); pRec-setName(LPLAN_A_LAYER); AcCmColor color; color.setColorIndex(1); // 红色 pRec-setColor(color); AcDbObjectId newLayerId; Acad::ErrorStatus es pLayerTable-add(newLayerId, pRec); if (es ! Acad::eOk) { delete pRec; pLayerTable-close(); return; } pLayerTable-close(); pRec-close();这个例子看起来简单但有几个容易踩到的位置需要说明。第一pRec是new出来的对象在add成功之前它还不属于数据库。如果add失败必须自己delete否则就泄漏了。add成功后记录归数据库管理不能再delete只需close。第二add之前表必须以kForWrite打开。很多从教程里复制代码的人会先以kForRead打开表然后调add结果返回eOpenModeMismatch。如果业务上必须先读后写可以用upgradeOpen把只读升级成写模式操作完再downgradeOpen降回只读但最简单的思路就是直接以写模式打开。第三setName后add之前最好先用has判断一下同名记录是否存在。如果已存在直接add会失败也可能重复创建名称相同的记录造成后续混乱。先判断再创建是更稳妥的范式。4.2 查询记录has与getAt查询记录是否存在的标准接口是has传入名称返回布尔值。如果需要拿到记录ID则使用getAtAcDbLayerTable* pLayerTable nullptr; if (pDb-getLayerTable(pLayerTable, AcDb::kForRead) ! Acad::eOk) { return; } if (pLayerTable-has(LPLAN_A_LAYER)) { AcDbObjectId layerId; pLayerTable-getAt(LPLAN_A_LAYER, layerId); // 后续可以用layerId打开记录 } pLayerTable-close();这里有一点要注意AutoCAD的符号表在名称匹配上通常不区分大小写但名称本身会按创建时的写法保存在数据库中。也就是说你创建了一个叫“PLAN_A_LAYER”的图层用getAt(Lplan_a_layer)通常也能查到。这个行为在实际使用中比较友好不过也让一些人养成了随手写名称的坏习惯。一旦项目里的符号名称大小写不统一排查起来很花时间。我的经验是所有符号名称统一使用大写加下划线的风格并且在代码里用常量或宏统一管理绝对不在业务逻辑里散落字符串字面量。这样哪怕底层匹配不区分大小写代码的可读性和可维护性也不会失控。4.3 删除记录的三个前置条件删除符号表记录比新增要谨慎得多。删除本身在ARX层面只是把记录erase掉但这条记录可能被其他对象引用。先看基础删除代码AcDbLayerTable* pLayerTable nullptr; pDb-getLayerTable(pLayerTable, AcDb::kForRead); AcDbObjectId layerId; if (pLayerTable-getAt(LPLAN_A_LAYER, layerId) ! Acad::eOk) { pLayerTable-close(); return; } pLayerTable-close(); AcDbLayerTableRecord* pRec nullptr; if (acdbOpenObject(pRec, layerId, AcDb::kForWrite) Acad::eOk) { pRec-erase(); pRec-close(); }这段代码能执行但实际业务里往往不会这么简单。删除前你要确认三件事。第一这条记录是否被实体或其他对象引用。以图层为例如果图纸里还有实体挂在“PLAN_A_LAYER”图层上直接erase图层轻则报错重则在后续保存或重生成时产生不可预料的状况。很多插件先判断pRec-isUsed()如果有引用就拒绝删除。第二是否存在与这条记录强关联的依赖对象。比如删除一个文字样式而这个样式正被某些标注样式或者文字实体使用就可能触发依赖检查。这种情况下即使erase成功相关实体显示也会异常。第三涉及块表记录时更特殊。块表记录的删除不只是erase因为块表记录里面的实体也需要一并处理。如果你想删除一个块定义但图纸里还存在这个块的引用erase往往会被拒绝。正确顺序是先删除或清理所有块引用再删除块定义。我建议把“删除符号表记录”封装成一个独立的工具函数函数里先做引用检查再执行删除最后把错误码详细记录下来。这样业务代码调用起来非常省心。5. 常用符号表逐个拆解5.1 最常见的四张表符号表记录类获取方式记录内容典型场景图层表 AcDbLayerTableAcDbLayerTableRecordgetLayerTable图层名、颜色、线型、开关、冻结、锁定图层创建、批量设置、图纸整理线型表 AcDbLinetypeTableAcDbLinetypeTableRecordgetLinetypeTable线型名、线型定义数据加载线型、设置实体线型文字样式表 AcDbTextStyleTableAcDbTextStyleTableRecordgetTextStyleTable字体名、字高、宽度因子、倾斜角创建文字、统一替换字体标注样式表 AcDbDimStyleTableAcDbDimStyleTableRecordgetDimStyleTable标注变量集合创建标注、按专业切样式图层表是最常打交道的表。它除了名称还有一大堆绘图状态属性比如颜色、线型、打印样式、透明度、开关状态。ARX里操作这些属性本质上就是对AcDbLayerTableRecord的各种set方法调用。线型表要留意的点是图纸中线型必须先“加载”到线型表里实体才能引用。你在界面上加载过线型ARX里就不用重复做但如果是脚本批量处理经常要检查线型是否存在不存在时先把线型定义写入线型表然后再给实体赋值。文字样式表和标注样式表在工程图纸里尤其重要。很多项目要求所有文字统一使用某一种样式或者某张图纸的标注样式必须符合单位标准。这类批量修正任务几乎都是“遍历符号表记录按名称匹配更新属性”的模式。5.2 块表符号表里的“异类”块表虽然也是符号表但它比前面几张表特殊很多。它的记录不是普通的样式定义而是实实在在的“容器”——AcDbBlockTableRecord。模型空间、图纸空间以及所有块定义都是块表里的一条记录。初学者最容易在这里绕晕想在模型空间里加一条直线结果去块表里add记录搞了半天直线却跑进了一个莫名其妙的新块定义里。正确思路是实体对象不是直接加到块表而是加到块表记录里。模型空间本身就是一个块表记录你要先通过块表拿到模型空间的记录ID再往这条记录里追加实体。典型代码AcDbDatabase* pDb acdbHostApplicationServices()-workingDatabase(); AcDbBlockTable* pBlockTable nullptr; if (pDb-getBlockTable(pBlockTable, AcDb::kForRead) ! Acad::eOk) { return; } AcDbObjectId modelSpaceId; if (pBlockTable-getAt(ACDB_MODEL_SPACE, modelSpaceId) ! Acad::eOk) { pBlockTable-close(); return; } pBlockTable-close(); AcDbBlockTableRecord* pModelSpace nullptr; if (acdbOpenObject(pModelSpace, modelSpaceId, AcDb::kForWrite) Acad::eOk) { AcDbLine* pLine new AcDbLine(startPt, endPt); AcDbObjectId lineId; pModelSpace-appendAcDbEntity(lineId, pLine); pLine-close(); pModelSpace-close(); }这段代码把“块表”和“块表记录”两个层次区分得很清楚。块表负责按名称找记录块表记录负责装实体。理解这个层次后你对AutoCAD数据库的认知就会从“一张大表”升级为“数据库下面挂表、表下面挂记录、记录里再挂实体”的树状结构。5.3 容易被忽略的注册应用表在所有符号表里注册应用表AcDbRegAppTable的存在感最低但它其实值得单独记一笔。它的记录类型是AcDbRegAppTableRecord保存的是图纸中出现的扩展程序注册名。什么时候会用上它呢当你给实体或符号表记录写扩展数据XDATA时系统要求注册一个应用名这个名字就保存在注册应用表里。如果名字不存在写入扩展数据会失败或者产生警告。很多插件会先检查注册应用表没有对应记录就主动创建一条这样后面写XDATA才顺畅。注册应用表的操作和图层表完全一致只是记录类不同。这也再次说明把符号表当成一个统一模型来学比一项项孤立地背API效率高得多。你只要把“表、记录、迭代器、增删改查”这套骨架搭起来任何一张符号表都能快速上手。6. 踩过的坑和排查思路6.1 名称大小写不一致符号表名称匹配不区分大小写但名称保存时会保留创建时的写法。这个特性本身不是坑真正的坑出现在团队协作中有人用大写建图层有人用驼峰引用代码里getAt传参五花八门结果排查问题时很难一眼看出“代码里引用的图层”和“表里实际存在的图层”是不是同一个。排查思路很简单统一命名规范必要时在工具启动时把图层名全部转成大写打印出来。另外一个实用技巧是不要相信记忆遇到符号不存在时先用has判断再把表里相近名称的记录打印出来核对。很多“找不到图层”的问题最后都是少了一个下划线或者多了个空格。符号名里的空格也是隐性杀手。用户在界面上可以创建带空格的图层名比如“S - DIM”代码里拼字符串时很容易多拼一个或少拼一个空格。建议在解析外部配置或用户输入时对符号名称做一次trim处理。6.2 open与close不成对这是对象ARX开发里出现频率最高的问题没有之一。每open一个对象就对应一次close。很多人只记着open忘了close短期内程序不会报错但对象长时间保持打开状态后面再以写模式打开同一个对象时会失败或者出现无法预料的锁定问题。我调试过这样一个案例某个批量处理命令运行第二次时总是报“对象已锁定”重启AutoCAD后又正常。最后定位到是第一次运行里有个记录没有close导致对象一直处于打开状态后续命令再次以写模式打开直接冲突。排查这类问题有一个笨办法在可疑代码附近加日志打印每个open和close的配对情况。也可以借助调试器查看对象状态。最有效的还是养成写完代码回头数一遍open和close的习惯每个代码块的尾部必须保证配对。6.3 迭代器失效前面提到遍历过程中不要结构性修改符号表这里再说一个更隐蔽的变体遍历时虽然没修改符号表本身但打开了某条记录并把它erase。这个操作同样会影响迭代器。建议把“遍历”和“修改”严格分成两步。先循环收集对象ID再循环处理对象ID两个循环之间没有任何交错。这个方法简单却能让代码稳很多。我自己写清理工具时已经固定用这个模式没有再出现过迭代器相关崩溃。6.4 删图层把实体“删没了”很多人在ARX里删图层时做过这样的假设图层删掉图层上的实体还在只是变成无图层状态。实际情况没有那么乐观尤其在引用关系复杂时直接erase图层可能导致实体显示异常甚至数据错误。正确做法是分三步先把该图层上的实体转移到其他图层或者删除这些实体再检查块表里是否有块定义引用该图层最后才执行图层记录的erase。有一个保险做法是使用pRec-isUsed()先判断如果有引用就中止删除并把涉及的对象ID收集起来打印给调用方。我建议在业务代码里不要直接调用图层记录的erase而是封装一个名为“DeleteLayerSafe”的函数内部处理引用检查和转移逻辑。这样即便以后需求变化也只需要改一个工具函数不用满项目去查找删图层的调用点。写到这里顺便说点我自己的习惯。我每次接触一张新的符号表不会急着看它有哪些专属API而是先写一个通用遍历工具把这张表的所有记录名称和类别打印出来。跑一次心里就有底了。你想掌握符号表最快的方式就是拿图层表和文字样式表练手新建、查询、修改、删除各写一遍再把块表的模型空间操作过一遍。这几张表跑通之后整个符号表体系对你来说就不再是一个抽象概念而是非常具体的代码模式了。后续做批量图纸处理、样式统一、图层标准化这些需求时你会发现这套功底相当值钱。
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
