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.
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
- Die Daten eines primären Elements (
PrimaryStructuralMemberFeatureDataoderStructureSystemMemberFeatureData) einer Variablen dieses Typs zugewiesen. Das geht, wennPrimaryStructuralMemberFeatureData.PrimaryMemberTypeswStructureSystemMemberCreationType_Primary_FacePlaneIntersectionliefert. - Neue Daten:
ModelDocExtension.CreateStructureSystemMemberDatamitswStructureSystemMemberCreationType_Primary_FacePlaneIntersection - Das Feature eines solchen Elements hat den Typnamen
StrctSysSurfPlnMbrFeat(Tabelle beiFeature.GetTypeName2), seine Daten liefertFeature.GetDefinition.
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| MergeTangentMembers | Liest oder setzt, ob tangential aneinander anschließende Elemente am Schnitt von Fläche und Ebene zusammengefasst werden. |
Methoden 5, davon 5 beschrieben
| Name | Beschreibung |
|---|---|
| GetIntersectingObjectTypes | Liefert die Typen der Ebenen und Flächen, die die Flächen des primären Elements schneiden. |
| GetIntersectingPlanesAndFaces | Liefert die Ebenen und Flächen, die die Flächen des primären Elements schneiden und so seinen Verlauf festlegen. |
| GetParameterFaces | Liefert die Flächen, auf denen das primäre Element am Schnitt von Fläche und Ebene liegt. |
| SetIntersectingPlanesAndFaces | Legt die Ebenen oder Flächen fest, die die Flächen des primären Elements schneiden und so seinen Verlauf bestimmen. |
| SetParameterFaces | Legt 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.