Objekt · SldWorks
PrimaryMemberRefPlaneFeatureData-Objekt
Die Daten eines primären Tragwerk-Elements über Referenzebenen: Ebenen für Anfang und Ende, für die Richtung und für die Lage.
Beschreibung
PrimaryMemberRefPlaneFeatureData gibt Zugriff auf ein primäres Element eines Tragwerks (structure system), das an der Schnittlinie von zwei oder mehr Ebenen entsteht. Zwei Bezüge für Anfang und Ende legen die Länge fest, Richtungsbezüge (reference axes) und Lagebezüge (reference locations) legen fest, wo die Elemente liegen. Als Bezüge nimmt es Referenzebenen und ebene Flächen. Es entstehen so viele Elemente, wie es Paare aus Richtungs- und Lagebezug gibt. GetReferenceAxes und SetReferenceAxes gibt es seit SOLIDWORKS 2022, die übrigen Befehle haben nur die Syntax und Kurzbeschreibungen in der Übersicht, vermutlich gibt es sie ebenso lange.
Zugriff
- Die Daten eines primären Elements (
PrimaryStructuralMemberFeatureDataoderStructureSystemMemberFeatureData) einer Variablen dieses Typs zugewiesen. Das geht, wennPrimaryStructuralMemberFeatureData.PrimaryMemberTypeswStructureSystemMemberCreationType_Primary_RefPlaneliefert. - Neue Daten:
ModelDocExtension.CreateStructureSystemMemberDatamitswStructureSystemMemberCreationType_Primary_RefPlane - Das Feature eines solchen Elements hat den Typnamen
StrctSysRefPlnMbrFeat(Tabelle beiFeature.GetTypeName2), seine Daten liefertFeature.GetDefinition.
Beispiel
' Legt ein Tragwerk mit einem primären Element an, das zwischen zwei Ebenen auf der
' Schnittlinie zweier weiterer Ebenen liegt (Ablauf wie im Hilfebeispiel zu diesem Objekt).
' Vorbedingung: Ein Teil ist offen. Ausgewählt sind vier Ebenen in dieser Reihenfolge:
' zwei parallele Ebenen für Anfang und Ende, eine Ebene senkrecht dazu
' für die Richtung und eine Ebene senkrecht zu beiden für die Lage.
' Das Profil ansi inch / c channel / 3 x 5 ist vorhanden.
' Ergebnis: Ein neues Tragwerk mit einem 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.PrimaryMemberRefPlaneFeatureData
Dim aEnden(1) As Object, aRichtung(0) As Object, aLage(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) <> 4 Then Exit Sub
Set aEnden(0) = swSelMgr.GetSelectedObject6(1, -1)
Set aEnden(1) = swSelMgr.GetSelectedObject6(2, -1)
Set aRichtung(0) = swSelMgr.GetSelectedObject6(3, -1)
Set aLage(0) = swSelMgr.GetSelectedObject6(4, -1)
Set swElement = swModel.Extension.CreateStructureSystemMemberData(swStructureSystemMemberCreationType_Primary_RefPlane)
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
If False = swDaten.SetStartAndEndReferences(aEnden) Then Exit Sub
If False = swDaten.SetReferenceAxes(aRichtung) Then Exit Sub
If False = swDaten.SetReferenceLocations(aLage) 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
Anzahl der Elemente: Es entstehen so viele Elemente, wie GetReferenceAxes Einträge liefert, mal so viele, wie GetReferenceLocations liefert. Das Hilfebeispiel legt fünf Referenzebenen an, übergibt zwei Ebenen für Anfang und Ende, drei zu „Top Plane“ parallele Ebenen als Richtung und drei zu „Front Plane“ parallele Ebenen als Lage und erhält neun Elemente. Die Richtungsbezüge müssen parallel zueinander sein und die Bezüge für Anfang und Ende senkrecht schneiden.
Anlegen und Ändern: Der Ablauf folgt den Bemerkungen zu StructureSystemFolder, wie bei PrimaryMemberPathSegmentFeatureData. Beim Anlegen darfst du beliebig viele Richtungsbezüge setzen, beim Ändern nur einen. Das Hilfebeispiel ändert danach nur die Verlängerung des ersten Elements über die allgemeinen Daten und ruft Feature.ModifyDefinition mit dem Feature aus StructureSystemMemberFeatureData.GetFeature auf.
Mehr dazu: Die Hilfe verweist auf die Bemerkungen zu StructureSystemFolder und auf den PropertyManager „Primary Member“ in der Hilfe zur Oberfläche. Die Bedeutung der Lagebezüge beschreibt die Hilfe nur mit „position reference(s)“.
Eigenschaften und Methoden
Methoden 9, davon 9 beschrieben
| Name | Beschreibung |
|---|---|
| GetReferenceAxes | Liefert die Richtungsbezüge, die festlegen, in welcher Richtung die primären Elemente über Referenzebenen verlaufen. |
| GetReferenceAxesTypes | Liefert die Typen der Richtungsbezüge des primären Elements über Referenzebenen. |
| GetReferenceLocations | Liefert die Lagebezüge, die festlegen, wo die primären Elemente über Referenzebenen liegen. |
| GetReferenceLocationsTypes | Liefert die Typen der Lagebezüge des primären Elements über Referenzebenen. |
| GetStartAndEndReferences | Liefert die Bezüge für Anfang und Ende, die die Länge der primären Elemente über Referenzebenen festlegen. |
| GetStartAndEndReferencesTypes | Liefert die Typen der Bezüge für Anfang und Ende des primären Elements über Referenzebenen. |
| SetReferenceAxes | Legt die Richtungsbezüge fest, die bestimmen, in welcher Richtung die primären Elemente über Referenzebenen verlaufen. |
| SetReferenceLocations | Legt die Lagebezüge fest, die bestimmen, wo die primären Elemente über Referenzebenen liegen. |
| SetStartAndEndReferences | Legt die Bezüge für Anfang und Ende fest, die die Länge der primären Elemente über Referenzebenen bestimmen. |
Siehe auch
Englisches Original: IPrimaryMemberRefPlaneFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.