Function AddComponent5( _
   ByVal CompName As System.String, _
   ByVal ConfigOption As System.Integer, _
   ByVal NewConfigName As System.String, _
   ByVal UseConfigForPartReferences As System.Boolean, _
   ByVal ExistingConfigName As System.String, _
   ByVal X As System.Double, _
   ByVal Y As System.Double, _
   ByVal Z As System.Double _
) As Component2

Dim instance As IAssemblyDoc
Dim CompName As System.String
Dim ConfigOption As System.Integer
Dim NewConfigName As System.String
Dim UseConfigForPartReferences As System.Boolean
Dim ExistingConfigName As System.String
Dim X As System.Double
Dim Y As System.Double
Dim Z As System.Double
Dim value As Component2
 
value = instance.AddComponent5(CompName, ConfigOption, NewConfigName, UseConfigForPartReferences, ExistingConfigName, X, Y, Z)

Component2 AddComponent5( 
   System.string CompName,
   System.int ConfigOption,
   System.string NewConfigName,
   System.bool UseConfigForPartReferences,
   System.string ExistingConfigName,
   System.double X,
   System.double Y,
   System.double Z
)

Component2^ AddComponent5( 
&   System.String^ CompName,
&   System.int ConfigOption,
&   System.String^ NewConfigName,
&   System.bool UseConfigForPartReferences,
&   System.String^ ExistingConfigName,
&   System.double X,
&   System.double Y,
&   System.double Z
) 

Parameters

CompName

Path name of a pre-loaded part or assembly to add as a component (see Remarks)

ConfigOption

Mode in which to open the document as specified in swAddComponentConfigOptions_e

NewConfigName

Name for the new assembly configuration; valid only if ConfigOption = swAddComponentConfigOptions_e.swAddComponentConfigOptions_NewConfigWithAllReferenceModels or swAddComponentConfigOptions_e.swAddComponentConfigOptions_NewConfigWithAsmStructure

UseConfigForPartReferences

If true, the configuration specified in ExistingConfigName is used

ExistingConfigName

Name of the configuration of the loaded component; valid only if UseConfigForPartReferences = true

X

X coordinate of the component center

Y

Y coordinate of the component center

Z

Z coordinate of the component center

Return Value

The specified file must be loaded in memory. A file is loaded into memory when you load the file in your SolidWorks session (ISldWorks::OpenDoc6) or open an assembly that already contains the file.

To add a new instance of an existing virtual component, use IComponent2::GetPathName to get the virtual component's path and file name.

If you want to add the component at a position relative to the root component, use IComponent2::Transform2 to reposition the component immediately after calling this method. Or, you can use IAssemblyDoc::AddComponents or IAssemblyDoc::AddComponents2 to specify the transform when inserting a component, insert as many components as you want at once, and rotate and scale the component through the transform matrix.

IMPORTANT: The x, y, and z parameters of this method are relative to the bounding box of the component. Only use this method if you want to approximately position the component. Use IComponent2::Transform2 if you want to more precisely position the component.