## Group.AddMember

### Introduced

v5.0

### Description

Adds members to a group.
You can add objects in branch mode, so that properties assigned to the group are inherited by the objects and their children. For example, if you have a hierarchy A->B->C and you add object A to a group in branch mode, then any material assigned to the group applies not only to A but also to B and C.
You can use Group.IsMember to check if an object is a branch member of a group. To change the branch setting of a group member, you have to remove the object and then add it back to the group.
Note: Use AddToPartition to add members to a Partition Group.

### C# Syntax

    Boolean Group.AddMember( Object in_member, Boolean in_bBranchMember );

### Scripting Syntax

    oBoolean = Group.AddMember( NewMember, [BranchMember] );

### Return Value

Boolean
True if the members were added successfully, and False otherwise.

### Parameters

Parameter | Type | Description
--- | --- | ---
NewMember | XSICollection or SceneItem | Members to add.
BranchMember | Boolean | True to add objects in branch mode. Default Value: False

### Examples

#### JScript Example

    NewScene(null, false );

    var a = ActiveSceneRoot.AddGeometry( "Cube", "MeshSurface", "A");

    a.length.value = 2;

    var b = a.AddGeometry("Cube", "MeshSurface", "B");

    b.length.value = 2;

    Translate( b, 5 );

    var c = b.AddGeometry("Cube", "MeshSurface", "C");

    c.length.value = 2;

    Translate( c, 5 );

    // create group

    var group = ActiveSceneRoot.AddGroup();

    // add members to group

    group.AddMember( a, true );

    group.AddMember( b, false );

    logmessage( "number of members : " + group.members.Count );

    // determine which members were added in branch

    for ( var i = 0; i < group.members.count; i++ )

    {

    	var member = group.members(i);

    	var bBranchMember = group.members(i).BranchFlag ? "true" : "false";

    	logmessage( member + " branch member " + bBranchMember );

    }

    logmessage( "Extended group members = " + group.expandedmembers.getastext() );

    //INFO : number of members : 2

    //INFO : A branch member true

    //INFO : B branch member false

    //INFO : Extended group members = A,B,C