Introduced
1.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 |
List of elements to add to the selection. Default Value: n/a |
|
|
HierarchyLevel |
Specifies how to select objects in a hierarchy. Default Value: "ASITIS" Possible Values: • 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 |
Specifies whether to select objects that marked as unselectable. Default Value: False Possible Values: • 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
|
|
|
Autodesk Softimage v7.5