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.
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
Configuration.GetExplodeStep: ein vorhandener Schritt der Konfiguration, die Anzahl liefertConfiguration.GetNumberOfExplodeStepsConfiguration.AddExplodeStep2: legt einen normalen Schritt anConfiguration.AddRadialExplodeStep: legt einen radialen Schritt anExplodeStep.GetSubAssemblyExplodeSteps: die Schritte innerhalb eines Schritts einer Unterbaugruppe
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 SubBemerkungen
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:
- Mit
ConfigurationManager.ActiveConfigurationdie aktive Konfiguration holen. - Den Schritt holen, etwa mit
Configuration.GetExplodeStep. - Mit
ModelDocExtension.SelectByID2auswählen: die Komponenten mit Markierung1, ein Richtungselement (zylindrische oder kegelige Fläche, gerade Kante oder Achse) mit Markierung2bei normalen und34bei radialen Schritten, eine Drehachse mit Markierung32, wenn RotateAboutOriginFalseist (nur normale Schritte), und ein Element für das Abweichen mit Markierung64(nur radiale Schritte). - Die Komponenten mit
SelectionMgr.GetSelectedObject6holen und anExplodeStep.SetComponentsübergeben. - Das Richtungselement an
ExplodeStep.SetExplodeDirectionübergeben. - Die Drehachse an
ExplodeStep.SetRotationAxisübergeben (nur normale Schritte). ExplodeStep.DivergeDirectionauf das Element für das Abweichen setzen (nur radiale Schritte).- 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
| Name | Beschreibung |
|---|---|
| AutoSpaceComponentsOnDrag | Liest oder setzt, ob der Explosionsschritt Komponenten beim Ziehen automatisch gleichmäßig entlang einer Achse verteilt. |
| DivergeDirection | Liest oder setzt das Element, von dessen Richtung ein radialer Explosionsschritt die Komponenten schräg wegbewegt. |
| DivergeFromAxis | Liest oder setzt, ob ein radialer Explosionsschritt die Komponenten in einem Winkel zur Explosionsrichtung bewegt. |
| ExplodeDistance | Liest oder setzt den Weg, um den der Explosionsschritt die Komponenten verschiebt. |
| ExplodeStepType | Liefert die Art des Explosionsschritts: normal, radial oder Schritt einer Unterbaugruppe. |
| Name | Liest oder setzt den Namen des Explosionsschritts. |
| ReverseRotationDirection | Liest oder setzt, ob ein normaler Explosionsschritt die Komponenten in die Gegenrichtung dreht. |
| ReverseTranslationDirection | Liest oder setzt, ob ein normaler Explosionsschritt die Komponenten in die Gegenrichtung verschiebt. |
| RotateAboutEachComponentOrigin | Liest oder setzt, ob ein normaler Explosionsschritt jede Komponente um ihren eigenen Ursprung dreht. |
| RotationAngle | Liest oder setzt den Winkel, um den der Explosionsschritt die Komponenten dreht. |
Methoden 13, davon 13 beschrieben
| Name | Beschreibung |
|---|---|
| GetComponent | Liefert eine Komponente des Explosionsschritts über ihren Index. |
| GetComponentName | Liefert den Namen einer Komponente des Explosionsschritts über ihren Index. |
| GetComponents | Liefert alle Komponenten, die der Explosionsschritt bewegt. |
| GetComponentXform | Liefert die Transformation des Explosionsschritts als Array mit 16 Werten. |
| GetExplodeDirection | Liefert die Richtung des Explosionsschritts: die Achse des Manipulators und das Richtungselement. |
| GetNumOfComponents | Liefert die Zahl der Komponenten im Explosionsschritt. |
| GetRotationAxis | Liefert die Drehachse eines normalen Explosionsschritts: den Ring des Manipulators und das Achselement. |
| GetSpecificComponentXForm | Liefert die Transformation einer einzelnen Komponente im Explosionsschritt, auch bei radialen Schritten. |
| GetSubAssemblyExplodeSteps | Liefert die Explosionsschritte einer Unterbaugruppe, deren Explosion in diesem Schritt wiederverwendet wird. |
| IsSubAssemblyRigid | Liefert, ob die Unterbaugruppe im Explosionsschritt starr oder flexibel ist. |
| SetComponents | Legt fest, welche Komponenten der Explosionsschritt bewegt. |
| SetExplodeDirection | Legt die Richtung des Explosionsschritts fest: die Achse des Manipulators und das Richtungselement. |
| SetRotationAxis | Legt 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.