Objekt · SldWorks
ExtrudeFeatureData2-Objekt
Die Definition eines linear ausgetragenen Features (Extrusion): Aufsatz oder Schnitt, Richtung 1 und 2, Endbedingungen und Tiefen, Formschräge, Beginn, Dünnwand, Blech, Konturen und betroffene Körper oder Komponenten.
Beschreibung
ExtrudeFeatureData2 gibt Zugriff auf ein linear ausgetragenes Feature (extrusion). Es trägt eine Skizze senkrecht zur Skizzenebene oder in einer gewählten Richtung aus, als Aufsatz oder als Schnitt, auf Wunsch dünnwandig, in eine Richtung oder in zwei Richtungen. Für jede Richtung legst du Endbedingung, Tiefe und Formschräge fest. Dazu kommen der Beginn der Extrusion, die Einstellungen für Blechteile, Mehrkörperteile und Baugruppen. Die Grundbefehle gibt es seit SOLIDWORKS 2001Plus, die für Mehrkörperteile, Konturen und die Referenz der Endbedingung seit 2003, die Richtungsreferenz seit 2004, die automatische Eckenverrundung seit 2004 SP05, den Beginn seit 2005, LinkToThickness seit 2007, die Befehle für Baugruppen und Konfigurationen seit 2009 und den senkrechten Schnitt im Blech seit 2017. Das Objekt ersetzt das veraltete ExtrudeFeatureData.
Richtung 1 und 2: Fast alle Methoden für Tiefe, Endbedingung, Formschräge und Wand haben den Parameter Forward (bei einigen Fwd). True steht für die Vorwärtsrichtung des Features und False für die Gegenrichtung. Gemeint sind vermutlich Richtung 1 und Richtung 2, wie im PropertyManager und bei den Parametern T1/T2 und D1/D2 von FeatureManager.FeatureExtrusion3. Richtung 2 gilt nur, wenn ExtrudeFeatureData2.BothDirections True ist. Bei FeatureExtrusion3 zeigt Richtung 2 immer genau entgegengesetzt zu Richtung 1. Die Richtung 1 selbst kehrst du mit ExtrudeFeatureData2.ReverseDirection um.
Zugriff
Feature.GetDefinition: bei einem linear ausgetragenen Feature. NachFeature.GetTypeName2gehören die TypnamenExtrusion,Boss,BossThin,Cut,CutThinundBaseBodyzu ExtrudeFeatureData2.FeatureManager.FeatureExtrusion3undFeatureManager.FeatureExtrusionThin2legen einen Aufsatz an,FeatureManager.FeatureCut4undFeatureManager.FeatureCutThin2einen Schnitt. Sie liefern dasFeature, die Daten holst du danach mitFeature.GetDefinition.
Beispiel
' Gibt Art, Endbedingungen, Tiefen und Formschrägen der ausgewählten Extrusion aus
' und setzt Richtung 1 auf eine feste Tiefe von 25 mm.
' Vorbedingung: Ein Teil mit einer Extrusion (Aufsatz oder Schnitt) ist offen, das
' Feature ist im FeatureManager ausgewählt.
' Ergebnis: Die alten Werte stehen im Direktfenster, Richtung 1 ist 25 mm tief.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSel As Object
Dim swFeat As SldWorks.Feature
Dim swDef As Object
Dim swDaten As SldWorks.ExtrudeFeatureData2
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
Set swDef = swFeat.GetDefinition
If Not TypeOf swDef Is SldWorks.ExtrudeFeatureData2 Then Exit Sub
Set swDaten = swDef
Debug.Print swFeat.Name & " (" & swFeat.GetTypeName2 & "): " & _
IIf(swDaten.IsBossFeature, "Aufsatz", "Schnitt") & IIf(swDaten.IsThinFeature, ", dünnwandig", "")
RichtungAusgeben swDaten, True
If swDaten.BothDirections Then RichtungAusgeben swDaten, False
If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
swDaten.SetEndCondition True, swEndCondBlind
swDaten.SetDepth True, 0.025
If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
End Sub
Private Sub RichtungAusgeben(swDaten As SldWorks.ExtrudeFeatureData2, bVorwaerts As Boolean)
Const PI As Double = 3.14159265358979
Debug.Print IIf(bVorwaerts, " Richtung 1: ", " Richtung 2: ") & "Endbedingung " & _
swDaten.GetEndCondition(bVorwaerts) & ", Tiefe " & swDaten.GetDepth(bVorwaerts) * 1000 & " mm"
If swDaten.GetDraftWhileExtruding(bVorwaerts) Then
Debug.Print " Formschräge " & Round(swDaten.GetDraftAngle(bVorwaerts) * 180 / PI, 2) & "°, " & _
IIf(swDaten.GetDraftOutward(bVorwaerts), "nach außen", "nach innen")
End If
End SubBemerkungen
Anlegen: Eine neue Extrusion legst du mit FeatureManager.FeatureExtrusion3, FeatureManager.FeatureExtrusionThin2, FeatureManager.FeatureCut4 oder FeatureManager.FeatureCutThin2 an, nachdem du die Skizze ausgewählt hast. Die Hilfebeispiele „Create Extrude Feature Using Sketch Contours“, „Create Extruded Thin Feature“ und „Create Cut Extrude in Sheet Metal Part“ holen danach die Definition mit Feature.GetDefinition und lesen sie aus.
Ändern: Nach ExtrudeFeatureData2.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du ExtrudeFeatureData2.ReleaseSelectionAccess auf. So verdoppelt das Hilfebeispiel „Access Selections“ die Tiefe einer Extrusion. Für Konturen, Referenzen und Körper verweist die Hilfe auf das Thema „Accessing Selections that Define Features“. Mit ExtrudeFeatureData2.SetChangeToConfigurations gilt eine Änderung für bestimmte Konfigurationen.
Standardrichtung: Bei FeatureManager.FeatureExtrusion3 geht ein Aufsatz ohne Umkehren in Richtung der Skizzennormalen, ein Schnitt entgegengesetzt. Eine andere Richtung als die Normale legst du mit ExtrudeFeatureData2.SetDirectionReference fest.
Mehrkörperteile und Baugruppen: Die Extrusion wird entlang der Ebene erweitert, auf der das Feature entsteht, und betrifft alle oder nur bestimmte Körper, die sie schneidet. Das legst du mit ExtrudeFeatureData2.FeatureScope, ExtrudeFeatureData2.AutoSelect und ExtrudeFeatureData2.FeatureScopeBodies fest. ExtrudeFeatureData2.GetFeatureScopeBodiesCount liefert 0 und FeatureScopeBodies ein leeres Array, wenn FeatureScope False oder ExtrudeFeatureData2.Merge True ist. Für Extrusionen in Baugruppen gibt es ExtrudeFeatureData2.AssemblyFeatureScope, ExtrudeFeatureData2.AutoSelectComponents und ExtrudeFeatureData2.PropagateFeatureToParts.
Typnamen: Die Hilfe zum Objekt sagt, dass Feature.GetTypeName bei Extrusionen je nach Art cut, boss, boss thin oder cut thin liefert. Die Liste bei Feature.GetTypeName2 nennt Extrusion, Boss, BossThin, Cut, CutThin und BaseBody, ohne die Namen zu erklären. Das Beispiel prüft deshalb den Typ des Datenobjekts mit TypeOf. Im Hilfebeispiel „Get Type of Instant3D Feature“ meldet ein Instant3D-Feature bei GetTypeName2 ICE; die eigentliche Art liefert dann GetTypeName.
Veraltete Befehle: GetFace, SetFace, GetVertex und SetVertex sind veraltet, an ihre Stelle treten ExtrudeFeatureData2.GetEndConditionReference und ExtrudeFeatureData2.SetEndConditionReference. Statt IsBaseExtrude nimmst du Feature.IsBase2.
Einheiten: Die Winkel der Formschräge sind in Bogenmaß. Für Tiefen, Wandstärken, Abstände und Radien nennt die Hilfe keine Einheit, es sind wie bei FeatureManager.FeatureExtrusion3 Meter.
Achtung: Das Beispiel kann bei einem Aufsatz „Schnitt“ ausgeben, weil ExtrudeFeatureData2.IsBossFeature auch bei Aufsätzen False liefert.
Eigenschaften und Methoden
Eigenschaften 20, davon 20 beschrieben
| Name | Beschreibung |
|---|---|
| AssemblyFeatureScope | Liest oder setzt, ob eine Extrusion in einer Baugruppe nur ausgewählte Komponenten betrifft. |
| AutoSelect | Liest oder setzt, ob die Extrusion in einem Mehrkörperteil automatisch alle Körper beeinflusst, die sie schneidet. |
| AutoSelectComponents | Liest oder setzt, ob eine Extrusion in einer Baugruppe die betroffenen Komponenten automatisch wählt. |
| BothDirections | Liest oder setzt, ob die Extrusion in beide Richtungen geht, also auch in Richtung 2. |
| CapEnds | Liest oder setzt, ob die Enden eines dünnwandigen Basis-Features geschlossen werden. |
| CapThickness | Liest oder setzt die Dicke der Endkappen eines dünnwandigen Basis-Features. |
| Contours | Liest oder setzt die gewählten Skizzenkonturen und Bereiche, aus denen die Extrusion entsteht. |
| FeatureScope | Liest oder setzt, ob die Extrusion in einem Mehrkörperteil nur bestimmte Körper beeinflusst. |
| FeatureScopeBodies | Liest oder setzt die Volumenkörper, die die Extrusion in einem Mehrkörperteil beeinflusst. |
| FlipSideToCut | Liest oder setzt, ob bei einem Schnitt die andere Seite weggeschnitten wird. |
| FromOffsetDistance | Liest oder setzt den Abstand, mit dem die Extrusion versetzt zur Skizzenebene beginnt. |
| FromOffsetReverse | Liest oder setzt, ob der Versatz am Beginn der Extrusion in die Gegenrichtung geht. |
| FromType | Liest oder setzt, wo die Extrusion beginnt: an der Skizzenebene, an einer Fläche oder Ebene, an einem Eckpunkt oder mit Versatz. |
| LinkToThickness | Liest oder setzt, ob die Tiefe eines Aufsatzes im Blechteil mit der Dicke des Basis-Features verknüpft ist. |
| Merge | Liest oder setzt, ob die Extrusion in einem Mehrkörperteil mit den vorhandenen Körpern verschmilzt. |
| NormalCut | Liest oder setzt, ob ein Schnitt im Blechteil senkrecht zur Blechdicke erzeugt wird. |
| OptimizeGeometry | Liest oder setzt, ob die Geometrie eines senkrechten Schnitts im Blechteil optimiert wird. |
| PropagateFeatureToParts | Liest oder setzt, ob eine Extrusion in einer Baugruppe in die betroffenen Teile übernommen wird. |
| ReverseDirection | Liest oder setzt, ob die Richtung der Extrusion umgekehrt ist. |
| ThinWallType | Liest oder setzt, in welche Richtung die Wand einer dünnwandigen Extrusion aufgetragen wird. |
Methoden 37, davon 32 beschrieben, 5 veraltet
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die Extrusion zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen. |
| GetAutoFilletCorners | Liefert, ob die Ecken einer dünnwandigen Extrusion automatisch verrundet werden. |
| GetAutoFilletRadius | Liefert den Radius der automatischen Eckenverrundung einer dünnwandigen Extrusion. |
| GetContoursCount | Liefert die Zahl der gewählten Skizzenkonturen und Bereiche der Extrusion. |
| GetDepth | Liefert die Tiefe der Extrusion in Richtung 1 oder 2. |
| GetDirectionReference | Liefert die ein oder zwei Elemente, die die Richtung der Extrusion festlegen. |
| GetDraftAngle | Liefert den Winkel der Formschräge in Richtung 1 oder 2. |
| GetDraftOutward | Liefert, ob die Formschräge in Richtung 1 oder 2 nach außen geht. |
| GetDraftWhileExtruding | Liefert, ob die Extrusion in Richtung 1 oder 2 mit Formschräge ausgetragen wird. |
| GetEndCondition | Liefert die Endbedingung der Extrusion in Richtung 1 oder 2. |
| GetEndConditionReference | Liefert das Element, auf das sich die Endbedingung in Richtung 1 oder 2 bezieht, etwa eine Fläche oder einen Eckpunkt. |
| GetFace | veraltet ersetzt durch ExtrudeFeatureData2.GetEndConditionReference |
| GetFeatureScopeBodiesCount | Liefert die Zahl der Volumenkörper, die die Extrusion in einem Mehrkörperteil beeinflusst. |
| GetFromEntity | Liefert das Element, an dem die Extrusion beginnt, und seine Art. |
| GetReverseOffset | Liefert, ob der Abstand der Endbedingung „Abstand von Fläche“ in Richtung 1 oder 2 umgekehrt ist. |
| GetTranslateSurface | Liefert, ob das Ende der Extrusion in Richtung 1 oder 2 eine verschobene Kopie der Referenzfläche ist. |
| GetVertex | veraltet ersetzt durch ExtrudeFeatureData2.GetEndConditionReference |
| GetWallThickness | Liefert die Wandstärke einer dünnwandigen Extrusion in Vorwärts- oder Gegenrichtung. |
| IsBaseExtrude | veraltet ersetzt durch Feature.IsBase2 |
| IsBossFeature | Liefert, ob die Extrusion ein Aufsatz ist. |
| IsThinFeature | Liefert, ob die Extrusion dünnwandig ist. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Extrusion nicht geändert hast. |
| SetAutoFillet | Schaltet die automatische Eckenverrundung einer dünnwandigen Extrusion ein oder aus und setzt den Radius. |
| SetChangeToConfigurations | Wendet die Änderungen an der Extrusion auf die angegebenen Konfigurationen an. |
| SetDepth | Setzt die Tiefe der Extrusion in Richtung 1 oder 2, bei „Abstand von Fläche“ den Abstand. |
| SetDirectionReference | Legt die Richtung der Extrusion mit ein oder zwei Elementen fest. |
| SetDraftAngle | Setzt den Winkel der Formschräge in Richtung 1 oder 2. |
| SetDraftOutward | Setzt, ob die Formschräge in Richtung 1 oder 2 nach außen geht. |
| SetDraftWhileExtruding | Schaltet die Formschräge der Extrusion in Richtung 1 oder 2 ein oder aus. |
| SetEndCondition | Setzt die Endbedingung der Extrusion in Richtung 1 oder 2. |
| SetEndConditionReference | Setzt das Element, auf das sich die Endbedingung in Richtung 1 oder 2 bezieht, etwa eine Fläche oder einen Eckpunkt. |
| SetFace | veraltet ersetzt durch ExtrudeFeatureData2.SetEndConditionReference |
| SetFromEntity | Setzt das Element, an dem die Extrusion beginnt. |
| SetReverseOffset | Setzt, ob der Abstand der Endbedingung „Abstand von Fläche“ in Richtung 1 oder 2 umgekehrt wird. |
| SetTranslateSurface | Setzt, ob das Ende der Extrusion in Richtung 1 oder 2 eine verschobene Kopie der Referenzfläche ist. |
| SetVertex | veraltet ersetzt durch ExtrudeFeatureData2.SetEndConditionReference |
| SetWallThickness | Setzt die Wandstärke einer dünnwandigen Extrusion in Vorwärts- oder Gegenrichtung. |
Nicht aufgeführt sind 10 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IExtrudeFeatureData2 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.