Objekt · SldWorks
BaseFlangeFeatureData-Objekt
Die Feature-Daten einer Basislasche im Blech: Blechdicke, Biegeradius, Endbedingungen, Blechstärkentabelle, Biegezugabe und Freischnitt.
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
Feature.GetDefinition: aus einem Feature mit dem TypnamenSMBaseFlangeFeatureManager.CreateDefinitionmitswFmBaseFlange: eine neue Definition fürFeatureManager.CreateFeature
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 SubBemerkungen
Ä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
| Name | Beschreibung |
|---|---|
| BendRadius | Liest oder setzt den Biegeradius der Basislasche, in Metern. |
| D1EndConditionDistance | Liest oder setzt den Abstand für die Endbedingung der Basislasche in Richtung 1, bei Blind die Tiefe. |
| D1EndConditionReference | Liest oder setzt das Element, bis zu dem die Basislasche in Richtung 1 reicht, etwa bei der Endbedingung Bis Fläche. |
| D1EndConditionType | Liest oder setzt die Endbedingung der Basislasche in Richtung 1, etwa Blind oder Bis Fläche. |
| D1OffsetDistance | veraltet ersetzt durch BaseFlangeFeatureData.D1EndConditionDistance |
| D1OffsetReference | veraltet ersetzt durch BaseFlangeFeatureData.D1EndConditionReference |
| D1OffsetType | veraltet ersetzt durch BaseFlangeFeatureData.D1EndConditionType |
| D1ReverseOffset | Liest oder setzt, ob Richtung 1 der Basislasche umgekehrt ist. |
| D2EndConditionDistance | Liest oder setzt den Abstand für die Endbedingung der Basislasche in Richtung 2, bei Blind die Tiefe. |
| D2EndConditionReference | Liest oder setzt das Element, bis zu dem die Basislasche in Richtung 2 reicht, etwa bei der Endbedingung Bis Fläche. |
| D2EndConditionType | Liest oder setzt die Endbedingung der Basislasche in Richtung 2, etwa Blind oder Bis Fläche. |
| D2OffsetDistance | veraltet ersetzt durch BaseFlangeFeatureData.D2EndConditionDistance |
| D2OffsetReference | veraltet ersetzt durch BaseFlangeFeatureData.D2EndConditionReference |
| D2OffsetType | veraltet ersetzt durch BaseFlangeFeatureData.D2EndConditionType |
| D2ReverseOffset | Liest oder setzt, ob Richtung 2 der Basislasche umgekehrt ist. |
| GaugeTablePath | Liest oder setzt den Pfad zur Blechstärkentabelle der Basislasche. |
| KFactor | Liest oder setzt den K-Faktor der Basislasche. |
| OffsetDirections | Liest oder setzt, in wie viele Richtungen die Basislasche ausgetragen wird, 1 oder 2. |
| OverrideDefaultSheetMetalParameters | Liest oder setzt, ob die Basislasche eigene Blechparameter statt der Vorgaben verwendet. |
| OverrideKFactor | Liest oder setzt, ob statt des K-Faktors aus der Blechstärkentabelle ein eigener Wert gilt. |
| OverrideRadius | Liest oder setzt, ob statt des Biegeradius aus der Blechstärkentabelle ein eigener Wert gilt. |
| OverrideThickness | Liest oder setzt, ob statt der Blechdicke aus der Blechstärkentabelle ein eigener Wert gilt. |
| ReliefDepth | Liefert die Tiefe des Biegefreischnitts der Basislasche. |
| ReliefRatio | Liefert das Verhältnis, mit dem der Biegefreischnitt der Basislasche bemessen ist. |
| ReliefType | Liefert die Art des Biegefreischnitts der Basislasche, etwa rechteckig oder als Riss. |
| ReliefWidth | Liefert die Breite des Biegefreischnitts der Basislasche. |
| ReverseDirection | Liest oder setzt, ob die Basislasche in die Gegenrichtung ausgetragen wird. |
| ReverseThickness | Liest oder setzt, ob die Blechdicke zur anderen Seite der Skizze aufgetragen wird. |
| SymmetricThickness | Liest oder setzt, ob die Blechdicke bei einer Basislasche in zwei Richtungen symmetrisch aufgetragen wird. |
| TableKFactor | Liefert den K-Faktor aus der Blechstärkentabelle der Basislasche. |
| TableRadius | Liest oder setzt den Biegeradius aus der Blechstärkentabelle der Basislasche, in Metern. |
| TableThickness | Liest oder setzt die Blechdicke aus der Blechstärkentabelle der Basislasche, in Metern. |
| Thickness | Liest oder setzt die Blechdicke der Basislasche, in Metern. |
| ThicknessTableName | Liest oder setzt, welche Blechdicke aus der Blechstärkentabelle gilt, über ihren Namen. |
| UseDefaultBendAllowance | Liefert, ob die Basislasche die Biegezugabe des übergeordneten Blech-Features verwendet. |
| UseDefaultBendRelief | Liefert, ob die Basislasche den Biegefreischnitt des übergeordneten Blech-Features verwendet. |
| UseGaugeTable | Liest oder setzt, ob die Basislasche eine Blechstärkentabelle verwendet. |
| UseMaterialSheetMetalParameters | Liefert, ob für die Basislasche die Blechparameter des zugewiesenen Materials gelten. |
| UseReliefRatio | Liefert, ob der Biegefreischnitt der Basislasche über ein Verhältnis bemessen ist. |
Methoden 10, davon 10 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die Basislasche zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen. |
| GetCustomBendAllowance | Liefert die eigene Biegezugabe der Basislasche. |
| GetD1OffsetReferenceType | Liefert, welche Art von Element die Endbedingung der Basislasche in Richtung 1 festlegt, etwa Fläche oder Eckpunkt. |
| GetD2OffsetReferenceType | Liefert, welche Art von Element die Endbedingung der Basislasche in Richtung 2 festlegt, etwa Fläche oder Eckpunkt. |
| GetTableRadii | Liefert die Biegeradien, die die Blechstärkentabelle für eine Blechdicke kennt. |
| GetTableRadiiCount | Liefert, wie viele Biegeradien die Blechstärkentabelle für eine Blechdicke kennt. |
| GetTableThicknesses | Liefert die Namen der Blechdicken aus der Blechstärkentabelle der Basislasche. |
| GetTableThicknessesCount | Liefert, wie viele Blechdicken die Blechstärkentabelle der Basislasche enthält. |
| Initialize | Legt bei einer neuen Basislasche Material, Biegezugabe und Biegefreischnitt fest. Danach lassen sich diese Werte nicht mehr ändern. |
| ReleaseSelectionAccess | Hebt 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.