Objekt · SldWorks
PrimaryMemberPointLengthFeatureData-Objekt
Die Daten eines primären Tragwerk-Elements über Punkt und Länge: Startpunkte, Richtung und Endbedingung.
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
- Die Daten eines primären Elements (
PrimaryStructuralMemberFeatureDataoderStructureSystemMemberFeatureData) einer Variablen dieses Typs zugewiesen. Das geht, wennPrimaryStructuralMemberFeatureData.PrimaryMemberTypeswStructureSystemMemberCreationType_Primary_PointLengthliefert. - Neue Daten:
ModelDocExtension.CreateStructureSystemMemberDatamitswStructureSystemMemberCreationType_Primary_PointLength - Das Feature eines solchen Elements hat den Typnamen
StrctSysSkPtLenMbrFeat(Tabelle beiFeature.GetTypeName2), seine Daten liefertFeature.GetDefinition.
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| DirectionReference | Liest oder setzt den Bezug, der die Richtung des primären Elements über Punkt und Länge angibt. |
| EndCondition | Liest oder setzt, wie das primäre Element über Punkt und Länge endet: nach einer Länge, an einem Punkt oder an einer Ebene. |
| EndPlane | Liest oder setzt die Ebene, an der das primäre Element über Punkt und Länge endet. |
| EndPoint | Liest oder setzt den Skizzenpunkt, an dem das primäre Element über Punkt und Länge endet. |
| Length | Liest oder setzt die Länge des primären Elements über Punkt und Länge. |
| ReverseDirection | Liest oder setzt, ob das primäre Element über Punkt und Länge in die Gegenrichtung verläuft. |
| UnChainPointsAndLength | Liest oder setzt, ob die Punkte des primären Elements über Punkt und Länge verkettet werden. |
Methoden 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| GetPoints | Liefert die Ecken, Skizzenpunkte und Referenzpunkte, an denen die primären Elemente über Punkt und Länge beginnen. |
| GetPointsTypes | Liefert die Typen der Punkte, an denen die primären Elemente über Punkt und Länge beginnen. |
| SetPoints | Legt 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.