SolidWorksMakroprogrammierung

Objekt · SldWorks

ExplodeStep-Objekt

Ein Schritt in der Explosionsansicht einer Baugruppe: welche Komponenten er bewegt, in welche Richtung, wie weit und um welche Achse gedreht.

Deklaration Dim x As SldWorks.ExplodeStep · in der englischen .NET-Hilfe: IExplodeStep

Beschreibung

ExplodeStep gibt Zugriff auf einen Schritt der Explosionsansicht einer Baugruppe. Es gibt drei Arten (swAssemblyExplodeStepType):

  • normaler Schritt: Er verschiebt die Komponenten um einen Weg in eine Richtung und dreht sie um eine Drehachse oder um ihre Ursprünge.
  • radialer Schritt: Er zieht die Komponenten radial auseinander und kann sie dabei schräg von einer Richtung wegbewegen.
  • Schritt einer Unterbaugruppe: Er übernimmt die Explosion einer Unterbaugruppe und enthält deren Schritte.

Richtung und Drehachse sind eine Achse oder ein Ring des Manipulators, dazu kann ein Element kommen, etwa eine gerade Kante. Name, GetComponent, GetComponentName, GetNumOfComponents und GetComponentXform gibt es seit SOLIDWORKS 2001, IsSubAssemblyRigid seit SOLIDWORKS 2003, die übrigen Befehle seit SOLIDWORKS 2018. Für Explosionsansichten von Mehrkörperteilen gibt es PartExplodeStep.

Zugriff

Beispiel

' Gibt jeden Schritt der Explosionsansicht der aktiven Konfiguration mit
' Art, Weg, Winkel und Komponenten aus, bei Unterbaugruppen auch deren Schritte.
' Vorbedingung: Eine Baugruppe mit einer Explosionsansicht in der aktiven
'               Konfiguration ist offen.
' Ergebnis:     Die Schritte stehen im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Const PI As Double = 3.14159265358979
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swConfig As SldWorks.Configuration
    Dim swSchritt As SldWorks.ExplodeStep
    Dim swUnter As SldWorks.ExplodeStep
    Dim swKomp As SldWorks.Component2
    Dim vKomp As Variant
    Dim vSchritte As Variant
    Dim i As Long, j As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocASSEMBLY Then Exit Sub
    Set swConfig = swModel.ConfigurationManager.ActiveConfiguration

    For i = 0 To swConfig.GetNumberOfExplodeSteps - 1
        Set swSchritt = swConfig.GetExplodeStep(i)
        Select Case swSchritt.ExplodeStepType
            Case swAssemblyExplodeStepType_SubAssembly
                ' Die Hilfe nennt hier nur GetSubAssemblyExplodeSteps
                Debug.Print "Schritt " & i & ": Unterbaugruppe"
                vSchritte = swSchritt.GetSubAssemblyExplodeSteps
                If IsArray(vSchritte) Then
                    For j = 0 To UBound(vSchritte)
                        Set swUnter = vSchritte(j)
                        Debug.Print "    " & swUnter.Name & ": " & swUnter.ExplodeDistance * 1000 & " mm"
                    Next j
                End If
            Case Else
                If swSchritt.ExplodeStepType = swAssemblyExplodeStepType_Radial Then
                    Debug.Print swSchritt.Name & " (radial):"
                Else
                    Debug.Print swSchritt.Name & " (normal):"
                End If
                Debug.Print "    Weg " & swSchritt.ExplodeDistance * 1000 & " mm, Winkel " & _
                    swSchritt.RotationAngle * 180 / PI & "°"
                vKomp = swSchritt.GetComponents
                If IsArray(vKomp) Then
                    For j = 0 To UBound(vKomp)
                        Set swKomp = vKomp(j)
                        Debug.Print "    " & swKomp.Name2
                    Next j
                End If
        End Select
    Next i
End Sub

Bemerkungen

Nur Baugruppen: ExplodeStep gilt nur für Baugruppen. Eine Explosionsansicht legst du mit AssemblyDoc.CreateExplodedView an und aktivierst sie mit AssemblyDoc.ShowExploded2. Die Hilfebeispiele erzeugen sie mit AssemblyDoc.AutoExplode.

Art des Schritts: Viele Befehle gelten nur für eine Art. Was wofür gilt, steht bei ExplodeStep.ExplodeStepType. Bei einem Schritt einer Unterbaugruppe kannst du nur ExplodeStep.GetSubAssemblyExplodeSteps aufrufen. Das Beispiel oben liest dort deshalb auch keinen Namen, anders als das Hilfebeispiel „Add Regular Explode Step“.

Einschränkungen beim Setzen: Die Befehle, die etwas setzen, leeren immer die Auswahl. Sie gehen nicht, solange der PropertyManager „Explodieren“ offen ist oder eine Komponente im Kontext der Baugruppe bearbeitet wird.

Schritt ändern: Für einen Schritt, der kein Schritt einer Unterbaugruppe ist, gehst du so vor:

  1. Mit ConfigurationManager.ActiveConfiguration die aktive Konfiguration holen.
  2. Den Schritt holen, etwa mit Configuration.GetExplodeStep.
  3. Mit ModelDocExtension.SelectByID2 auswählen: die Komponenten mit Markierung 1, ein Richtungselement (zylindrische oder kegelige Fläche, gerade Kante oder Achse) mit Markierung 2 bei normalen und 34 bei radialen Schritten, eine Drehachse mit Markierung 32, wenn RotateAboutOrigin False ist (nur normale Schritte), und ein Element für das Abweichen mit Markierung 64 (nur radiale Schritte).
  4. Die Komponenten mit SelectionMgr.GetSelectedObject6 holen und an ExplodeStep.SetComponents übergeben.
  5. Das Richtungselement an ExplodeStep.SetExplodeDirection übergeben.
  6. Die Drehachse an ExplodeStep.SetRotationAxis übergeben (nur normale Schritte).
  7. ExplodeStep.DivergeDirection auf das Element für das Abweichen setzen (nur radiale Schritte).
  8. Die übrigen Eigenschaften ändern.

Weil schon SetComponents die Auswahl leert, holst du die übrigen Elemente am besten zusammen mit den Komponenten aus der Auswahl, bevor du SetComponents aufrufst. Das Hilfebeispiel „Edit Radial Explode Step“ wählt das Richtungselement und das Element für das Abweichen dagegen erst nach SetComponents aus und holt sie dann.

Hilfebeispiele: „Add Regular Explode Step“ erzeugt mit AssemblyDoc.AutoExplode eine Explosionsansicht, gibt bei einem Schritt einer Unterbaugruppe dessen Schritte aus, löscht den ersten Schritt mit Configuration.DeleteExplodeStep und legt mit Configuration.AddExplodeStep2 einen neuen an. „Edit Radial Explode Step“ liest einen radialen Schritt aus, ändert Weg, Winkel und die Schalter und setzt Komponenten, Richtung und das Element für das Abweichen neu.

Eigenschaften und Methoden

Eigenschaften 10, davon 10 beschrieben

NameBeschreibung
AutoSpaceComponentsOnDragLiest oder setzt, ob der Explosionsschritt Komponenten beim Ziehen automatisch gleichmäßig entlang einer Achse verteilt.
DivergeDirectionLiest oder setzt das Element, von dessen Richtung ein radialer Explosionsschritt die Komponenten schräg wegbewegt.
DivergeFromAxisLiest oder setzt, ob ein radialer Explosionsschritt die Komponenten in einem Winkel zur Explosionsrichtung bewegt.
ExplodeDistanceLiest oder setzt den Weg, um den der Explosionsschritt die Komponenten verschiebt.
ExplodeStepTypeLiefert die Art des Explosionsschritts: normal, radial oder Schritt einer Unterbaugruppe.
NameLiest oder setzt den Namen des Explosionsschritts.
ReverseRotationDirectionLiest oder setzt, ob ein normaler Explosionsschritt die Komponenten in die Gegenrichtung dreht.
ReverseTranslationDirectionLiest oder setzt, ob ein normaler Explosionsschritt die Komponenten in die Gegenrichtung verschiebt.
RotateAboutEachComponentOriginLiest oder setzt, ob ein normaler Explosionsschritt jede Komponente um ihren eigenen Ursprung dreht.
RotationAngleLiest oder setzt den Winkel, um den der Explosionsschritt die Komponenten dreht.

Methoden 13, davon 13 beschrieben

NameBeschreibung
GetComponentLiefert eine Komponente des Explosionsschritts über ihren Index.
GetComponentNameLiefert den Namen einer Komponente des Explosionsschritts über ihren Index.
GetComponentsLiefert alle Komponenten, die der Explosionsschritt bewegt.
GetComponentXformLiefert die Transformation des Explosionsschritts als Array mit 16 Werten.
GetExplodeDirectionLiefert die Richtung des Explosionsschritts: die Achse des Manipulators und das Richtungselement.
GetNumOfComponentsLiefert die Zahl der Komponenten im Explosionsschritt.
GetRotationAxisLiefert die Drehachse eines normalen Explosionsschritts: den Ring des Manipulators und das Achselement.
GetSpecificComponentXFormLiefert die Transformation einer einzelnen Komponente im Explosionsschritt, auch bei radialen Schritten.
GetSubAssemblyExplodeStepsLiefert die Explosionsschritte einer Unterbaugruppe, deren Explosion in diesem Schritt wiederverwendet wird.
IsSubAssemblyRigidLiefert, ob die Unterbaugruppe im Explosionsschritt starr oder flexibel ist.
SetComponentsLegt fest, welche Komponenten der Explosionsschritt bewegt.
SetExplodeDirectionLegt die Richtung des Explosionsschritts fest: die Achse des Manipulators und das Richtungselement.
SetRotationAxisLegt die Drehachse eines normalen Explosionsschritts fest: den Ring des Manipulators und das Achselement.

Nicht aufgeführt sind 2 C++-Varianten (Namen mit I davor, zum Beispiel IGetComponent). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

Englisches Original: IExplodeStep in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.