1. Selection对象到底是什么——先搞清楚交互选择的底层逻辑做CATIA二次开发的朋友应该都有印象在VBA或者CAA环境里录宏的时候只要你在界面上手动点选了一个面、一条边或者一个零件“宏”录制窗口会自动跳出一行代码来。那行代码十有八九长这样Set objSelection objDocument.Selection这个Selection对象说白了就是CATIA当前文档里那个“被高亮选中的集合”。它不是一个具体的几何元素而是一个容器、一个指针列表里面装的是你在图形区里手动点选或者程序自动筛选出来的对象。从我个人的开发经验来看很多刚入门的工程师有一个误区以为Selection就是“当前点击的那一个东西”。实际上完全不是。Selection管理的是“当前文档中被选中的所有东西”的集合不管是鼠标框选的几十个曲面还是通过Search方法按名称找到的一批特征它们统一都会被塞进这个Selection对象里。那为什么开发工具的时候绕不开Selection因为所有的自动化操作几乎都遵循同一个套路让用户选对象程序拿到选中结果再对结果做处理。如果你的工具一上来就针对某个固定名字的特征去操作那代码写死了换个模型就废。而用Selection把“选择权”交还给用户让用户告诉程序“我要处理的是这个”这才是通用工具的正确打开方式。举个例子我曾经做过一个批量调整孔大小的工具。用户需要先框选一批孔特征然后程序读Selection里的每一个元素解析孔直径参数统一改成目标值。整个过程的核心就是先拿到Selection再遍历里面的Item。如果没有Selection这套机制你让程序自己去找孔那得遍历整个零件树效率低不说还容易误伤。所以这篇文章要介绍的这些Selection方法就是你在做交互式工具开发时最常用、最核心的那一部分。我会按从入门到进阶的顺序把高频方法逐个拆开讲配合代码示例和实际踩坑记录看完你基本就能上手写一个带交互选择功能的插件了。1.1 Selection对象的生命周期它从哪来到哪去在深入方法之前先把Selection本身的生命周期理清楚。在CATIA V5中每个Document无论是Part文档、Product文档还是Drawing文档都自带一个Selection属性。这个属性返回的是一个Selection类型对象它是文档级的并不需要你手动创建。 获取当前激活文档的Selection对象 Dim oDoc As Document Set oDoc CATIA.ActiveDocument Dim oSelection As Selection Set oSelection oDoc.Selection这里有个关键点Selection对象是“一次性”的。这句话怎么理解就是说当你调用Clear方法清空它或者用户重新点击了别的元素之前保存在Selection里的引用和状态就会失效。所以写代码的时候拿到Selection后要尽快把里面的有用信息提取出来存到自己定义的变量里别指望Selection里的内容能一直稳稳当当地留到程序最后。我见过不少同事踩这个坑程序开头让用户选了一个面存到Selection里然后中间执行了一大堆跟选择无关的建模操作最后回头再想去读Selection里的那个面发现里面的内容早就变了要么清空了要么被新增的高亮元素覆盖了。这个机制必须从一开始就记住。此外还有一个很反直觉的特性同一个几何元素你可以反复Add进Selection里。Selection默认不会帮你去重。如果你在循环里不加判断就往里Add最后列表里可能会出现一模一样的两个引用遍历和批量操作时就会出问题。后面我会专门讲怎么通过Count和Item配合来避免这种重复。1.2 这套机制能干什么适合什么场景又能解决什么问题Selection相关方法主要面向以下三类场景场景一人工介入的交互式小工具。比如一个一键导出BOM的脚本用户先在产品结构树里选好需要导出的几个部件然后运行宏程序读取Selection里的内容逐个获取属性、写Excel。这种工具不需要复杂的图形界面交互全靠Selection自带的“高亮提示”特性用户用起来也很自然所见即所得。场景二批量自动化处理插件。像批量改名、批量设置材料、批量出工程图这类工具用户框选完一批对象后程序必须能够准确遍历这些对象并且区分不同的类型。比如框选中既有Part又有Product程序就得判断当前Item是什么类型然后才能决定接下来调用哪套API。Selection的Type属性和Item方法就是这里判断的基石。场景三与用户形成“对话”式的程序流程。某些比较复杂的自动化流程需要分步骤让用户确认。比如程序第一步弹窗让用户“选择一个安装孔面”第二步提醒“选择一个约束参考面”第三步“选择方向参考线”。每一步都用SelectElement弹出选择提示代码就会像跟用户做访谈一样一步一步引导操作流程清晰用户体验也好。明白了Selection是什么接下来就要动手用了。下面我从最核心的SelectElement方法开始逐个拆解每个方法的用法、参数、注意事项和实际案例这部分内容适合直接收藏写代码的时候拿出来当手册翻。 CATIA二次开发中的Selection对象方法详解：交互选择与遍历实战
1. Selection对象到底是什么——先搞清楚交互选择的底层逻辑做CATIA二次开发的朋友应该都有印象在VBA或者CAA环境里录宏的时候只要你在界面上手动点选了一个面、一条边或者一个零件“宏”录制窗口会自动跳出一行代码来。那行代码十有八九长这样Set objSelection objDocument.Selection这个Selection对象说白了就是CATIA当前文档里那个“被高亮选中的集合”。它不是一个具体的几何元素而是一个容器、一个指针列表里面装的是你在图形区里手动点选或者程序自动筛选出来的对象。从我个人的开发经验来看很多刚入门的工程师有一个误区以为Selection就是“当前点击的那一个东西”。实际上完全不是。Selection管理的是“当前文档中被选中的所有东西”的集合不管是鼠标框选的几十个曲面还是通过Search方法按名称找到的一批特征它们统一都会被塞进这个Selection对象里。那为什么开发工具的时候绕不开Selection因为所有的自动化操作几乎都遵循同一个套路让用户选对象程序拿到选中结果再对结果做处理。如果你的工具一上来就针对某个固定名字的特征去操作那代码写死了换个模型就废。而用Selection把“选择权”交还给用户让用户告诉程序“我要处理的是这个”这才是通用工具的正确打开方式。举个例子我曾经做过一个批量调整孔大小的工具。用户需要先框选一批孔特征然后程序读Selection里的每一个元素解析孔直径参数统一改成目标值。整个过程的核心就是先拿到Selection再遍历里面的Item。如果没有Selection这套机制你让程序自己去找孔那得遍历整个零件树效率低不说还容易误伤。所以这篇文章要介绍的这些Selection方法就是你在做交互式工具开发时最常用、最核心的那一部分。我会按从入门到进阶的顺序把高频方法逐个拆开讲配合代码示例和实际踩坑记录看完你基本就能上手写一个带交互选择功能的插件了。1.1 Selection对象的生命周期它从哪来到哪去在深入方法之前先把Selection本身的生命周期理清楚。在CATIA V5中每个Document无论是Part文档、Product文档还是Drawing文档都自带一个Selection属性。这个属性返回的是一个Selection类型对象它是文档级的并不需要你手动创建。 获取当前激活文档的Selection对象 Dim oDoc As Document Set oDoc CATIA.ActiveDocument Dim oSelection As Selection Set oSelection oDoc.Selection这里有个关键点Selection对象是“一次性”的。这句话怎么理解就是说当你调用Clear方法清空它或者用户重新点击了别的元素之前保存在Selection里的引用和状态就会失效。所以写代码的时候拿到Selection后要尽快把里面的有用信息提取出来存到自己定义的变量里别指望Selection里的内容能一直稳稳当当地留到程序最后。我见过不少同事踩这个坑程序开头让用户选了一个面存到Selection里然后中间执行了一大堆跟选择无关的建模操作最后回头再想去读Selection里的那个面发现里面的内容早就变了要么清空了要么被新增的高亮元素覆盖了。这个机制必须从一开始就记住。此外还有一个很反直觉的特性同一个几何元素你可以反复Add进Selection里。Selection默认不会帮你去重。如果你在循环里不加判断就往里Add最后列表里可能会出现一模一样的两个引用遍历和批量操作时就会出问题。后面我会专门讲怎么通过Count和Item配合来避免这种重复。1.2 这套机制能干什么适合什么场景又能解决什么问题Selection相关方法主要面向以下三类场景场景一人工介入的交互式小工具。比如一个一键导出BOM的脚本用户先在产品结构树里选好需要导出的几个部件然后运行宏程序读取Selection里的内容逐个获取属性、写Excel。这种工具不需要复杂的图形界面交互全靠Selection自带的“高亮提示”特性用户用起来也很自然所见即所得。场景二批量自动化处理插件。像批量改名、批量设置材料、批量出工程图这类工具用户框选完一批对象后程序必须能够准确遍历这些对象并且区分不同的类型。比如框选中既有Part又有Product程序就得判断当前Item是什么类型然后才能决定接下来调用哪套API。Selection的Type属性和Item方法就是这里判断的基石。场景三与用户形成“对话”式的程序流程。某些比较复杂的自动化流程需要分步骤让用户确认。比如程序第一步弹窗让用户“选择一个安装孔面”第二步提醒“选择一个约束参考面”第三步“选择方向参考线”。每一步都用SelectElement弹出选择提示代码就会像跟用户做访谈一样一步一步引导操作流程清晰用户体验也好。明白了Selection是什么接下来就要动手用了。下面我从最核心的SelectElement方法开始逐个拆解每个方法的用法、参数、注意事项和实际案例这部分内容适合直接收藏写代码的时候拿出来当手册翻。