对象获取函数的种类

CRI Atom Craft Robot主要采用以下两种方法进行对象获取。

  • 仅获取指定对象正下方的子对象的方法
  • 对指定的对象以下的结构进行递归查找,从而获取对象的方法

以上为分别准备了仅获取一个条件匹配的对象的方法,和以列表形式获取多个对象的方法。

对指定对象正下方的对象获取函数

函数名 说明
get_child_objects 指定父对象,获取多个子对象
get_child_object 指定父对象后获取子对象

前面的教程中,在查找项目的对象结构时使用了 get_child_object 函数。

对指定的对象以下的结构进行递归查找对象获取函数

函数名 说明
find_objects 进行递归搜索,以列表形式获取所有匹配的对象
find_object 进行递归搜索,获取第一个匹配的对象


除此以外,为了与 CRI Atom Craft 的 GUI 操作协同,还准备了以下获取GUI选中的对象的函数。
通过获取CRI Atom Craft 的 GUI 选中的对象,可以简化脚本的对象获取处理。

CRI Atom Craft上的选择对象获取函数

函数名 说明
get_selected_objects 获取GUI树状列表中选中的对象


注解
对于大容量的项目数据,使用 find_objects 函数将于指定结构上处于上级位置的对象为起点,可能需要较长时间获取。
要实现高效的处理,需要理解数据结构和对象结构,使用合适的获取函数。