SolidWorksMakroprogrammierung

Objekt · SldWorks

PrimaryMemberPointLengthFeatureData-Objekt

Die Daten eines primären Tragwerk-Elements über Punkt und Länge: Startpunkte, Richtung und Endbedingung.

Deklaration Dim x As SldWorks.PrimaryMemberPointLengthFeatureData · in der englischen .NET-Hilfe: IPrimaryMemberPointLengthFeatureData

Beschreibung

PrimaryMemberPointLengthFeatureData gibt Zugriff auf ein primäres Element eines Tragwerks (structure system), das an einem Punkt beginnt und bis zu einer Endbedingung reicht: einer festen Länge, einem Punkt oder einer Ebene. Als Startpunkte nimmt es Ecken, Skizzenpunkte und Referenzpunkte, je Punkt entsteht ein Element. Die meisten Befehle gibt es seit SOLIDWORKS 2022, DirectionReference, ReverseDirection und UnChainPointsAndLength haben nur die Syntax und Kurzbeschreibungen in der Übersicht, vermutlich gibt es sie ebenso lange.

Zugriff

Beispiel

' Legt ein Tragwerk an, in dem an jedem ausgewählten Skizzenpunkt ein primäres
' Element von 500 mm Länge beginnt (Ablauf wie im Hilfebeispiel zu diesem Objekt).
' Vorbedingung: Ein Teil ist offen, ein oder mehrere Skizzenpunkte sind ausgewählt.
'               Das Profil ansi inch / c channel / 3 x 5 ist vorhanden.
' Ergebnis:     Ein neues Tragwerk mit je einem Element pro Punkt.
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.PrimaryMemberPointLengthFeatureData
    Dim aPunkte() As Object
    Dim aElemente(0) As SldWorks.StructureSystemMemberFeatureData
    Dim vElemente As Variant
    Dim swFeat As SldWorks.Feature
    Dim nAnzahl As Long, i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSelMgr = swModel.SelectionManager
    nAnzahl = swSelMgr.GetSelectedObjectCount2(-1)
    If nAnzahl = 0 Then Exit Sub
    ReDim aPunkte(nAnzahl - 1)
    For i = 1 To nAnzahl
        Set aPunkte(i - 1) = swSelMgr.GetSelectedObject6(i, -1)
    Next i

    Set swElement = swModel.Extension.CreateStructureSystemMemberData(swStructureSystemMemberCreationType_Primary_PointLength)
    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.EndCondition = swPrimaryMemberPointLengthEndCondition_Length
    If False = swDaten.SetPoints(aPunkte) Then Exit Sub
    swDaten.Length = 0.5                                  ' 500 mm, in Metern
    swDaten.ReverseDirection = False

    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

Endbedingung: PrimaryMemberPointLengthFeatureData.Length gilt nur bei swPrimaryMemberPointLengthEndCondition_Length, PrimaryMemberPointLengthFeatureData.EndPoint nur bei swPrimaryMemberPointLengthEndCondition_UpToPoint und PrimaryMemberPointLengthFeatureData.EndPlane nur bei swPrimaryMemberPointLengthEndCondition_UpToPlane (swPrimaryMemberPointLengthEndCondition_e). Für swPrimaryMemberPointLengthEndCondition_Point nennt die Hilfe keine eigene Eigenschaft.

Richtung: In welche Richtung das Element ohne PrimaryMemberPointLengthFeatureData.DirectionReference verläuft, sagt die Hilfe nicht. Das Hilfebeispiel setzt keinen Richtungsbezug.

Hilfebeispiel: Das VBA-Beispiel der Hilfe zu diesem Objekt legt drei Skizzen mit je einem Punkt an, übergibt die drei Punkte an PrimaryMemberPointLengthFeatureData.SetPoints, setzt die Länge 5 und erhält drei Elemente. Danach ändert es bei einem Element die Länge auf 1 und die Verlängerung über die allgemeinen Daten und ruft Feature.ModifyDefinition mit dem Feature aus StructureSystemMemberFeatureData.GetFeature auf, ohne StructureSystemMemberFeatureData.AccessSelections. Der Ablauf zum Anlegen folgt den Bemerkungen zu StructureSystemFolder, wie bei PrimaryMemberPathSegmentFeatureData.

Mehr dazu: Die Hilfe verweist auf den PropertyManager „Primary Member“ in der Hilfe zur Oberfläche.

Ohne PrimaryMemberPointLengthFeatureData.DirectionReference verläuft das Element senkrecht zur Skizzenebene des Startpunkts.

Eigenschaften und Methoden

Eigenschaften 7, davon 7 beschrieben

NameBeschreibung
DirectionReferenceLiest oder setzt den Bezug, der die Richtung des primären Elements über Punkt und Länge angibt.
EndConditionLiest oder setzt, wie das primäre Element über Punkt und Länge endet: nach einer Länge, an einem Punkt oder an einer Ebene.
EndPlaneLiest oder setzt die Ebene, an der das primäre Element über Punkt und Länge endet.
EndPointLiest oder setzt den Skizzenpunkt, an dem das primäre Element über Punkt und Länge endet.
LengthLiest oder setzt die Länge des primären Elements über Punkt und Länge.
ReverseDirectionLiest oder setzt, ob das primäre Element über Punkt und Länge in die Gegenrichtung verläuft.
UnChainPointsAndLengthLiest oder setzt, ob die Punkte des primären Elements über Punkt und Länge verkettet werden.

Methoden 3, davon 3 beschrieben

NameBeschreibung
GetPointsLiefert die Ecken, Skizzenpunkte und Referenzpunkte, an denen die primären Elemente über Punkt und Länge beginnen.
GetPointsTypesLiefert die Typen der Punkte, an denen die primären Elemente über Punkt und Länge beginnen.
SetPointsLegt die Ecken, Skizzenpunkte und Referenzpunkte fest, an denen die primären Elemente über Punkt und Länge beginnen.

Siehe auch

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

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