AddToSelection
 
 
 

AddToSelection

Introduced

v1.0

Description

Adds elements to the current selection.

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

Scripting Syntax

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

Parameters

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.

Examples

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."

See Also

Selection SelectObj RemoveFromSelection SelectBranch SelectTree SelectModel