> ReplaceComponents Method (IAssemblyDoc)
Welcome
Getting Started
SolidWorks API Help
FeatureWorks API Help
SolidWorks Document Manager API Help
eDrawings API Help
SolidWorks Routing API Help
SolidWorks Simulation API Help
SolidWorks Utilities API Help
SolidWorks Workgroup PDM API Help
Hide Table of Contents Show Table of Contents
ReplaceComponents Method (IAssemblyDoc)

Replaces one or more selected components with another model.

.NET Syntax

Visual Basic (Declaration) 
Function ReplaceComponents( _
   ByVal FileName As String, _
   ByVal ConfigName As String, _
   ByVal ReplaceAllInstance As Boolean, _
   ByVal ReAttachMates As Boolean _
) As Boolean
Visual Basic (Usage) 
Dim instance As IAssemblyDoc
Dim FileName As String
Dim ConfigName As String
Dim ReplaceAllInstance As Boolean
Dim ReAttachMates As Boolean
Dim value As Boolean
 
value = instance.ReplaceComponents(FileName, ConfigName, ReplaceAllInstance, ReAttachMates)
C# 
bool ReplaceComponents( 
   string FileName,
   string ConfigName,
   bool ReplaceAllInstance,
   bool ReAttachMates
)
C++/CLI 
bool ReplaceComponents( 
&   String^ FileName,
&   String^ ConfigName,
&   bool ReplaceAllInstance,
&   bool ReAttachMates
) 

Parameters

FileName
Path and new file name
ConfigName
Name of configuration
ReplaceAllInstance
True if all instances should be replaced, false if not
ReAttachMates
True if all of the mates should be reattached if the component is found in the subassembly component, false if not

Return Value

True if the component was successfully replaced, false if not

Example

Remarks

You cannot replace a selected component with a component of the same name even if the components are in different folders.

The component must be a top-level component. It cannot be a component of a sub-assembly. If the application needs to replace a component of the sub-assembly, then it should open the sub-assembly and get the component from that assembly.

This method closes any component files when called in an assembly.  If the components were modified, then those modifications are not automatically saved. You must save any modifications before the files are closed.

 

See Also

Availability

SolidWorks 2003 FCS, Revision Number 11.0


Related SolidWorks Forum Content

Provide feedback on this topic

SolidWorks welcomes your feedback concerning the presentation, accuracy, and thoroughness of the documentation. Use the form below to send your comments and suggestions about this topic directly to our documentation team. The documentation team cannot answer technical support questions. Click here for information about technical support.

* Required

 
*Email:  
Subject:   Feedback on Help Topics
Page:   ReplaceComponents Method (IAssemblyDoc)
*Comment:  
x

We have detected you are using a browser version older than Internet Explorer 7. For optimized display, we suggest upgrading your browser to Internet Explorer 7 or newer.

 Never show this message again
x

Web Help Content Version: API Help (English only) 2012 SP05

The search functionality within the web help is in a beta test phase and you may experience periodic delays or interruptions in its performance. These are the normal and ordinary features of a beta test and shall not under any circumstances give rise to any liability on the part of DS SolidWorks or its licensors. The topics within the Web-based help are not beta topics; they document API Help (English only) 2012 SP05.

To disable Web help from within SolidWorks and use local help instead, click Help > Use SolidWorks Web Help.

To report problems encountered with the Web help interface and search, contact your local support representative. To provide feedback on individual help topics, use the “Feedback on this topic” link on the individual topic page.