Hide Table of Contents
AddExplodeStep2 Method (IConfiguration)

Adds a regular (translate and rotate) explode step to the explode view of the active configuration.

.NET Syntax

Visual Basic (Declaration) 
Function AddExplodeStep2( _
   ByVal ExplDist As System.Double, _
   ByVal ExplDirIndex As System.Integer, _
   ByVal ReverseDir As System.Boolean, _
   ByVal ExplAng As System.Double, _
   ByVal RotAxisIndex As System.Integer, _
   ByVal ReverseAng As System.Boolean, _
   ByVal RotateAboutOrigin As System.Boolean, _
   ByVal AutoSpaceComponentsOnDrag As System.Boolean, _
   ByRef Error As System.Integer _
) As System.Object
Visual Basic (Usage) 
Dim instance As IConfiguration
Dim ExplDist As System.Double
Dim ExplDirIndex As System.Integer
Dim ReverseDir As System.Boolean
Dim ExplAng As System.Double
Dim RotAxisIndex As System.Integer
Dim ReverseAng As System.Boolean
Dim RotateAboutOrigin As System.Boolean
Dim AutoSpaceComponentsOnDrag As System.Boolean
Dim Error As System.Integer
Dim value As System.Object
 
value = instance.AddExplodeStep2(ExplDist, ExplDirIndex, ReverseDir, ExplAng, RotAxisIndex, ReverseAng, RotateAboutOrigin, AutoSpaceComponentsOnDrag, Error)
C# 
System.object AddExplodeStep2( 
   System.double ExplDist,
   System.int ExplDirIndex,
   System.bool ReverseDir,
   System.double ExplAng,
   System.int RotAxisIndex,
   System.bool ReverseAng,
   System.bool RotateAboutOrigin,
   System.bool AutoSpaceComponentsOnDrag,
   out System.int Error
)
C++/CLI 
System.Object^ AddExplodeStep2( 
&   System.double ExplDist,
&   System.int ExplDirIndex,
&   System.bool ReverseDir,
&   System.double ExplAng,
&   System.int RotAxisIndex,
&   System.bool ReverseAng,
&   System.bool RotateAboutOrigin,
&   System.bool AutoSpaceComponentsOnDrag,
&   [Out] System.int Error
) 

Parameters

ExplDist
Distance in meters to move the components in this explode step
ExplDirIndex
Explode direction manipulator index as defined in swExplodeDirectionIndex_e (see Remarks)
ReverseDir
True to reverse the explode direction, false to not
ExplAng
Angle in radians of component rotation (see Remarks)
RotAxisIndex
Rotation manipulator index as defined in swRotationAxisIndex_e (see Remarks)
ReverseAng
True to reverse the direction of ExplAng, false to not
RotateAboutOrigin
True if each component rotates about its origin, false if not (see Remarks)
AutoSpaceComponentsOnDrag
True to automatically space components on drag, false to not (see Remarks)
Error
Error code as defined in swCreateExplodeStepError_e

Return Value

Explode step

Example

See the IExplodeStep examples.

Remarks

This method:

  • Is valid only for an active current explode view. To create an explode view, call IAssemblyDoc::AutoExplode or IAssemblyDoc::CreateExplodedView.
  • Always clears the selection list.
  • Does not work if the Explode PropertyManager is open.
  • Does not work if any component is being edited in the context of the assembly.

If AutoSpaceComponentsOnDrag is set to true, then RotateAboutOrigin is false and ExplAng is 0.0. Set AutoSpaceComponentsOnDrag to false to specify other values for RotateAboutOrigin and ExplAng.

Before calling this method, you must:

  1. Use IConfigurationManager::ActiveConfiguration to get the active configuration for the assembly.
  2. Call IAssemblyDoc::ShowExploded2 to activate an explode view.
  3. Call IModelDocExtension::SelectByID2 to select:
  • Components to move with Mark = 1.
  • (Optionally) An explode direction entity (cylindrical face, conical face, linear edge, or axis) with Mark = 2. Either, both, or neither of the direction entity and ExplDirIndex can be set. If neither, then the Z-direction manipulator index is used.
  • (Optionally) A rotation axis with Mark = 32. Valid only if RotateAboutOrigin is set to false. Either, both, or neither of the rotation axis and RotAxisIndex can be set. If neither, then the XY ring index is used.

After calling this method, call IModelDoc2::EditRebuild3.

For C++, specify VARIANT_TRUE or VARIANT_FALSE for ReverseDir, ReverseAng, and RotateAboutOrigin.

To edit a regular explode step, see the IExplodeStep remarks.

 

See Also

Availability

SOLIDWORKS 2018 FCS, Revision Number 26.0


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:   AddExplodeStep2 Method (IConfiguration)
*Comment:  
*   I acknowledge I have read and I hereby accept the privacy policy under which my Personal Data will be used by Dassault Systèmes

Print Topic

Select the scope of content to print:

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) 2019 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.