Function ActivateDoc3( _
   ByVal Name As System.String, _
   ByVal UseUserPreferences As System.Boolean, _
   ByVal Option As System.Integer, _
   ByRef Errors As System.Integer _
) As System.Object

Dim instance As ISldWorks
Dim Name As System.String
Dim UseUserPreferences As System.Boolean
Dim Option As System.Integer
Dim Errors As System.Integer
Dim value As System.Object
 
value = instance.ActivateDoc3(Name, UseUserPreferences, Option, Errors)

System.object ActivateDoc3( 
   System.string Name,
   System.bool UseUserPreferences,
   System.int Option,
   out System.int Errors
)

System.Object^ ActivateDoc3( 
&   System.String^ Name,
&   System.bool UseUserPreferences,
&   System.int Option,
&   [Out] System.int Errors
) 

Parameters

Name

Name of the loaded document to activate (see Remarks)

UseUserPreferences

True to rebuild as per the swRebuildOnActivation system option; false to rebuild as per Option

Option

Rebuild option as defined in swRebuildOnActivation_e (see Remarks)

Errors

Status of the activate operation as defined in swActivateDocError_e; if
no errors or warnings are encountered, then this value is 0 (see Remarks)

Return Value

This method brings the document specified in Name to the foreground of SOLIDWORKS and returns a pointer to the document.

If you do not specify a file extension in Name, the document activated is based on its filename without the file extension. This can cause problems if you have loaded two different document types with the same name (e.g., 12345.sldprt and 12345.sldasm). To avoid this problem, specify the file extension in Name or check the document type after it is activated using IModelDoc2::GetType.

If the document needs a rebuild upon activation, and you have specified Option with swRebuildOnActivation_e.swDontRebuildActiveDoc, then the activated document is not rebuilt, and Errors contains swActivateDocError_e.swDocNeedsRebuildWarning. You can then rebuild the document using IModelDoc2::EditRebuild3.

If the document needs a rebuild upon activation, and you have specified Option with swRebuildOnActivation_e.swUserDecision, then a dialog displays asking whether to rebuild the document.