SolidWorksMakroprogrammierung

Objekt · SldWorks

StructureSystemSplitMember-Objekt

Die Teilung eines Tragwerk-Elements: an Referenzen wie Flächen, Ebenen oder anderen Elementen oder nach Maß.

Deklaration Dim x As SldWorks.StructureSystemSplitMember · in der englischen .NET-Hilfe: IStructureSystemSplitMember

Beschreibung

StructureSystemSplitMember gibt Zugriff auf die Teilung eines Elements in einem Tragwerk (structure system). Ein Element kannst du an Referenzen teilen, etwa an Flächen, Ebenen oder anderen Elementen, oder nach Maß: in Stücke einer bestimmten Länge oder in eine Anzahl Stücke. Die Befehle gibt es seit SOLIDWORKS 2022.

Zugriff

Beispiel

' Legt aus zwei ausgewählten Skizzenlinien ein Tragwerk an und teilt die Elemente
' an einer ausgewählten Ebene, wie im Hilfebeispiel.
' Vorbedingung: Ein Teil ist offen. Ausgewählt sind zuerst zwei Skizzenlinien, dann
'               eine Ebene, die beide Linien schneidet. Das Profil
'               ansi inch / c channel / 3 x 5 ist vorhanden.
' Ergebnis:     Ein neues Tragwerk mit vier Elementen im FeatureManager.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swElement As SldWorks.StructureSystemMemberFeatureData
    Dim swProfil As SldWorks.StructureSystemMemberProfile
    Dim swPfad As SldWorks.PrimaryMemberPathSegmentFeatureData
    Dim swTeilung As SldWorks.StructureSystemSplitMember
    Dim aSegmente(1) As Object
    Dim aRef(0) As Object
    Dim aElemente(0) As SldWorks.StructureSystemMemberFeatureData
    Dim vElemente As Variant

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSelMgr = swModel.SelectionManager
    If swSelMgr.GetSelectedObjectCount2(-1) <> 3 Then Exit Sub
    Set aSegmente(0) = swSelMgr.GetSelectedObject6(1, -1)
    Set aSegmente(1) = swSelMgr.GetSelectedObject6(2, -1)
    Set aRef(0) = swSelMgr.GetSelectedObject6(3, -1)

    Set swElement = swModel.Extension.CreateStructureSystemMemberData(swStructureSystemMemberCreationType_Primary_PathSegment)
    Set swProfil = swElement.MemberProfile
    swProfil.ProfileStandard = "ansi inch"
    swProfil.ProfileType = "c channel"
    swProfil.ProfileSize = "3 x 5"
    Set swPfad = swElement                                ' dieselben Daten, anderer Typ
    If False = swPfad.SetPathSegments(aSegmente) Then Exit Sub

    swElement.IsSplit = True
    Set swTeilung = swElement.GetSplitMember
    swTeilung.MemberType = swStructureSplitMember_Reference
    If False = swTeilung.SetSplitReferences(aRef) Then Exit Sub

    Set aElemente(0) = swElement
    vElemente = aElemente
    swModel.Extension.CreateStructureSystem vElemente, Nothing
End Sub

Bemerkungen

Referenz oder Maß: StructureSystemSplitMember.SetSplitReferences und StructureSystemSplitMember.GetSplitReferences gelten nur bei swStructureSplitMember_Reference. StructureSystemSplitMember.SplitLength und StructureSystemSplitMember.SplitLengthRevDirection gelten nur bei swSplitMemberDimensionType_SplitLength, StructureSystemSplitMember.NumberofSplitInstances nur bei swSplitMemberDimensionType_Instance.

Beispiel: Es folgt dem Hilfebeispiel zu PrimaryMemberPathSegmentFeatureData („Create Path Segment Structure System Member“, in VBA, VB.NET und C#). Dort entstehen aus zwei Linien und einer Ebene vier Elemente.

Mehr dazu: Die Hilfe verweist auf die Abschnitte „Split Member“ der PropertyManager „Primary Member“ und „Secondary Member“ in der Hilfe zur Oberfläche.

Eigenschaften und Methoden

Eigenschaften 5, davon 5 beschrieben

NameBeschreibung
DimensionTypeLiest oder setzt, wie ein Tragwerk-Element nach Maß geteilt wird: nach Länge oder nach Anzahl.
MemberTypeLiest oder setzt, ob das Tragwerk-Element an Referenzen oder nach Maß geteilt wird.
NumberofSplitInstancesLiest oder setzt, in wie viele Stücke das Tragwerk-Element geteilt wird.
SplitLengthLiest oder setzt die Länge der Stücke, wenn das Tragwerk-Element nach Länge geteilt wird.
SplitLengthRevDirectionLiest oder setzt, ob die Länge der Teilung in der Gegenrichtung gemessen wird.

Methoden 3, davon 3 beschrieben

NameBeschreibung
GetSplitReferenceObjectTypesLiefert vermutlich die Art jeder Referenz, an der das Tragwerk-Element geteilt wird.
GetSplitReferencesLiefert die Referenzen, an denen das Tragwerk-Element geteilt wird.
SetSplitReferencesSetzt die Referenzen, an denen das Tragwerk-Element geteilt wird.

Siehe auch

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

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