SolidWorksMakroprogrammierung

Objekt · SldWorks

StructuralMemberFeatureData-Objekt

Die Definition eines Strukturbauteils in einer Schweißkonstruktion: Profil, Gruppen, Pfadsegmente, Eckenbehandlung, Drehung und Material des Profils.

Deklaration Dim x As SldWorks.StructuralMemberFeatureData · in der englischen .NET-Hilfe: IStructuralMemberFeatureData

Beschreibung

StructuralMemberFeatureData gibt Zugriff auf ein Strukturbauteil einer Schweißkonstruktion. Ein Strukturbauteil führt ein Profil (*.sldlfp) entlang von Skizzensegmenten. Neuere Strukturbauteile teilen die Segmente in Gruppen (StructuralMemberGroup) mit eigenen Einstellungen. Die ersten Befehle gibt es seit SOLIDWORKS 2005, die Gruppen seit SOLIDWORKS 2009 SP05.

Zugriff

Angelegt wird ein Strukturbauteil mit FeatureManager.InsertStructuralWeldment5.

Beispiel

' Gibt Profil und Gruppen des ausgewählten Strukturbauteils aus und fasst bei Gruppen mit
' Gehrung die auf Gehrung geschnittenen Körper zusammen.
' Vorbedingung: Ein Teil mit Schweißkonstruktion ist offen, ein Strukturbauteil ist im
'               FeatureManager ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, das Strukturbauteil ist geändert.
Option Explicit

Sub main()
    Const PI As Double = 3.14159265358979
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swDaten As SldWorks.StructuralMemberFeatureData
    Dim swGruppe As SldWorks.StructuralMemberGroup
    Dim vGruppen As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
    Set swFeat = swSel
    If swFeat.GetTypeName2 <> "WeldMemberFeat" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    Debug.Print swFeat.Name & ": " & swDaten.WeldmentProfilePath
    If swDaten.GetGroupsCount > 0 Then
        vGruppen = swDaten.Groups
        For i = 0 To UBound(vGruppen)
            Set swGruppe = vGruppen(i)
            Debug.Print "  Gruppe " & i + 1 & ": " & swGruppe.GetSegmentsCount & " Segment(e), Drehung " & _
                        Round(swGruppe.Angle * 180 / PI, 1) & "°"
            If swGruppe.ApplyCornerTreatment And swGruppe.CornerTreatmentType = swEndConditionMiter Then
                swGruppe.MiterMergeCondition = True
            End If
        Next i
    End If
    If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
End Sub

Bemerkungen

Gruppen oder einzelne Werte: StructuralMemberFeatureData.Groups gilt nur bei Features, die Gruppen haben, also wenn StructuralMemberFeatureData.GetGroupsCount größer als 0 ist. Drehung, Eckenbehandlung und Profilpunkt stehen dann vermutlich in den Gruppen. Die gleichnamigen Eigenschaften dieses Objekts stammen aus der Zeit vor den Gruppen. Wie sie bei Features mit Gruppen wirken, sagt die Hilfe nicht.

Ändern: Nach StructuralMemberFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du StructuralMemberFeatureData.ReleaseSelectionAccess auf. Das Hilfebeispiel „Set Profile for Structural Member“ ändert so das Profil. Für die meisten Eigenschaften verweist die Hilfe auf das Thema „Accessing Selections that Define Features“.

Typnamen: Wie bei Feature.GetTypeName2 steht, liefert auch ein Feature mit dem Typnamen WeldmentFeature dieses Objekt. Was die Daten dort bedeuten, sagt die Hilfe nicht.

Eigenschaften und Methoden

Eigenschaften 13, davon 13 beschrieben

NameBeschreibung
AllowProtrusionLiest oder setzt, ob das Strukturbauteil überstehen darf.
ApplyCornerTreatmentLiest oder setzt, ob das Strukturbauteil eine Eckenbehandlung bekommt.
ConfigurationNameLiest oder setzt die Konfiguration des eigenen Profils, das das Strukturbauteil verwendet.
ConnectedSegmentsOptionLiest oder setzt, wie verbundene Segmente zugeschnitten werden: einfacher Schnitt oder Ausklinkung.
ConnectionTypeLiest oder setzt die Art der Eckenbehandlung an einem Verbindungspunkt des Strukturbauteils.
CornerTreatmentTypeLiest oder setzt die Art der Eckenbehandlung des Strukturbauteils, etwa Gehrung oder Stoß.
GroupsLiest oder setzt die Gruppen des Strukturbauteils.
LibraryProfileMaterialLiefert den Namen des Materials im Bibliotheksprofil des Strukturbauteils.
LocateProfilePointLiest oder setzt den Punkt, an dem das Profil des Strukturbauteils ausgerichtet wird.
PathSegmentsLiest oder setzt die Pfadsegmente, entlang derer das Strukturbauteil läuft.
RotationAngleLiest oder setzt den Winkel, um den das Strukturbauteil gegenüber dem benachbarten Strukturbauteil gedreht ist.
TransferMaterialLiest oder setzt, ob das Material des Bibliotheksprofils in das Strukturbauteil übernommen wird.
WeldmentProfilePathLiest oder setzt Pfad und Dateiname des Profils für das Strukturbauteil.

Methoden 8, davon 8 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Strukturbauteil zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetConnectionPointsLiefert die Verbindungspunkte des Strukturbauteils.
GetConnectionPointsCountLiefert die Zahl der Verbindungspunkte des Strukturbauteils.
GetGroupsCountLiefert die Zahl der Gruppen des Strukturbauteils.
GetPathSegmentAtLiefert das Skizzensegment, zu dem ein Körper des Strukturbauteils gehört.
GetPathSegmentsCountLiefert die Zahl der Pfadsegmente des Strukturbauteils.
GetSketchSegmentsLiefert die Skizzensegmente, die den Pfad eines Körpers des Strukturbauteils bilden.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Strukturbauteil nicht geändert hast.

Nicht aufgeführt sind 5 C++-Varianten (Namen mit I davor, zum Beispiel IGetConnectionPoints). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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