Objekt · SldWorks
PartExplodeStep-Objekt
Ein Schritt in der Explosionsansicht eines Mehrkörperteils: welche Körper er verschiebt, in welche Richtung und wie weit.
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
Configuration.AddPartExplodeStep: legt einen neuen Schritt in der aktiven Explosionsansicht anConfiguration.GetPartExplodeStep: ein vorhandener Schritt der aktiven Explosionsansicht, die Anzahl liefertConfiguration.GetNumberOfPartExplodeSteps
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 SubBemerkungen
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:
- Mit
PartDoc.ShowExplodeddie Explosionsansicht aktivieren. - Mit
PartDoc.GetExplodedViewConfigurationNamedie Konfiguration der Explosionsansicht ermitteln. Das Hilfebeispiel holt sie dann mitModelDoc2.GetConfigurationByName. - Mit
Configuration.GetPartExplodeStepden Schritt holen. - Mit
ModelDocExtension.SelectByID2die Körper mit Markierung1und ein Richtungselement mit Markierung2auswählen: eine zylindrische oder kegelige Fläche, eine gerade Kante oder eine Achse. - Die Körper mit
SelectionMgr.GetSelectedObject6holen und anPartExplodeStep.SetBodiesübergeben. - Das Richtungselement an
PartExplodeStep.SetExplodeDirectionübergeben. - 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
| Name | Beschreibung |
|---|---|
| AutoSpaceBodiesOnDrag | Liest oder setzt, ob der Explosionsschritt Körper beim Ziehen automatisch gleichmäßig entlang einer Achse verteilt. |
| ExplodeDistance | Liest oder setzt den Weg, um den der Explosionsschritt die Körper verschiebt. |
| Name | Liest oder setzt den Namen des Explosionsschritts. |
| ReverseTranslationDirection | Liest oder setzt, ob der Explosionsschritt die Körper in die Gegenrichtung verschiebt. |
Methoden 4, davon 4 beschrieben
| Name | Beschreibung |
|---|---|
| GetBodies | Liefert die Körper, die der Explosionsschritt verschiebt. |
| GetExplodeDirection | Liefert die Richtung des Explosionsschritts: die Achse des Manipulators und das Richtungselement. |
| SetBodies | Legt fest, welche Körper der Explosionsschritt verschiebt. |
| SetExplodeDirection | Legt 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.