Objekt · SldWorks
BodyFolder-Objekt
Ein Körperordner im FeatureManager, etwa Volumenkörper, Flächenkörper oder Zuschnittsliste: seine Körper und die Einstellungen der Zuschnittsliste.
Beschreibung
BodyFolder gibt Zugriff auf die Körper in den Körperordnern eines Teils. Das sind die Ordner der Volumen- und Flächenkörper und die Ordner einer Schweißkonstruktion, also die Zuschnittsliste und ihre Elemente. Dazu kommen die Einstellungen der Zuschnittsliste: automatisch anlegen, automatisch aktualisieren und sortieren.
Zugriff
Feature.GetSpecificFeature2: aus einem Feature mit dem TypnamenSolidBodyFolder,SurfaceBodyFolder,CutListFolder,SubWeldFolderoderSubAtomFolder
Einen ausgewählten Körperordner liefert SelectionMgr.GetSelectedObject6 als Feature, Auswahltyp swSelBODYFOLDER, swSelSUBWELDFOLDER oder swSelSUBATOMFOLDER (swSelectType_e).
Beispiel
' Aktualisiert die Zuschnittsliste des aktiven Teils und gibt jedes ihrer Elemente
' mit der Zahl seiner Körper aus.
' Vorbedingung: Ein Teil mit Zuschnittsliste ist offen, etwa eine Schweißkonstruktion.
' Ergebnis: Die Elemente stehen im Direktfenster.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swFeat As SldWorks.Feature
Dim swSubFeat As SldWorks.Feature
Dim swOrdner As SldWorks.BodyFolder
Dim swElement As SldWorks.BodyFolder
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocPART Then Exit Sub
Set swFeat = swModel.FirstFeature
Do While Not swFeat Is Nothing
If swFeat.GetTypeName2 = "SolidBodyFolder" Then ' auch der Ordner der Zuschnittsliste
Set swOrdner = swFeat.GetSpecificFeature2
swOrdner.UpdateCutList ' False, wenn es keine automatische Liste gibt
Set swSubFeat = swFeat.GetFirstSubFeature
Do While Not swSubFeat Is Nothing
If swSubFeat.GetTypeName2 = "CutListFolder" Then
Set swElement = swSubFeat.GetSpecificFeature2
Debug.Print swSubFeat.Name & ": " & swElement.GetBodyCount & " Körper"
End If
Set swSubFeat = swSubFeat.GetNextSubFeature
Loop
End If
Set swFeat = swFeat.GetNextFeature
Loop
End SubBemerkungen
Ordner erkennen: Nach „Accessing Bodies in Body Folders“ erkennst du Körperordner am Typnamen ihres Features (Feature.GetTypeName2). Der oberste Ordner „Zuschnittsliste“ zählt dabei als Ordner der Volumenkörper (SolidBodyFolder), seine Elemente haben den Typnamen CutListFolder. Die Art des Ordners liefert BodyFolder.Type.
Unterordner: BodyFolder.GetBodies und BodyFolder.GetBodyCount liefern nur die Körper des Ordners selbst. Die Unterordner gehst du mit Feature.GetFirstSubFeature und Feature.GetNextSubFeature durch, wie im Beispiel.
Zuschnittsliste: In neuen Schweißkonstruktionen legt SOLIDWORKS die Zuschnittsliste standardmäßig automatisch an. Aktualisieren musst du sie im Teil selbst, entweder von Hand mit BodyFolder.UpdateCutList oder automatisch über BodyFolder.SetAutomaticUpdate. In einer Zeichnung aktualisiert SOLIDWORKS sie beim Öffnen.
Eigenschaften der Elemente: Die Eigenschaften eines Elements der Zuschnittsliste liest das Hilfebeispiel „Get Solid Bodies from Cut-list Folders and Get Custom Properties“ über Feature.CustomPropertyManager seines Features.
Eigenschaften und Methoden
Eigenschaften 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| Type | Liefert die Art des Körperordners, etwa Ordner der Volumenkörper oder Element einer Zuschnittsliste. |
Methoden 13, davon 13 beschrieben
| Name | Beschreibung |
|---|---|
| GetAutomaticCutList | Liefert, ob SOLIDWORKS beim ersten Schweißkonstruktions-Feature eines Teils automatisch eine Zuschnittsliste anlegt. |
| GetAutomaticUpdate | Liefert, ob SOLIDWORKS die Zuschnittslisten automatisch aktualisiert. |
| GetBodies | Liefert die Körper im Ordner, ohne die Körper in seinen Unterordnern. |
| GetBodyCount | Liefert die Zahl der Körper im Ordner, ohne die Körper in seinen Unterordnern. |
| GetCutListSortOptions | Liefert die Einstellungen zum Sortieren der Zuschnittsliste. |
| GetCutListType | Liefert die Art der Zuschnittsliste: für Volumenkörper, für Blech oder für eine Schweißkonstruktion. |
| GetFeature | Liefert das Feature des Körperordners. |
| GetTopLevelFeatureCount | Liefert die Zahl der Features auf oberster Ebene im Körperordner. |
| GetTopLevelFeatures | Liefert die Features auf oberster Ebene im Körperordner. |
| SetAutomaticCutList | Legt fest, ob SOLIDWORKS beim ersten Schweißkonstruktions-Feature eines Teils automatisch eine Zuschnittsliste anlegt. |
| SetAutomaticUpdate | Legt fest, ob SOLIDWORKS die Zuschnittslisten automatisch aktualisiert. |
| SortCutList | Sortiert die Zuschnittsliste nach den angegebenen Einstellungen. |
| UpdateCutList | Aktualisiert eine automatisch angelegte Zuschnittsliste. |
Nicht aufgeführt sind 1 C++-Varianten (Namen mit I davor, zum Beispiel IGetBodies). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IBodyFolder in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.