⋮

# MoveToGroup

将当前的零件、分组或子物体移动至某一分组或子物体下。

# 语法

MoveToGroup(body_arr:list, group_name:str = '')

# 说明

用于将当前的零件、分组或子物体移动至某一分组或子物体下。

提示

仅在工作台为多体设计状态下，支持移动至分组，否则返回提示信息。分组局部迭代，不支持移动至分组，错误使用则返回提示信息。

# 示例

示例 1：调用 MoveToGroup 的简单示例

演示如何将当前的零件、分组或子物体移动至某一分组或子物体下。

OpenCadWindow()
ImportCad(GetInstallationDirectory() + "/Docs/Interface/Samples/SysplorerAPI/CADToolPy/robot.STEP")
SwitchWorkbenchType(CadWorkbenchType.MultiBody)
CreateGroup(["forearm.forearm_1", "upperarm.upperarm_1"], "RobotArmGroup")
MoveToGroup(["wrist.wrist_1"], "RobotArmGroup")

结果： True

# 输入参数

  • body_arr - 多体设计下，待移动的零件、分组或子物体全名数组。名称按照 . 符号进行层级嵌套，如“base.gear”表示 base 组下的 gear 零件。
    数据类型：list
  • group_name - 移动到的分组或子物体的名称，不传参或者传入空字符串时，表示将零件或分组移动至顶层。
    数据类型：str

# 返回值

bool (True 或 False)：表示函数执行的成功或失败状态