Std Group

Description
Std Group (internally called App DocumentObjectGroup) is a general purpose container that allows you to group different types of objects in the tree view, regardless of their data type. It is used as a simple folder to categorize and organize the objects in your model, in order to keep a logical structure. Std Groups may be nested inside other Std Groups.

The Std Group tool is not defined by a particular workbench, but by the base system, thus it is found in the that is available in all workbenches.

To group 3D objects as a single unit, with the intention of creating assemblies, use Std Part instead.



Usage

 * 1) Click on the name of the document in the tree view, open the context menu (right click), and choose.
 * 2) Alternatively, press the  button in the structure toolbar. An empty Group is created.
 * 3) To add objects to a Group, select them in tree view, and then drag and drop them over the Group.
 * 4) To remove objects from a Group, drag them out of the Group, and onto the document label at the top of the tree view.

Properties
A Std Group is internally called App DocumentObjectGroup ( class), and is derived from the basic App DocumentObject ( class), therefore it shares all the latter's properties.

In addition to the properties described in App FeaturePython, which is the most basic instance of an App DocumentObject, the App DocumentObjectGroup has the property.

These are the properties available in the property editor. Hidden properties can be shown by using the command in the context menu of the property editor.

Data

 * : the user editable name of this object, it is an arbitrary UTF8 string.
 * : a list of referenced objects. By default, it is empty.

Hidden properties Data

 * : a custom class associated with this object. This only exists for the Python version. See Scripting.

View
See App FeaturePython for the basic view properties.

Hidden properties View

 * : a custom view provider class associated with this object. This only exists for the Python version. See Scripting.

Inheritance
A Std Group is formally an instance of the class, whose parent is the basic App DocumentObject ( class), and is augmented with a Group extension.



Scripting
FreeCAD Scripting Basics, and scripted objects.

See Part Feature for the general information on adding objects to the document.

A Std Group (App DocumentObjectGroup) is created with the method of the document. Once a Group exists, other objects can be added to it with the or  methods of this Group.

This basic doesn't have a Proxy object so it can't be fully used for sub-classing.

Therefore, for Python subclassing, you should create the object.

For example, a FEM Analysis is an object with a custom icon and additional properties.

Links

 * Use case in Arch Tutorial
 * Document structure
 * Organizing your model