Objekt · SldWorks
StructureSystemFolder-Objekt
Der oberste Ordner eines Tragwerks im FeatureManager mit seinen Profilgruppen und seiner Eckenverwaltung.
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
FeatureManager.GetStructureSystemFolders: die Features aller Tragwerke, daraus mitFeature.GetSpecificFeature2je ein StructureSystemFolderModelDocExtension.CreateStructureSystem: das Feature des neuen Tragwerks, dannFeature.GetSpecificFeature2CornerManagementFolder.GetStructureSystemFolder, dannFeature.GetSpecificFeature2CircularPatternFeatureData.StructureSystemToPatternArray,LinearPatternFeatureData.StructureSystemToPatternArrayundMirrorSolidFeatureData.StructureSystemToPatternArray: Tragwerke in Mustern und Spiegelungen
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| GetCornerManagementFolder | Liefert das Feature der Eckenverwaltung dieses Tragwerks. |
| GetFeature | Liefert das Feature dieses Tragwerks. |
| GetProfileGroupFolders | Liefert die Profilgruppen dieses Tragwerks. |
| GetProfileGroupFoldersCount | Liefert 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.