SubComponent.AddElement

Description

Adds an element to the SubComponent using its index. All subelements can be added except isolines and isopoints (because those are not indexable subelements). That means that if you want to add a Vertex to a cluster of type siVertexCluster (from the ClusterTypes enum) you call AddElement with the index of the Vertex in the Geometry.

C# Syntax

SubComponent.AddElement( Object in_Elem );

Scripting Syntax

SubComponent.AddElement( Element );

Parameters

Parameter Type Description
Element Variant Index of the element that we want to add to the SubComponent element.

Examples

VBScript Example

'

' This example demonstrates how to add an element by index number.

' It also shows what happens when you try to add an element that

' is already part of the SubComponent and what happens when you

' try to add an element using an invalid index number.

'

NewScene , false

set oObject = Application.ActiveSceneRoot.AddGeometry( "Cube", "MeshSurface", "MyCube" )

set oSubComponent = oObject.ActivePrimitive.Geometry.CreateSubComponent( siVertexCluster, Array(3,4,5) )

Application.LogMessage oSubComponent

' Add the vertex at index 6 to the subcomponent

oSubComponent.AddElement 6

Application.LogMessage oSubComponent

' No change to the SubComponent since the vertex at index 4 is already part of it

oSubComponent.AddElement 4

Application.LogMessage oSubComponent

' No change to the SubComponent since index 55 is not a valid vertex index

On Error Resume Next

oSubComponent.AddElement 55

Application.LogMessage Err.Description

On Error GoTo 0

' Expected results:

'INFO : MyCube.pnt[3-5]

'INFO : MyCube.pnt[3-6]

'INFO : MyCube.pnt[3-6]

'INFO : 2028 - Invalid argument specified.