## ToggleActiveElements

### Introduced

v1.0

### Description

Extends the active list by toggling the activation of elements.
Note: If the SelectionList argument contains an error, the command fails.

### Scripting Syntax

    ToggleActiveElements( [SelectionList] );

### Parameters

Parameter | Type | Description
--- | --- | ---
SelectionList | String | List of 3D objects. Active elements in this list are deactivated, and non-active elements are activated. Default Value: Current selection

### Examples

#### VBScript Example

    ' The following example uses ToggleActiveElements to toggle

    ' on which objects the component selection should be possible

    NewScene

    CreatePrim "Cone", "MeshSurface"

    CreatePrim "Cube", "MeshSurface"

    Translate , 0.315084726066844, 7.40693410939845, -0.740693410939845, _

    		siRelative, siView, siObj, siXYZ

    CreatePrim "Sphere", "MeshSurface"

    Translate , 9.76762650807222, 1.64598535764408, -0.164598535764408, _

    		siRelative, siView, siObj, siXYZ

    SelectObj "cone", , True

    AddToSelection "cube", , True

    ActivateVertexSelTool

    ToggleActiveElements "cube, sphere"

    logMessage "Cone remains active, Sphere becomes active"

    logMessage "and Cube is no longer active"

### See Also

ActivateElements DeactivateElements SetActiveElements SetAndToggleActiveElements