SolidWorksMakroprogrammierung

Objekt · SldWorks

PartExplodeStep-Objekt

Ein Schritt in der Explosionsansicht eines Mehrkörperteils: welche Körper er verschiebt, in welche Richtung und wie weit.

Deklaration Dim x As SldWorks.PartExplodeStep · in der englischen .NET-Hilfe: IPartExplodeStep

Beschreibung

PartExplodeStep gibt Zugriff auf einen Schritt der Explosionsansicht eines Mehrkörperteils. Ein Schritt verschiebt die gewählten Körper um einen Weg in eine Richtung. Die Richtung ist eine Achse des Manipulators aus swExplodeDirectionIndex_e, dazu kann ein Richtungselement kommen, etwa eine gerade Kante. Die Befehle gibt es seit SOLIDWORKS 2020. Für Explosionsansichten von Baugruppen gibt es ExplodeStep.

Zugriff

Beispiel

' Zeigt die Explosionsansicht der aktiven Konfiguration an und gibt jeden Schritt
' mit Weg, Richtung und Körpern aus.
' Vorbedingung: Ein Mehrkörperteil mit einer Explosionsansicht in der aktiven
'               Konfiguration ist offen.
' Ergebnis:     Die Schritte stehen im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swPart As SldWorks.PartDoc
    Dim swConfig As SldWorks.Configuration
    Dim swSchritt As SldWorks.PartExplodeStep
    Dim swKoerper As SldWorks.Body2
    Dim swRichtung As Object
    Dim vKoerper As Variant
    Dim sAnsicht As String
    Dim sText As String
    Dim nAchse As Long
    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 <> swDocPART Then Exit Sub
    Set swPart = swModel
    Set swConfig = swModel.ConfigurationManager.ActiveConfiguration
    sAnsicht = swConfig.GetCurrentPartExplodeViewName
    If sAnsicht = "" Then Exit Sub
    swPart.ShowExploded True, sAnsicht

    For i = 0 To swConfig.GetNumberOfPartExplodeSteps - 1
        Set swSchritt = swConfig.GetPartExplodeStep(i)
        Set swRichtung = swSchritt.GetExplodeDirection(nAchse)
        sText = swSchritt.Name & ": " & swSchritt.ExplodeDistance * 1000 & " mm, Achse " & nAchse
        If swSchritt.ReverseTranslationDirection Then sText = sText & ", umgekehrt"
        If Not swRichtung Is Nothing Then sText = sText & ", mit Richtungselement"
        Debug.Print sText
        vKoerper = swSchritt.GetBodies
        If IsArray(vKoerper) Then
            For j = 0 To UBound(vKoerper)
                Set swKoerper = vKoerper(j)
                Debug.Print "    " & swKoerper.Name
            Next j
        End If
    Next i
End Sub

Bemerkungen

Nur in der aktiven Explosionsansicht: PartExplodeStep gilt nur für die aktive Explosionsansicht eines Mehrkörperteils. Du legst sie mit PartDoc.CreateExplodedView an und aktivierst sie mit PartDoc.ShowExploded. Configuration.GetPartExplodeStep geht nur in der aktiven Konfiguration.

Einschränkungen beim Setzen: Die Befehle, die etwas setzen, leeren immer die Auswahl. Sie gehen nicht, solange der PropertyManager „Explodieren“ offen ist oder ein Körper im Kontext des Mehrkörperteils bearbeitet wird.

Schritt ändern: So gehst du vor:

  1. Mit PartDoc.ShowExploded die Explosionsansicht aktivieren.
  2. Mit PartDoc.GetExplodedViewConfigurationName die Konfiguration der Explosionsansicht ermitteln. Das Hilfebeispiel holt sie dann mit ModelDoc2.GetConfigurationByName.
  3. Mit Configuration.GetPartExplodeStep den Schritt holen.
  4. Mit ModelDocExtension.SelectByID2 die Körper mit Markierung 1 und ein Richtungselement mit Markierung 2 auswählen: eine zylindrische oder kegelige Fläche, eine gerade Kante oder eine Achse.
  5. Die Körper mit SelectionMgr.GetSelectedObject6 holen und an PartExplodeStep.SetBodies übergeben.
  6. Das Richtungselement an PartExplodeStep.SetExplodeDirection übergeben.
  7. Die übrigen Eigenschaften ändern.

Weil schon SetBodies die Auswahl leert, holst du das Richtungselement am besten zusammen mit den Körpern aus der Auswahl, bevor du SetBodies aufrufst.

Hilfebeispiel: Das VBA-Beispiel „Add Multibody Part Explode Step“ legt mit PartDoc.CreateExplodedView eine Explosionsansicht an, fügt mit Configuration.AddPartExplodeStep einen Schritt ohne Richtungselement hinzu und gibt Name, Weg, Umkehrung, automatisches Verteilen und die Namen der Körper aus. Als Achse übergibt es -1 (swExplodeDirectionIndex_Unknown); dann gilt die Z-Achse, wie der Kommentar im Beispiel sagt.

Eigenschaften und Methoden

Eigenschaften 4, davon 4 beschrieben

NameBeschreibung
AutoSpaceBodiesOnDragLiest oder setzt, ob der Explosionsschritt Körper beim Ziehen automatisch gleichmäßig entlang einer Achse verteilt.
ExplodeDistanceLiest oder setzt den Weg, um den der Explosionsschritt die Körper verschiebt.
NameLiest oder setzt den Namen des Explosionsschritts.
ReverseTranslationDirectionLiest oder setzt, ob der Explosionsschritt die Körper in die Gegenrichtung verschiebt.

Methoden 4, davon 4 beschrieben

NameBeschreibung
GetBodiesLiefert die Körper, die der Explosionsschritt verschiebt.
GetExplodeDirectionLiefert die Richtung des Explosionsschritts: die Achse des Manipulators und das Richtungselement.
SetBodiesLegt fest, welche Körper der Explosionsschritt verschiebt.
SetExplodeDirectionLegt die Richtung des Explosionsschritts fest: die Achse des Manipulators und das Richtungselement.

Siehe auch

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

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