SolidWorksMakroprogrammierung

Objekt · SldWorks

BaseFlangeFeatureData-Objekt

Die Feature-Daten einer Basislasche im Blech: Blechdicke, Biegeradius, Endbedingungen, Blechstärkentabelle, Biegezugabe und Freischnitt.

Deklaration Dim x As SldWorks.BaseFlangeFeatureData · in der englischen .NET-Hilfe: IBaseFlangeFeatureData

Beschreibung

Hinter jeder Basislasche eines Blechteils (Typname SMBaseFlange) steckt ein BaseFlangeFeatureData-Objekt mit ihren Feature-Daten. Du liest die Daten mit Feature.GetDefinition und übernimmst Änderungen mit Feature.ModifyDefinition. Mit FeatureManager.CreateDefinition legst du eine neue Basislasche an.

Zugriff

Beispiel

' Gibt Blechdicke, Biegeradius und Endbedingung der ausgewählten Basislasche aus
' und macht sie in Richtung 1 um 10 mm tiefer, wenn die Endbedingung Blind ist.
' Vorbedingung: Ein Blechteil ist offen, seine Basislasche aus einer offenen Skizze
'               ist im FeatureManager ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, die Basislasche ist tiefer.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swFeat As SldWorks.Feature
    Dim swBasis As SldWorks.BaseFlangeFeatureData

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSelMgr = swModel.SelectionManager
    If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelBODYFEATURES Then Exit Sub
    Set swFeat = swSelMgr.GetSelectedObject6(1, -1)
    If swFeat.GetTypeName2 <> "SMBaseFlange" Then Exit Sub

    Set swBasis = swFeat.GetDefinition
    Debug.Print swFeat.Name
    Debug.Print "  Blechdicke:   " & swBasis.Thickness * 1000 & " mm"
    Debug.Print "  Biegeradius:  " & swBasis.BendRadius * 1000 & " mm"
    Debug.Print "  Richtungen:   " & swBasis.OffsetDirections
    Debug.Print "  Endbedingung: " & swBasis.D1EndConditionType      ' Wert aus swFlangeOffsetTypes_e
    If swBasis.UseGaugeTable Then Debug.Print "  Tabelle:      " & swBasis.GaugeTablePath

    If swBasis.D1EndConditionType <> swFlangeOffsetBlind Then Exit Sub
    If swBasis.AccessSelections(swModel, Nothing) Then
        swBasis.D1EndConditionDistance = swBasis.D1EndConditionDistance + 0.01    ' 10 mm tiefer
        If False = swFeat.ModifyDefinition(swBasis, swModel, Nothing) Then Debug.Print "Nicht geändert"
    End If
End Sub

Bemerkungen

Ändern: Du rufst erst BaseFlangeFeatureData.AccessSelections auf. Das setzt das Modell vor die Basislasche zurück. Dann änderst du die Werte und übernimmst sie mit Feature.ModifyDefinition. Ohne Änderung hebst du den Zustand mit BaseFlangeFeatureData.ReleaseSelectionAccess auf.

Neue Basislasche: Nach FeatureManager.CreateDefinition legst du mit swFmBaseFlange eine neue Definition an und musst sie mit BaseFlangeFeatureData.Initialize vorbereiten. Das Hilfebeispiel setzt vorher Endbedingungen, Richtungen und Blechdicke und erstellt die Basislasche danach mit FeatureManager.CreateFeature. Die Skizze ist dabei ausgewählt: Das Beispiel schließt sie mit SketchManager.InsertSketch, danach bleibt sie ausgewählt.

Beim Initialisieren festgelegt: Ob die Blechparameter des Materials gelten, die Biegezugabe und der Freischnitt werden mit Initialize festgelegt. An der Basislasche kannst du sie danach nur noch lesen, etwa mit BaseFlangeFeatureData.UseDefaultBendAllowance, BaseFlangeFeatureData.UseDefaultBendRelief und BaseFlangeFeatureData.ReliefType. Ändern kannst du sie am übergeordneten Blech-Feature (SheetMetalFeatureData). Das Hilfebeispiel holt es mit Feature.GetParents und ändert dort den Freischnitt.

Eigene Werte: BaseFlangeFeatureData.Thickness, BaseFlangeFeatureData.BendRadius und BaseFlangeFeatureData.ReverseThickness kannst du nur setzen, wenn BaseFlangeFeatureData.OverrideDefaultSheetMetalParameters True und BaseFlangeFeatureData.UseMaterialSheetMetalParameters False ist.

Blechstärkentabelle: Nach dem Hilfebeispiel „Create Base-Flange Feature Using Gauge Table“ hängen die Werte voneinander ab. Du setzt sie in dieser Reihenfolge: BaseFlangeFeatureData.UseGaugeTable, BaseFlangeFeatureData.GaugeTablePath, BaseFlangeFeatureData.ThicknessTableName mit einem Namen aus BaseFlangeFeatureData.GetTableThicknesses, dann BaseFlangeFeatureData.TableRadius mit einem Wert aus BaseFlangeFeatureData.GetTableRadii. Eigene Werte statt der Tabellenwerte erlauben BaseFlangeFeatureData.OverrideThickness, BaseFlangeFeatureData.OverrideRadius und BaseFlangeFeatureData.OverrideKFactor. Das Beispiel ist älter als Initialize und ruft es nicht auf.

Einheiten: Längen sind in Metern, auch Tiefen und Freischnitt. Eine Tiefe von 0,04 ergab ein 40 mm tiefes Blech, Gauge 12 der metrischen Beispieltabelle hatte die Dicke 0,0025.

Veraltet: Seit SOLIDWORKS 2022 ersetzen die Eigenschaften D1EndCondition… und D2EndCondition… die veralteten D1Offset… und D2Offset…, etwa BaseFlangeFeatureData.D1OffsetDistance. Auch FeatureManager.InsertSheetMetalBaseFlange2 ist veraltet, an seine Stelle tritt CreateDefinition.

Getestet: Das Beispiel lief in SOLIDWORKS 2024 an einer Basislasche aus einer offenen L-Skizze (50 × 30 mm), erstellt mit CreateDefinition, Initialize und CreateFeature. Es gab 2 mm Dicke, 3 mm Radius, 2 Richtungen und die Endbedingung 1 (Blind) aus und machte die Lasche 10 mm tiefer, von 50 auf 60 mm.

Mehrere Werte lieferten beim Lesen nicht das, was beim Erstellen galt: BaseFlangeFeatureData.OverrideDefaultSheetMetalParameters False, obwohl die eigene Dicke galt, BaseFlangeFeatureData.UseDefaultBendAllowance immer False und BaseFlangeFeatureData.UseDefaultBendRelief immer True. Verlass dich bei diesen drei nicht auf den gelesenen Wert.

Eigenschaften und Methoden

Eigenschaften 39, davon 33 beschrieben, 6 veraltet

NameBeschreibung
BendRadiusLiest oder setzt den Biegeradius der Basislasche, in Metern.
D1EndConditionDistanceLiest oder setzt den Abstand für die Endbedingung der Basislasche in Richtung 1, bei Blind die Tiefe.
D1EndConditionReferenceLiest oder setzt das Element, bis zu dem die Basislasche in Richtung 1 reicht, etwa bei der Endbedingung Bis Fläche.
D1EndConditionTypeLiest oder setzt die Endbedingung der Basislasche in Richtung 1, etwa Blind oder Bis Fläche.
D1OffsetDistanceveraltet ersetzt durch BaseFlangeFeatureData.D1EndConditionDistance
D1OffsetReferenceveraltet ersetzt durch BaseFlangeFeatureData.D1EndConditionReference
D1OffsetTypeveraltet ersetzt durch BaseFlangeFeatureData.D1EndConditionType
D1ReverseOffsetLiest oder setzt, ob Richtung 1 der Basislasche umgekehrt ist.
D2EndConditionDistanceLiest oder setzt den Abstand für die Endbedingung der Basislasche in Richtung 2, bei Blind die Tiefe.
D2EndConditionReferenceLiest oder setzt das Element, bis zu dem die Basislasche in Richtung 2 reicht, etwa bei der Endbedingung Bis Fläche.
D2EndConditionTypeLiest oder setzt die Endbedingung der Basislasche in Richtung 2, etwa Blind oder Bis Fläche.
D2OffsetDistanceveraltet ersetzt durch BaseFlangeFeatureData.D2EndConditionDistance
D2OffsetReferenceveraltet ersetzt durch BaseFlangeFeatureData.D2EndConditionReference
D2OffsetTypeveraltet ersetzt durch BaseFlangeFeatureData.D2EndConditionType
D2ReverseOffsetLiest oder setzt, ob Richtung 2 der Basislasche umgekehrt ist.
GaugeTablePathLiest oder setzt den Pfad zur Blechstärkentabelle der Basislasche.
KFactorLiest oder setzt den K-Faktor der Basislasche.
OffsetDirectionsLiest oder setzt, in wie viele Richtungen die Basislasche ausgetragen wird, 1 oder 2.
OverrideDefaultSheetMetalParametersLiest oder setzt, ob die Basislasche eigene Blechparameter statt der Vorgaben verwendet.
OverrideKFactorLiest oder setzt, ob statt des K-Faktors aus der Blechstärkentabelle ein eigener Wert gilt.
OverrideRadiusLiest oder setzt, ob statt des Biegeradius aus der Blechstärkentabelle ein eigener Wert gilt.
OverrideThicknessLiest oder setzt, ob statt der Blechdicke aus der Blechstärkentabelle ein eigener Wert gilt.
ReliefDepthLiefert die Tiefe des Biegefreischnitts der Basislasche.
ReliefRatioLiefert das Verhältnis, mit dem der Biegefreischnitt der Basislasche bemessen ist.
ReliefTypeLiefert die Art des Biegefreischnitts der Basislasche, etwa rechteckig oder als Riss.
ReliefWidthLiefert die Breite des Biegefreischnitts der Basislasche.
ReverseDirectionLiest oder setzt, ob die Basislasche in die Gegenrichtung ausgetragen wird.
ReverseThicknessLiest oder setzt, ob die Blechdicke zur anderen Seite der Skizze aufgetragen wird.
SymmetricThicknessLiest oder setzt, ob die Blechdicke bei einer Basislasche in zwei Richtungen symmetrisch aufgetragen wird.
TableKFactorLiefert den K-Faktor aus der Blechstärkentabelle der Basislasche.
TableRadiusLiest oder setzt den Biegeradius aus der Blechstärkentabelle der Basislasche, in Metern.
TableThicknessLiest oder setzt die Blechdicke aus der Blechstärkentabelle der Basislasche, in Metern.
ThicknessLiest oder setzt die Blechdicke der Basislasche, in Metern.
ThicknessTableNameLiest oder setzt, welche Blechdicke aus der Blechstärkentabelle gilt, über ihren Namen.
UseDefaultBendAllowanceLiefert, ob die Basislasche die Biegezugabe des übergeordneten Blech-Features verwendet.
UseDefaultBendReliefLiefert, ob die Basislasche den Biegefreischnitt des übergeordneten Blech-Features verwendet.
UseGaugeTableLiest oder setzt, ob die Basislasche eine Blechstärkentabelle verwendet.
UseMaterialSheetMetalParametersLiefert, ob für die Basislasche die Blechparameter des zugewiesenen Materials gelten.
UseReliefRatioLiefert, ob der Biegefreischnitt der Basislasche über ein Verhältnis bemessen ist.

Methoden 10, davon 10 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Basislasche zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen.
GetCustomBendAllowanceLiefert die eigene Biegezugabe der Basislasche.
GetD1OffsetReferenceTypeLiefert, welche Art von Element die Endbedingung der Basislasche in Richtung 1 festlegt, etwa Fläche oder Eckpunkt.
GetD2OffsetReferenceTypeLiefert, welche Art von Element die Endbedingung der Basislasche in Richtung 2 festlegt, etwa Fläche oder Eckpunkt.
GetTableRadiiLiefert die Biegeradien, die die Blechstärkentabelle für eine Blechdicke kennt.
GetTableRadiiCountLiefert, wie viele Biegeradien die Blechstärkentabelle für eine Blechdicke kennt.
GetTableThicknessesLiefert die Namen der Blechdicken aus der Blechstärkentabelle der Basislasche.
GetTableThicknessesCountLiefert, wie viele Blechdicken die Blechstärkentabelle der Basislasche enthält.
InitializeLegt bei einer neuen Basislasche Material, Biegezugabe und Biegefreischnitt fest. Danach lassen sich diese Werte nicht mehr ändern.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Basislasche nicht geändert hast.

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

Siehe auch

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

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