SolidWorksMakroprogrammierung

Objekt · SldWorks

StructureSystemFolder-Objekt

Der oberste Ordner eines Tragwerks im FeatureManager mit seinen Profilgruppen und seiner Eckenverwaltung.

Deklaration Dim x As SldWorks.StructureSystemFolder · in der englischen .NET-Hilfe: IStructureSystemFolder

Beschreibung

StructureSystemFolder gibt Zugriff auf den obersten Ordner eines Tragwerks (structure system) im FeatureManager. Darin stehen eine oder mehrere Profilgruppen (ProfileGroupFolder), in jeder Profilgruppe die Profilreferenzen und die Elemente des Tragwerks (StructureSystemMemberFeatureData). Legst du ein Tragwerk über die API an, legt SOLIDWORKS dazu automatisch einen Ordner für die Eckenverwaltung an (CornerManagementFolder). Die Befehle gibt es seit SOLIDWORKS 2022, GetCornerManagementFolder seit SOLIDWORKS 2023.

Zugriff

Beispiel

' Gibt für das ausgewählte Tragwerk die Profilgruppen mit der Zahl ihrer Elemente
' und den Namen der Eckenverwaltung aus.
' Vorbedingung: Ein Teil mit einem Tragwerk ist offen, das Tragwerk ist im
'               FeatureManager ausgewählt.
' Ergebnis:     Die Angaben stehen im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swFeat As SldWorks.Feature
    Dim swTragwerk As SldWorks.StructureSystemFolder
    Dim swGruppenFeat As SldWorks.Feature
    Dim swGruppe As SldWorks.ProfileGroupFolder
    Dim swEckenFeat As SldWorks.Feature
    Dim vGruppen As Variant, vElemente As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swFeat = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If swFeat Is Nothing Then Exit Sub
    Set swTragwerk = swFeat.GetSpecificFeature2
    If swTragwerk Is Nothing Then Exit Sub

    Debug.Print swTragwerk.GetFeature.Name & ": " & swTragwerk.GetProfileGroupFoldersCount & " Profilgruppe(n)"
    vGruppen = swTragwerk.GetProfileGroupFolders
    If Not IsEmpty(vGruppen) Then
        For i = 0 To UBound(vGruppen)
            Set swGruppenFeat = vGruppen(i)               ' wie in den Hilfebeispielen
            Set swGruppe = swGruppenFeat.GetSpecificFeature2
            vElemente = swGruppe.GetStructureSystemMembers
            If IsEmpty(vElemente) Then
                Debug.Print "  " & swGruppenFeat.Name & ": keine Elemente"
            Else
                Debug.Print "  " & swGruppenFeat.Name & ": " & UBound(vElemente) + 1 & " Element(e)"
            End If
        Next i
    End If

    Set swEckenFeat = swTragwerk.GetCornerManagementFolder
    If Not swEckenFeat Is Nothing Then Debug.Print "Eckenverwaltung: " & swEckenFeat.Name
End Sub

Bemerkungen

Anlegen: Für jedes primäre und sekundäre Element legst du Daten mit ModelDocExtension.CreateStructureSystemMemberData an. Ihre Profile setzt du über StructureSystemMemberFeatureData.MemberProfile (StructureSystemMemberProfile), geteilte Elemente kennzeichnest du mit StructureSystemMemberFeatureData.IsSplit (StructureSystemSplitMember). Dann weist du die Daten Variablen der Typen PrimaryStructuralMemberFeatureData oder SecondaryStructuralMemberFeatureData und weiter der einzelnen Erzeugungsarten zu, füllst sie und übergibst alle zusammen an ModelDocExtension.CreateStructureSystem: im ersten Feld die primären, im zweiten die sekundären Elemente.

Ändern: Du holst den Ordner mit Feature.GetSpecificFeature2, gehst mit StructureSystemFolder.GetProfileGroupFolders durch die Profilgruppen und holst dort die Elemente. Ob ein Element primär oder sekundär ist, liefert StructureSystemMemberFeatureData.StructureSystemMemberType. Vor dem Ändern der Auswahlen rufst du StructureSystemMemberFeatureData.AccessSelections auf, zum Schluss Feature.ModifyDefinition mit dem Feature aus StructureSystemMemberFeatureData.GetFeature.

Profilgruppen: StructureSystemFolder.GetProfileGroupFolders liefert Profilgruppen-Ordner. Die Hilfebeispiele behandeln die Einträge aber als Feature und holen den Ordner erst mit Feature.GetSpecificFeature2. Das Beispiel oben folgt den Hilfebeispielen.

Mehr dazu: Die Hilfe verweist auf die Themen zum Tragwerk unter „Weldments and Structure System“ in der Hilfe zur Oberfläche.

Eigenschaften und Methoden

Methoden 4, davon 4 beschrieben

NameBeschreibung
GetCornerManagementFolderLiefert das Feature der Eckenverwaltung dieses Tragwerks.
GetFeatureLiefert das Feature dieses Tragwerks.
GetProfileGroupFoldersLiefert die Profilgruppen dieses Tragwerks.
GetProfileGroupFoldersCountLiefert die Zahl der Profilgruppen dieses Tragwerks.

Siehe auch

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

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