SolidWorksMakroprogrammierung

Objekt · SldWorks

SecondaryMemberBetweenPointsFeatureData-Objekt

Die Daten eines sekundären Tragwerk-Elements zwischen Punkten: das Paar primärer Elemente und der Abstand von deren Enden.

Deklaration Dim x As SldWorks.SecondaryMemberBetweenPointsFeatureData · in der englischen .NET-Hilfe: ISecondaryMemberBetweenPointsFeatureData

Beschreibung

SecondaryMemberBetweenPointsFeatureData gibt Zugriff auf ein sekundäres Element eines Tragwerks (structure system), das zwischen Punkten auf einem Paar primärer Elemente liegt. Die Punkte legst du je primärem Element als Abstand oder als Längenverhältnis vom Ende fest. Die Hilfe hat zu den Befehlen nur die Syntax und Kurzbeschreibungen in der Übersicht, 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 zwischen den Elementen der ersten Profilgruppe des ausgewählten Tragwerks ein
' sekundäres Element an, 50 mm und 40 mm von den Enden entfernt (Ablauf wie im
' Hilfebeispiel "Create Secondary Structure System Members").
' Vorbedingung: Ein Teil mit einem Tragwerk aus zwei primären Elementen in einer
'               Profilgruppe ist offen, das Tragwerk ist ausgewählt. Das Profil
'               ansi inch / c channel / 3 x 5 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 swFeat As SldWorks.Feature
    Dim swTragwerk As SldWorks.StructureSystemFolder
    Dim swGruppenFeat As SldWorks.Feature
    Dim swGruppe As SldWorks.ProfileGroupFolder
    Dim swElement As SldWorks.StructureSystemMemberFeatureData
    Dim swProfil As SldWorks.StructureSystemMemberProfile
    Dim swSekundaer As SldWorks.SecondaryStructuralMemberFeatureData
    Dim swDaten As SldWorks.SecondaryMemberBetweenPointsFeatureData
    Dim aElemente(0) As SldWorks.StructureSystemMemberFeatureData
    Dim vGruppen As Variant, vPrimaer As Variant, vElemente As Variant

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swFeat = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If swFeat Is Nothing Then Exit Sub
    Set swTragwerk = swFeat.GetSpecificFeature2
    If swTragwerk Is Nothing Then Exit Sub
    vGruppen = swTragwerk.GetProfileGroupFolders
    If IsEmpty(vGruppen) Then Exit Sub
    Set swGruppenFeat = vGruppen(0)                       ' wie in den Hilfebeispielen
    Set swGruppe = swGruppenFeat.GetSpecificFeature2
    vPrimaer = swGruppe.GetStructureSystemMembers
    If IsEmpty(vPrimaer) Then Exit Sub

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

    Set swSekundaer = swElement                           ' dieselben Daten, anderer Typ
    Set swDaten = swSekundaer
    If False = swDaten.SetMemberPairs(vPrimaer) Then Exit Sub
    swDaten.SecondaryMemberOffsetType = swSecondaryMemberBetweenPointsDistanceFromEndType_Distance
    swDaten.DistanceMember1 = 0.05                        ' Meter
    swDaten.DistanceMember2 = 0.04
    swDaten.RevDirectionDistanceMember1 = False
    swDaten.RevDirectionDistanceMember2 = 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

Anlegen: Der Ablauf folgt den Bemerkungen zu StructureSystemFolder: Daten mit ModelDocExtension.CreateStructureSystemMemberData anlegen, Profil über StructureSystemMemberFeatureData.MemberProfile setzen, die Daten über SecondaryStructuralMemberFeatureData diesem Typ zuweisen, das Paar und die Abstände setzen und die Daten im zweiten Feld an ModelDocExtension.CreateStructureSystem übergeben. Das Hilfebeispiel „Create Secondary Structure System Members“ übergibt an SecondaryMemberBetweenPointsFeatureData.SetMemberPairs das Array aus ProfileGroupFolder.GetStructureSystemMembers eines primären Tragwerks und setzt die Abstände 0.5 und 0.4.

Ändern: Das Hilfebeispiel holt das Element aus dem neuen Tragwerk, ändert über die allgemeinen Daten die Verlängerung, weist sie diesem Typ zu, stellt auf Längenverhältnis um (SecondaryMemberOffsetType = 1, Verhältnisse 0.1 und 0.2) und ruft Feature.ModifyDefinition mit dem Feature aus StructureSystemMemberFeatureData.GetFeature auf, ohne AccessSelections.

Hilfebeispiel: Das Beispiel „Create Secondary Structure System Members“ steht bei diesem Objekt auch als VBA-Fassung in der .NET-Hilfe. Es legt außerdem Elemente auf einer Stützebene und bis zu Elementen an. Für Einzelheiten verweist die Hilfe auf den PropertyManager „Secondary Member“ in der Hilfe zur Oberfläche.

Einheiten: Die Hilfe nennt keine Einheiten. Die Abstände sind Meter, die Längenverhältnisse Anteile zwischen 0 und 1 der Elementlänge.

Eigenschaften und Methoden

Eigenschaften 10, davon 10 beschrieben

NameBeschreibung
DistanceMember1Liest oder setzt den Abstand vom Ende des ersten primären Elements, an dem das sekundäre Element zwischen Punkten ansetzt.
DistanceMember2Liest oder setzt den Abstand vom Ende des zweiten primären Elements, an dem das sekundäre Element zwischen Punkten ansetzt.
LengthRatioMember1Liest oder setzt das Längenverhältnis vom Ende des ersten primären Elements, an dem das sekundäre Element zwischen Punkten ansetzt.
LengthRatioMember2Liest oder setzt das Längenverhältnis vom Ende des zweiten primären Elements, an dem das sekundäre Element zwischen Punkten ansetzt.
RevDirectionDistanceMember1Liest oder setzt, ob der Abstand am ersten primären Element vom anderen Ende aus gemessen wird.
RevDirectionDistanceMember2Liest oder setzt, ob der Abstand am zweiten primären Element vom anderen Ende aus gemessen wird.
RevDirectionLengthRatioMember1Liest oder setzt, ob das Längenverhältnis am ersten primären Element vom anderen Ende aus gilt.
RevDirectionLengthRatioMember2Liest oder setzt, ob das Längenverhältnis am zweiten primären Element vom anderen Ende aus gilt.
SecondaryMemberOffsetTypeLiest oder setzt, ob das sekundäre Element zwischen Punkten über Abstände oder über Längenverhältnisse von den Enden festgelegt wird.
UnChainMemberPairsLiest oder setzt, ob die Paare primärer Elemente für das sekundäre Element zwischen Punkten verkettet werden.

Methoden 2, davon 2 beschrieben

NameBeschreibung
GetMemberPairsLiefert die primären Elemente, die paarweise das sekundäre Element zwischen Punkten festlegen.
SetMemberPairsLegt die primären Elemente fest, die paarweise das sekundäre Element zwischen Punkten festlegen.

Siehe auch

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

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