SetActiveElements

Introduced

v1.0

Description

Sets the active 3D objects.

Active elements are the objects whose components (such as points, polygons, and edges) can be selected. Active elements are highlighted with a special color.

Note: If the SelectionList argument contains an error, the command fails.

Scripting Syntax

SetActiveElements( [SelectionList] );

Parameters

Parameter Type Description
SelectionList String List of 3D objects to activate.

Default Value: Current selection

Examples

VBScript Example

' The following example uses SetActiveElements to force on which

' objects the selection of components (points) should be possible

NewScene

CreatePrim "Cone", "MeshSurface"

CreatePrim "Cone", "MeshSurface"

Translate , 2.90741783678547, 1.11268802887747, -0.111268802887747, _

		siRelative, siView, siObj, siXYZ

SetSelFilter "point"

SetActiveElements "cone"

logMessage "Only the first cone should be active now (yellow) so the"

logMessage "selection of points should only be possible on that cone"

See Also

ActivateElements DeactivateElements SetAndToggleActiveElements ToggleActiveElements