SolidWorksMakroprogrammierung

Objekt · SldWorks

SecondaryMemberUpToMembersFeatureData-Objekt

Die Daten eines sekundären Tragwerk-Elements bis zu Elementen: von einem Punkt zu einem oder mehreren primären Elementen oder über Paare aus Punkt und Element.

Deklaration Dim x As SldWorks.SecondaryMemberUpToMembersFeatureData · in der englischen .NET-Hilfe: ISecondaryMemberUpToMembersFeatureData

Beschreibung

SecondaryMemberUpToMembersFeatureData gibt Zugriff auf ein sekundäres Element eines Tragwerks (structure system), das bis zu Elementen reicht. Es entsteht entweder zwischen einem gewählten Punkt und einem oder mehreren primären Elementen oder zwischen einem oder mehreren Paaren aus Punkt und Element. Wo es am Element ansetzt, legst du als Abstand oder Längenverhältnis vom Ende fest. GetFromPoint und SetFromPoint gibt es seit SOLIDWORKS 2023, die übrigen Befehle haben nur die Syntax und Kurzbeschreibungen in der Übersicht, vermutlich gibt es sie ebenso lange.

Zugriff

Beispiel

' Legt ein sekundäres Element vom ausgewählten Punkt bis zum ausgewählten primären
' Element an, 100 mm vom Ende entfernt (Ablauf wie im Hilfebeispiel "Create Secondary
' Structure System Members").
' Vorbedingung: Ein Teil mit einem Tragwerk ist offen. Ausgewählt sind erst eine Ecke
'               (Vertex) oder ein Skizzenpunkt, dann ein primäres Element im
'               FeatureManager. Das Profil ansi inch / pipe / 0.5 sch 40 ist vorhanden.
' Ergebnis:     Ein neues Tragwerk mit dem sekundären 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 swSekundaer As SldWorks.SecondaryStructuralMemberFeatureData
    Dim swDaten As SldWorks.SecondaryMemberUpToMembersFeatureData
    Dim swPunkt As Object
    Dim aZiele(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 swPunkt = swSelMgr.GetSelectedObject6(1, -1)
    Set aZiele(0) = swSelMgr.GetSelectedObject6(2, -1)

    Set swElement = swModel.Extension.CreateStructureSystemMemberData(swStructureSystemMemberCreationType_Secondary_UpToMembers)
    Set swProfil = swElement.MemberProfile
    swProfil.ProfileStandard = "ansi inch"
    swProfil.ProfileType = "pipe"
    swProfil.ProfileSize = "0.5 sch 40"

    Set swSekundaer = swElement                           ' dieselben Daten, anderer Typ
    Set swDaten = swSekundaer
    swDaten.MemberPointParametersType = swSecondaryMemberUpToMembersMemberPointParameters_FromPoint
    If False = swDaten.SetFromPoint(swPunkt) Then Exit Sub
    If False = swDaten.SetFromPointMembers(aZiele) Then Exit Sub
    swDaten.SecondaryMemberOffsetType = swSecondaryMemberUpToMembersDistanceFromEndType_Distance
    swDaten.DistanceMember = 0.1                          ' Meter
    swDaten.RevDirectionDistanceMember = False

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

Bemerkungen

Zwei Arten: Steht SecondaryMemberUpToMembersFeatureData.MemberPointParametersType auf swSecondaryMemberUpToMembersMemberPointParameters_FromPoint, gibst du einen Punkt (SecondaryMemberUpToMembersFeatureData.SetFromPoint) und die Elemente an, zu denen das Element reicht (SecondaryMemberUpToMembersFeatureData.SetFromPointMembers). GetFromPoint und SetFromPoint gelten nur bei dieser Art. Bei …_PointMemberPair gibst du Paare aus Punkt und Element mit SecondaryMemberUpToMembersFeatureData.SetPointMemberPairs an.

Anlegen: Der Ablauf folgt den Bemerkungen zu StructureSystemFolder, wie bei SecondaryMemberBetweenPointsFeatureData und SecondaryMemberSupportPlaneFeatureData. Die Bemerkungen dort nennen die Elemente „bis zu Elementen“ noch nicht. Das Hilfebeispiel „Create Secondary Structure System Members“ lässt den Anwender eine Ecke von „Member1“ im Grafikbereich und „Member2“ im FeatureManager auswählen, übergibt beides wie oben und setzt den Abstand 0.1. Die VBA-Fassung steht bei SecondaryMemberBetweenPointsFeatureData.

Mehr dazu: Die Hilfe verweist auf das Thema „Creating Secondary Members with the Up to Members Method“ in der Hilfe zur Oberfläche.

Eigenschaften und Methoden

Eigenschaften 6, davon 6 beschrieben

NameBeschreibung
DistanceMemberLiest oder setzt den Abstand vom Ende des primären Elements, an dem das sekundäre Element bis zu Elementen ansetzt.
LengthRatioMemberLiest oder setzt das Längenverhältnis vom Ende des primären Elements, an dem das sekundäre Element bis zu Elementen ansetzt.
MemberPointParametersTypeLiest oder setzt, ob das sekundäre Element bis zu Elementen von einem Punkt ausgeht oder über Paare aus Punkt und Element entsteht.
RevDirectionDistanceMemberLiest oder setzt, ob der Abstand des sekundären Elements bis zu Elementen in die andere Richtung gilt.
RevDirectionLengthRatioMemberLiest oder setzt, ob das Längenverhältnis des sekundären Elements bis zu Elementen in die andere Richtung gilt.
SecondaryMemberOffsetTypeLiest oder setzt, ob das sekundäre Element bis zu Elementen über einen Abstand oder über ein Längenverhältnis vom Ende festgelegt wird.

Methoden 6, davon 6 beschrieben

NameBeschreibung
GetFromPointLiefert den Punkt, von dem aus das sekundäre Element bis zu Elementen reicht, und seinen Typ.
GetFromPointMembersLiefert die Elemente, zu denen das sekundäre Element vom Punkt aus reicht.
GetPointMemberPairsLiefert die Paare aus Punkt und Element, aus denen die sekundären Elemente bis zu Elementen entstehen.
SetFromPointLegt den Punkt fest, von dem aus das sekundäre Element bis zu Elementen reicht.
SetFromPointMembersLegt die Elemente fest, zu denen das sekundäre Element vom Punkt aus reicht.
SetPointMemberPairsLegt die Paare aus Punkt und Element fest, aus denen die sekundären Elemente bis zu Elementen entstehen.

Siehe auch

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

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