SolidWorksMakroprogrammierung

Objekt · SldWorks

PrimaryMemberPathSegmentFeatureData-Objekt

Die Daten eines primären Tragwerk-Elements entlang von Pfadsegmenten: die Skizzensegmente, Kurven und Kanten, denen es folgt.

Deklaration Dim x As SldWorks.PrimaryMemberPathSegmentFeatureData · in der englischen .NET-Hilfe: IPrimaryMemberPathSegmentFeatureData

Beschreibung

PrimaryMemberPathSegmentFeatureData gibt Zugriff auf ein primäres Element eines Tragwerks (structure system), das entlang von Pfadsegmenten einer Skizze entsteht. Als Pfad nimmt es Skizzensegmente, Referenzkurven und Kanten. GetPathSegments und SetPathSegments gibt es seit SOLIDWORKS 2022, die beiden anderen Befehle haben nur die Syntax und Kurzbeschreibungen in der Übersicht, vermutlich gibt es sie ebenso lange.

Zugriff

Beispiel

' Geht alle Elemente des ausgewählten Tragwerks durch und gibt bei den primären
' Elementen über Pfadsegmente die Zahl der Segmente und ihre Typen aus.
' Vorbedingung: Ein Teil mit einem Tragwerk ist offen, das Tragwerk ist im
'               FeatureManager ausgewählt.
' Ergebnis:     Je Element über Pfadsegmente eine Zeile 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 swElement As SldWorks.StructureSystemMemberFeatureData
    Dim swPrimaer As SldWorks.PrimaryStructuralMemberFeatureData
    Dim swDaten As SldWorks.PrimaryMemberPathSegmentFeatureData
    Dim vGruppen As Variant, vElemente As Variant
    Dim vSegmente As Variant, vTypen As Variant
    Dim sText As String
    Dim i As Long, j As Long, k 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

    vGruppen = swTragwerk.GetProfileGroupFolders
    If IsEmpty(vGruppen) Then Exit Sub
    For i = 0 To UBound(vGruppen)
        Set swGruppenFeat = vGruppen(i)                   ' wie in den Hilfebeispielen
        Set swGruppe = swGruppenFeat.GetSpecificFeature2
        vElemente = swGruppe.GetStructureSystemMembers
        If Not IsEmpty(vElemente) Then
            For j = 0 To UBound(vElemente)
                Set swElement = vElemente(j)
                If swElement.StructureSystemMemberType = swStructureSystemMemberType_Primary Then
                    Set swPrimaer = swElement             ' dieselben Daten, anderer Typ
                    If swPrimaer.PrimaryMemberType = swStructureSystemMemberCreationType_Primary_PathSegment Then
                        Set swDaten = swPrimaer
                        vSegmente = swDaten.GetPathSegments
                        vTypen = swDaten.GetPathSegmentsTypes
                        sText = swElement.GetFeature.Name & ": "
                        If IsEmpty(vSegmente) Then
                            sText = sText & "keine Segmente"
                        Else
                            sText = sText & UBound(vSegmente) + 1 & " Segment(e)"
                            If Not IsEmpty(vTypen) Then
                                sText = sText & ", Typen"
                                For k = 0 To UBound(vTypen)
                                    sText = sText & " " & vTypen(k)   ' Wert aus swSelectType_e
                                Next k
                            End If
                        End If
                        Debug.Print sText & ", tangentiale zusammengefasst: " & swDaten.MergeTangentMembers
                    End If
                End If
            Next j
        End If
    Next i
End Sub

Bemerkungen

Anlegen: Der Ablauf folgt den Bemerkungen zu StructureSystemFolder: Daten mit ModelDocExtension.CreateStructureSystemMemberData anlegen, Profil über StructureSystemMemberFeatureData.MemberProfile setzen, die Daten über PrimaryStructuralMemberFeatureData diesem Typ zuweisen, die Pfadsegmente mit PrimaryMemberPathSegmentFeatureData.SetPathSegments setzen und die Daten im ersten Feld an ModelDocExtension.CreateStructureSystem übergeben. Ein vollständiges Beispiel dazu steht bei PrimaryStructuralMemberFeatureData.

Hilfebeispiel: Das VBA-Beispiel der Hilfe zu diesem Objekt legt zwei Skizzenlinien und eine Referenzebene an, setzt PrimaryMemberPathSegmentFeatureData.MergeTangentMembers auf True und übergibt die Linien an SetPathSegments. Dann teilt es die Elemente an der Ebene (StructureSystemMemberFeatureData.IsSplit, StructureSystemMemberFeatureData.GetSplitMember, StructureSystemSplitMember), sodass vier Elemente entstehen. Zum Ändern holt es das erste Element über die Profilgruppen, setzt die Verlängerung und ruft Feature.ModifyDefinition mit dem Feature aus StructureSystemMemberFeatureData.GetFeature auf, ohne StructureSystemMemberFeatureData.AccessSelections.

Mehr dazu: Die Hilfe verweist auf die Bemerkungen zu StructureSystemFolder und auf den PropertyManager „Primary Member“ in der Hilfe zur Oberfläche. Ob du zum Lesen der Pfadsegmente vorher AccessSelections aufrufen musst, sagt die Hilfe nicht.

Übergibst du mehrere nicht tangentiale Segmente in einem Datenobjekt, entsteht je Segment ein eigenes Element. Liest du die Daten danach aus den Profilgruppen, hat jedes Element nur sein eigenes Segment.

Eigenschaften und Methoden

Eigenschaften 1, davon 1 beschrieben

NameBeschreibung
MergeTangentMembersLiest oder setzt, ob tangential aneinander anschließende Elemente entlang der Pfadsegmente zusammengefasst werden.

Methoden 3, davon 3 beschrieben

NameBeschreibung
GetPathSegmentsLiefert die Skizzensegmente, Referenzkurven und Kanten, entlang derer das primäre Element entsteht.
GetPathSegmentsTypesLiefert die Typen der Pfadsegmente, entlang derer das primäre Element entsteht.
SetPathSegmentsLegt die Skizzensegmente, Referenzkurven und Kanten fest, entlang derer das primäre Element entsteht.

Siehe auch

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

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