SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.BodyFolder · in der englischen .NET-Hilfe: IBodyFolder

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 Typnamen SolidBodyFolder, SurfaceBodyFolder, CutListFolder, SubWeldFolder oder SubAtomFolder

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 Sub

Bemerkungen

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

NameBeschreibung
TypeLiefert die Art des Körperordners, etwa Ordner der Volumenkörper oder Element einer Zuschnittsliste.

Methoden 13, davon 13 beschrieben

NameBeschreibung
GetAutomaticCutListLiefert, ob SOLIDWORKS beim ersten Schweißkonstruktions-Feature eines Teils automatisch eine Zuschnittsliste anlegt.
GetAutomaticUpdateLiefert, ob SOLIDWORKS die Zuschnittslisten automatisch aktualisiert.
GetBodiesLiefert die Körper im Ordner, ohne die Körper in seinen Unterordnern.
GetBodyCountLiefert die Zahl der Körper im Ordner, ohne die Körper in seinen Unterordnern.
GetCutListSortOptionsLiefert die Einstellungen zum Sortieren der Zuschnittsliste.
GetCutListTypeLiefert die Art der Zuschnittsliste: für Volumenkörper, für Blech oder für eine Schweißkonstruktion.
GetFeatureLiefert das Feature des Körperordners.
GetTopLevelFeatureCountLiefert die Zahl der Features auf oberster Ebene im Körperordner.
GetTopLevelFeaturesLiefert die Features auf oberster Ebene im Körperordner.
SetAutomaticCutListLegt fest, ob SOLIDWORKS beim ersten Schweißkonstruktions-Feature eines Teils automatisch eine Zuschnittsliste anlegt.
SetAutomaticUpdateLegt fest, ob SOLIDWORKS die Zuschnittslisten automatisch aktualisiert.
SortCutListSortiert die Zuschnittsliste nach den angegebenen Einstellungen.
UpdateCutListAktualisiert 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.