SolidWorksMakroprogrammierung

Objekt · SldWorks

FlatPatternFeatureData-Objekt

Die Feature-Daten der Abwicklung eines Blechteils: feste Fläche, ausgeschlossene Flächen, Flächen zusammenführen, Biegungen vereinfachen, Eckenbehandlung, Ecken brechen und Eckentrimmung.

Deklaration Dim x As SldWorks.FlatPatternFeatureData · in der englischen .NET-Hilfe: IFlatPatternFeatureData

Beschreibung

FlatPatternFeatureData gibt Zugriff auf ein Abwicklungs-Feature (Flat-Pattern). Ein Mehrkörper-Blechteil ab SOLIDWORKS 2013 hat mehrere davon im Abwicklungs-Ordner (FlatPatternFolder). Die meisten Befehle gibt es seit SOLIDWORKS 2003.

Zugriff

Beispiel

' Sucht das erste Abwicklungs-Feature des Blechteils und gibt feste Fläche,
' ausgeschlossene Flächen und einige Einstellungen aus.
' Vorbedingung: Ein Blechteil ist offen.
' Ergebnis:     Die Werte stehen im Direktfenster, das Teil bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swFeat As SldWorks.Feature
    Dim swDaten As SldWorks.FlatPatternFeatureData
    Dim swFest As Object
    Dim vFlaechen As Variant

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swFeat = swModel.FirstFeature
    Do While Not swFeat Is Nothing
        If swFeat.GetTypeName2 = "FlatPattern" Then Exit Do
        Set swFeat = swFeat.GetNextFeature
    Loop
    If swFeat Is Nothing Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    Debug.Print swFeat.Name & ": Flächen zusammenführen " & swDaten.MergeFace & _
                ", Biegungen vereinfachen " & swDaten.SimplifyBends & _
                ", Eckenbehandlung " & swDaten.CornerTreatment
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    Set swFest = swDaten.FixedFace2
    If swFest Is Nothing Then
        Debug.Print "  Keine feste Fläche"
    ElseIf TypeOf swFest Is SldWorks.Face2 Then
        Debug.Print "  Feste Fläche auf Körper " & swFest.GetBody.Name
    Else
        Debug.Print "  Feste Kante (zylindrisches Blech)"
    End If
    vFlaechen = swDaten.ExcludedFaces
    If IsArray(vFlaechen) Then Debug.Print "  Ausgeschlossene Flächen: " & UBound(vFlaechen) + 1
    swDaten.ReleaseSelectionAccess
End Sub

Bemerkungen

Hilfebeispiele: „Get Fixed Face of Flat-Pattern Feature“ liest beim ausgewählten Abwicklungs-Feature nach AccessSelections die feste Fläche und wählt sie aus. „Exclude Faces Before Flattening“ unterdrückt die Abwicklung, schließt 22 Flächen aus und hebt die Unterdrückung wieder auf. „Get All Sheet Metal Feature Data“ gibt beim Typnamen FlatPattern nur FlatPatternFeatureData.SimplifyBends aus.

Ändern: Rufe vorher FlatPatternFeatureData.AccessSelections auf, setze die Werte und übernimm sie mit Feature.ModifyDefinition. Änderst du nichts, rufst du FlatPatternFeatureData.ReleaseSelectionAccess auf.

Abwickeln: Ob das Teil abgewickelt angezeigt wird, steuerst du mit ModelDoc2.SetBendState oder über die Unterdrückung des Abwicklungs-Features, so steht es bei OneBendFeatureData.FlatPatternSketchSegments2.

Veraltet: Die feste Fläche lieferte früher FlatPatternFeatureData.FixedFace. FlatPatternFeatureData.FixedFace2 liefert sie bei Blechteilen aus jeder SOLIDWORKS-Version.

Einheiten: Für FlatPatternFeatureData.BreakCornerRadius und FlatPatternFeatureData.CornerTrimReliefDistance nennt die Hilfe keine Einheit. Es sind Meter.

Eckfreischnitte: Eckfreischnitte als eigenes Feature legst du mit FeatureManager.AddCornerReliefCorner, FeatureManager.AddCornerReliefType und FeatureManager.FinishCornerRelief an. Die Hilfe verweist bei FinishCornerRelief auf dieses Objekt, sagt aber nicht, wie beides zusammenhängt.

Absturz: Nach FlatPatternFeatureData.AccessSelections kann SOLIDWORKS beim Aufruf von FlatPatternFeatureData.ReleaseSelectionAccess abstürzen.

Eigenschaften und Methoden

Eigenschaften 13, davon 12 beschrieben, 1 veraltet

NameBeschreibung
BreakCornerRadiusLiest oder setzt den Radius beim Ecken brechen in der Abwicklung.
BreakCornerTypeLiest oder setzt, ob beim Ecken brechen in der Abwicklung verrundet oder angefast wird.
CornerTreatmentLiest oder setzt, ob die Abwicklung die Eckenbehandlung anwendet, also glatte Kanten in der Abwicklung erzeugt.
CornerTrimRatioToThicknessLiest oder setzt das Verhältnis zur Blechdicke, mit dem der Freischnitt der Eckentrimmung bemessen wird.
CornerTrimReliefDistanceLiest oder setzt das Maß des Freischnitts der Eckentrimmung in der Abwicklung.
CornerTrimReliefTypeLiest oder setzt die Form des Freischnitts der Eckentrimmung in der Abwicklung.
ExcludedFacesLiest oder setzt die Flächen, die dieses Abwicklungs-Feature nicht abwickelt.
FixedFaceveraltet ersetzt durch FlatPatternFeatureData.FixedFace2
FixedFace2Liest oder setzt die feste Fläche dieses Abwicklungs-Features, bei zylindrischem Blech eine Kante.
MergeFaceLiest oder setzt, ob die Abwicklung ebene, zusammenfallende Flächen zusammenführt.
ShowSlitInCornerReliefLiest oder setzt, ob die Abwicklung den Schlitz im Eckfreischnitt zeigt.
SimplifyBendsLiest oder setzt, ob die Abwicklung Biegungen vereinfacht, also Kanten zu Linien macht.
UseRatioToThicknessLiest oder setzt, ob der Freischnitt der Eckentrimmung über das Verhältnis zur Blechdicke bemessen wird.

Methoden 6, davon 6 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Abwicklungs-Feature zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetAddCornerTrimLiefert, ob die Abwicklung eine Eckentrimmung hinzufügt.
GetBreakCornersLiefert, ob die Abwicklung Ecken bricht.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Abwicklungs-Feature nicht geändert hast.
SetAddCornerTrimLegt fest, ob die Abwicklung eine Eckentrimmung hinzufügt.
SetBreakCornersLegt fest, ob die Abwicklung Ecken bricht.

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

Siehe auch

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

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