SolidWorksMakroprogrammierung

Objekt · SldWorks

StructureSystemMemberFeatureData-Objekt

Die allgemeinen Daten eines Elements in einem Tragwerk: Art, Profil, Verlängerung an den Enden, Teilung, Körper und Feature.

Deklaration Dim x As SldWorks.StructureSystemMemberFeatureData · in der englischen .NET-Hilfe: IStructureSystemMemberFeatureData

Beschreibung

StructureSystemMemberFeatureData gibt Zugriff auf ein Element eines Tragwerks (structure system). Das Objekt ist die Oberklasse von PrimaryStructuralMemberFeatureData und SecondaryStructuralMemberFeatureData. Es hält, was allen Elementen gemeinsam ist: ob das Element primär oder sekundär ist, sein Profil, wie weit es an den Enden verlängert wird und ob es geteilt wird. Die Befehle gibt es seit SOLIDWORKS 2022.

Zugriff

Beispiel

' Gibt die Daten des ersten Elements der ersten Profilgruppe aus und verlängert es
' an beiden Enden um 10 mm.
' Vorbedingung: Ein Teil mit einem Tragwerk ist offen, das Tragwerk ist im
'               FeatureManager ausgewählt.
' Ergebnis:     Das Element ist länger, die Werte stehen im Direktfenster (Strg+G).
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 vGruppen 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
    vElemente = swGruppe.GetStructureSystemMembers
    If IsEmpty(vElemente) Then Exit Sub
    Set swElement = vElemente(0)

    Set swFeat = swElement.GetFeature
    Set swProfil = swElement.MemberProfile
    Debug.Print swFeat.Name & ": " & IIf(swElement.StructureSystemMemberType = swStructureSystemMemberType_Primary, "primär", "sekundär")
    Debug.Print "Profil: " & swProfil.ProfileStandard & " / " & swProfil.ProfileType & " / " & swProfil.ProfileSize
    Debug.Print "Verlängerung: " & swElement.StartEndExtendD1 * 1000 & " mm / " & swElement.StartEndExtendD2 * 1000 & " mm"

    If swElement.AccessSelections(swModel, Nothing) Then
        swElement.StartEndExtendD1 = swElement.StartEndExtendD1 + 0.01
        swElement.StartEndExtendD2 = swElement.StartEndExtendD2 + 0.01
        If False = swFeat.ModifyDefinition(swElement, swModel, Nothing) Then swElement.ReleaseSelectionAccess
    End If
End Sub

Bemerkungen

Typen umwandeln: Nach StructureSystemMemberFeatureData.StructureSystemMemberType weist du die Daten einer Variablen vom Typ PrimaryStructuralMemberFeatureData oder SecondaryStructuralMemberFeatureData zu und von dort weiter dem Typ der Erzeugungsart. Den Ablauf beschreibt die Hilfe bei StructureSystemFolder.

Ändern: Vor dem Ändern rufst du StructureSystemMemberFeatureData.AccessSelections auf und zum Schluss Feature.ModifyDefinition mit dem Feature aus StructureSystemMemberFeatureData.GetFeature. Änderst du nichts, rufst du StructureSystemMemberFeatureData.ReleaseSelectionAccess auf. Das Hilfebeispiel zu PrimaryMemberPathSegmentFeatureData („Create Path Segment Structure System Member“, in VBA, VB.NET und C#) ändert die Verlängerung dagegen ohne AccessSelections und ruft gleich Feature.ModifyDefinition auf.

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

Eigenschaften und Methoden

Eigenschaften 5, davon 5 beschrieben

NameBeschreibung
IsSplitLiest oder setzt, ob dieses Tragwerk-Element geteilt wird.
MemberProfileLiefert das Profil dieses Tragwerk-Elements, etwa Norm, Typ und Größe.
StartEndExtendD1Liest oder setzt, wie weit dieses Tragwerk-Element in Richtung 1 verlängert wird.
StartEndExtendD2Liest oder setzt, wie weit dieses Tragwerk-Element in Richtung 2 verlängert wird.
StructureSystemMemberTypeLiefert, ob dieses Tragwerk-Element ein primäres oder ein sekundäres Element ist.

Methoden 5, davon 5 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Tragwerk-Element zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetBodyLiefert den Körper dieses Tragwerk-Elements.
GetFeatureLiefert das Feature dieses Tragwerk-Elements.
GetSplitMemberLiefert die Angaben zur Teilung dieses Tragwerk-Elements.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Tragwerk-Element nicht geändert hast.

Siehe auch

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

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