v1.0

Adds elements to the current selection.

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

AddToSelection( SelectionList, [HierarchyLevel], [CheckObjectSelectability] );

Parameter	Type	Description
SelectionList	String	List of elements to add to the selection. Default Value: n/a
HierarchyLevel	String	Specifies how to select objects in a hierarchy. Default Value: "ASITIS" Possible Values: Description: ASITIS Select the object as it is. NODE Select the object. BRANCH Select the object and its children. TREE Select the entire hierarchy of objects. MODEL Select the model and the hierarchy of objects.
CheckObjectSelectability	Boolean	Specifies whether to select objects that marked as unselectable. Default Value: False Possible Values: Description: False Select objects even if they are marked as unselectable. True Do not select objects if they are marked as unselectable.

1. VBScript Example

'

' The following uses "AddToSelection" to add an object (ie: "cylinder") 

' to the selection list

'

NewScene

CreatePrim "Cylinder", "MeshSurface"

CreatePrim "Cylinder", "MeshSurface"

Translate , 3.48352677058841, 0.127331217177334, -1.27331217177334E-02, _

	siRelative, siView, siObj, siXYZ, , , siXYZ

AddToSelection "cylinder"

Application.LogMessage "object called cylinder should now be part of the selection list"

2. VBScript Example

'

' The following uses "AddToSelection" to add an object (ie: "cone")

' to the selection as a branch selected element.

'

NewScene

CreatePrim "Cone", "MeshSurface"

CreatePrim "Cylinder", "MeshSurface"

Translate , -0.118156772275078, -5.87851913444323, 0.587851913444323, _

	siRelative, siView, siObj, siXYZ

ParentObj "cone", "cylinder"

DeselectAll

AddToSelection "cone", "BRANCH"

Application.LogMessage "The object cone should now be branch selected"

Application.LogMessage "The cylinder child should be highlighted in gray to reflect this."

Selection SelectObj RemoveFromSelection SelectBranch SelectTree SelectModel