groupGraphics

Syntax

<Path>.groupGraphics(Children:any) → any

The method groupGraphics combines the designated graphics in the Frame designated by <Path> into a group. You can specify the graphics to be grouped either by their numeric indexes or by their names.

Note:

The method is available for these types: FactoryWalls, Fence, GraphicGroup, GroupNode, Instance, Mezzanine, Rack, Stairs, and Switch, compare InternalGraphicType.

Note:

The method deactivates graphic inheritance.

Note:

You cannot assign the method when the graphic is an automatically generated graphic group or when the graphic is located in an automatically generated graphic group.

Parameters

The parameter Children is an array of data type any. It sets the numeric indexes or the names of the graphics which are to be added to the grouped graphic.

Return Value

The return value has the data type any and specifies the created graphic, compare the method _3D.getGraphic.

Example

MyFrame._3D.getGraphic("default", [1,2]).groupGraphics([2,3]) -- groups the graphics at the indexes [1,2,2] and [1,2,3] 
MyFrame._3D.getGraphic("deco").groupGraphics(["Plate","Tool"]) -- groups the graphics named "Plate" and "Tool" 

Related Topics

Group Graphics

ungroupGraphic

inheritGraphics

_3D.getGraphic