SolidWorksMakroprogrammierung

Objekt · SldWorks

PrimaryMemberFacePlaneIntersectionFeatureData-Objekt

Die Daten eines primären Tragwerk-Elements am Schnitt von Fläche und Ebene: die Flächen und die Ebenen, die sie schneiden.

Deklaration Dim x As SldWorks.PrimaryMemberFacePlaneIntersectionFeatureData · in der englischen .NET-Hilfe: IPrimaryMemberFacePlaneIntersectionFeatureData

Beschreibung

PrimaryMemberFacePlaneIntersectionFeatureData gibt Zugriff auf ein primäres Element eines Tragwerks (structure system), das entlang der Schnittlinie einer Fläche oder Oberfläche mit einer Ebene entsteht. Die Hilfe hat zu den Befehlen nur die Syntax, keine Beschreibungen, aber ein Beispiel. Seit wann es die Befehle gibt, sagt sie nicht, vermutlich seit SOLIDWORKS 2022 wie die übrigen Befehle für Tragwerke.

Zugriff

Beispiel

' Legt ein Tragwerk mit einem primären Element an, das entlang der Schnittlinie der
' ausgewählten Fläche mit der ausgewählten Ebene verläuft (Ablauf wie im Hilfebeispiel
' zu diesem Objekt).
' Vorbedingung: Ein Teil ist offen. Ausgewählt sind erst eine Fläche, dann eine Ebene,
'               die sie schneidet. Das Profil ansi inch / c channel / 3 x 5 ist vorhanden.
' Ergebnis:     Ein neues Tragwerk mit dem Element.
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 swPrimaer As SldWorks.PrimaryStructuralMemberFeatureData
    Dim swDaten As SldWorks.PrimaryMemberFacePlaneIntersectionFeatureData
    Dim aFlaechen(0) As Object, aEbenen(0) As Object
    Dim aElemente(0) As SldWorks.StructureSystemMemberFeatureData
    Dim vElemente As Variant
    Dim swFeat As SldWorks.Feature

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

    Set swElement = swModel.Extension.CreateStructureSystemMemberData(swStructureSystemMemberCreationType_Primary_FacePlaneIntersection)
    Set swProfil = swElement.MemberProfile
    swProfil.ProfileStandard = "ansi inch"
    swProfil.ProfileType = "c channel"
    swProfil.ProfileSize = "3 x 5"

    Set swPrimaer = swElement                             ' dieselben Daten, anderer Typ
    Set swDaten = swPrimaer
    swDaten.MergeTangentMembers = False
    If False = swDaten.SetParameterFaces(aFlaechen) Then Exit Sub
    If False = swDaten.SetIntersectingPlanesAndFaces(aEbenen) Then Exit Sub

    Set aElemente(0) = swElement
    vElemente = aElemente
    Set swFeat = swModel.Extension.CreateStructureSystem(vElemente, Nothing)
    If swFeat Is Nothing Then Debug.Print "Kein Tragwerk entstanden." Else Debug.Print "Angelegt: " & swFeat.Name
End Sub

Bemerkungen

Hilfebeispiel: Das VBA-Beispiel der Hilfe zu diesem Objekt legt einen Quader und eine Referenzebene an, wählt eine Seitenfläche mit ModelDocExtension.SelectByRay und die Ebene mit ModelDocExtension.SelectByID2 aus und übergibt beide wie oben. Zum Ändern holt es das Element über die Profilgruppen, ändert die Verlängerung, übergibt „Right Plane“ an PrimaryMemberFacePlaneIntersectionFeatureData.SetIntersectingPlanesAndFaces und ruft Feature.ModifyDefinition mit dem Feature aus StructureSystemMemberFeatureData.GetFeature auf. Danach liegt das Element auf der neuen Ebene. StructureSystemMemberFeatureData.AccessSelections, das die Bemerkungen zu StructureSystemFolder vor dem Ändern von Auswahlen verlangen, ruft es nicht auf.

Begriffe: „Parameter faces“ nennt die Hilfe die Flächen, auf denen das Element liegt, „intersecting planes and faces“ die Ebenen oder Flächen, die sie schneiden. Welche Objekte darin stehen, sagen nur die Zugriffslisten: Face2 nennt beide Get-Methoden, RefPlane und Surface nennen nur GetIntersectingPlanesAndFaces.

Mehr dazu: Die Hilfe verweist auf die Bemerkungen zu StructureSystemFolder und auf den PropertyManager „Primary Member“ in der Hilfe zur Oberfläche.

In SOLIDWORKS 2024 ändert der Ablauf des Hilfebeispiels die Ebene eines vorhandenen Elements nicht: Alle Aufrufe liefern True, das Element bleibt aber auf der alten Ebene (siehe PrimaryMemberFacePlaneIntersectionFeatureData.SetIntersectingPlanesAndFaces).

Eigenschaften und Methoden

Eigenschaften 1, davon 1 beschrieben

NameBeschreibung
MergeTangentMembersLiest oder setzt, ob tangential aneinander anschließende Elemente am Schnitt von Fläche und Ebene zusammengefasst werden.

Methoden 5, davon 5 beschrieben

NameBeschreibung
GetIntersectingObjectTypesLiefert die Typen der Ebenen und Flächen, die die Flächen des primären Elements schneiden.
GetIntersectingPlanesAndFacesLiefert die Ebenen und Flächen, die die Flächen des primären Elements schneiden und so seinen Verlauf festlegen.
GetParameterFacesLiefert die Flächen, auf denen das primäre Element am Schnitt von Fläche und Ebene liegt.
SetIntersectingPlanesAndFacesLegt die Ebenen oder Flächen fest, die die Flächen des primären Elements schneiden und so seinen Verlauf bestimmen.
SetParameterFacesLegt die Flächen fest, auf denen das primäre Element am Schnitt von Fläche und Ebene liegt.

Siehe auch

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

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