SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.PrimaryMemberRefPlaneFeatureData · in der englischen .NET-Hilfe: IPrimaryMemberRefPlaneFeatureData

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

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 Sub

Bemerkungen

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

NameBeschreibung
GetReferenceAxesLiefert die Richtungsbezüge, die festlegen, in welcher Richtung die primären Elemente über Referenzebenen verlaufen.
GetReferenceAxesTypesLiefert die Typen der Richtungsbezüge des primären Elements über Referenzebenen.
GetReferenceLocationsLiefert die Lagebezüge, die festlegen, wo die primären Elemente über Referenzebenen liegen.
GetReferenceLocationsTypesLiefert die Typen der Lagebezüge des primären Elements über Referenzebenen.
GetStartAndEndReferencesLiefert die Bezüge für Anfang und Ende, die die Länge der primären Elemente über Referenzebenen festlegen.
GetStartAndEndReferencesTypesLiefert die Typen der Bezüge für Anfang und Ende des primären Elements über Referenzebenen.
SetReferenceAxesLegt die Richtungsbezüge fest, die bestimmen, in welcher Richtung die primären Elemente über Referenzebenen verlaufen.
SetReferenceLocationsLegt die Lagebezüge fest, die bestimmen, wo die primären Elemente über Referenzebenen liegen.
SetStartAndEndReferencesLegt 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.