SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.ExtrudeFeatureData2 · in der englischen .NET-Hilfe: IExtrudeFeatureData2

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

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 Sub

Bemerkungen

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

NameBeschreibung
AssemblyFeatureScopeLiest oder setzt, ob eine Extrusion in einer Baugruppe nur ausgewählte Komponenten betrifft.
AutoSelectLiest oder setzt, ob die Extrusion in einem Mehrkörperteil automatisch alle Körper beeinflusst, die sie schneidet.
AutoSelectComponentsLiest oder setzt, ob eine Extrusion in einer Baugruppe die betroffenen Komponenten automatisch wählt.
BothDirectionsLiest oder setzt, ob die Extrusion in beide Richtungen geht, also auch in Richtung 2.
CapEndsLiest oder setzt, ob die Enden eines dünnwandigen Basis-Features geschlossen werden.
CapThicknessLiest oder setzt die Dicke der Endkappen eines dünnwandigen Basis-Features.
ContoursLiest oder setzt die gewählten Skizzenkonturen und Bereiche, aus denen die Extrusion entsteht.
FeatureScopeLiest oder setzt, ob die Extrusion in einem Mehrkörperteil nur bestimmte Körper beeinflusst.
FeatureScopeBodiesLiest oder setzt die Volumenkörper, die die Extrusion in einem Mehrkörperteil beeinflusst.
FlipSideToCutLiest oder setzt, ob bei einem Schnitt die andere Seite weggeschnitten wird.
FromOffsetDistanceLiest oder setzt den Abstand, mit dem die Extrusion versetzt zur Skizzenebene beginnt.
FromOffsetReverseLiest oder setzt, ob der Versatz am Beginn der Extrusion in die Gegenrichtung geht.
FromTypeLiest oder setzt, wo die Extrusion beginnt: an der Skizzenebene, an einer Fläche oder Ebene, an einem Eckpunkt oder mit Versatz.
LinkToThicknessLiest oder setzt, ob die Tiefe eines Aufsatzes im Blechteil mit der Dicke des Basis-Features verknüpft ist.
MergeLiest oder setzt, ob die Extrusion in einem Mehrkörperteil mit den vorhandenen Körpern verschmilzt.
NormalCutLiest oder setzt, ob ein Schnitt im Blechteil senkrecht zur Blechdicke erzeugt wird.
OptimizeGeometryLiest oder setzt, ob die Geometrie eines senkrechten Schnitts im Blechteil optimiert wird.
PropagateFeatureToPartsLiest oder setzt, ob eine Extrusion in einer Baugruppe in die betroffenen Teile übernommen wird.
ReverseDirectionLiest oder setzt, ob die Richtung der Extrusion umgekehrt ist.
ThinWallTypeLiest oder setzt, in welche Richtung die Wand einer dünnwandigen Extrusion aufgetragen wird.

Methoden 37, davon 32 beschrieben, 5 veraltet

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Extrusion zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen.
GetAutoFilletCornersLiefert, ob die Ecken einer dünnwandigen Extrusion automatisch verrundet werden.
GetAutoFilletRadiusLiefert den Radius der automatischen Eckenverrundung einer dünnwandigen Extrusion.
GetContoursCountLiefert die Zahl der gewählten Skizzenkonturen und Bereiche der Extrusion.
GetDepthLiefert die Tiefe der Extrusion in Richtung 1 oder 2.
GetDirectionReferenceLiefert die ein oder zwei Elemente, die die Richtung der Extrusion festlegen.
GetDraftAngleLiefert den Winkel der Formschräge in Richtung 1 oder 2.
GetDraftOutwardLiefert, ob die Formschräge in Richtung 1 oder 2 nach außen geht.
GetDraftWhileExtrudingLiefert, ob die Extrusion in Richtung 1 oder 2 mit Formschräge ausgetragen wird.
GetEndConditionLiefert die Endbedingung der Extrusion in Richtung 1 oder 2.
GetEndConditionReferenceLiefert das Element, auf das sich die Endbedingung in Richtung 1 oder 2 bezieht, etwa eine Fläche oder einen Eckpunkt.
GetFaceveraltet ersetzt durch ExtrudeFeatureData2.GetEndConditionReference
GetFeatureScopeBodiesCountLiefert die Zahl der Volumenkörper, die die Extrusion in einem Mehrkörperteil beeinflusst.
GetFromEntityLiefert das Element, an dem die Extrusion beginnt, und seine Art.
GetReverseOffsetLiefert, ob der Abstand der Endbedingung „Abstand von Fläche“ in Richtung 1 oder 2 umgekehrt ist.
GetTranslateSurfaceLiefert, ob das Ende der Extrusion in Richtung 1 oder 2 eine verschobene Kopie der Referenzfläche ist.
GetVertexveraltet ersetzt durch ExtrudeFeatureData2.GetEndConditionReference
GetWallThicknessLiefert die Wandstärke einer dünnwandigen Extrusion in Vorwärts- oder Gegenrichtung.
IsBaseExtrudeveraltet ersetzt durch Feature.IsBase2
IsBossFeatureLiefert, ob die Extrusion ein Aufsatz ist.
IsThinFeatureLiefert, ob die Extrusion dünnwandig ist.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Extrusion nicht geändert hast.
SetAutoFilletSchaltet die automatische Eckenverrundung einer dünnwandigen Extrusion ein oder aus und setzt den Radius.
SetChangeToConfigurationsWendet die Änderungen an der Extrusion auf die angegebenen Konfigurationen an.
SetDepthSetzt die Tiefe der Extrusion in Richtung 1 oder 2, bei „Abstand von Fläche“ den Abstand.
SetDirectionReferenceLegt die Richtung der Extrusion mit ein oder zwei Elementen fest.
SetDraftAngleSetzt den Winkel der Formschräge in Richtung 1 oder 2.
SetDraftOutwardSetzt, ob die Formschräge in Richtung 1 oder 2 nach außen geht.
SetDraftWhileExtrudingSchaltet die Formschräge der Extrusion in Richtung 1 oder 2 ein oder aus.
SetEndConditionSetzt die Endbedingung der Extrusion in Richtung 1 oder 2.
SetEndConditionReferenceSetzt das Element, auf das sich die Endbedingung in Richtung 1 oder 2 bezieht, etwa eine Fläche oder einen Eckpunkt.
SetFaceveraltet ersetzt durch ExtrudeFeatureData2.SetEndConditionReference
SetFromEntitySetzt das Element, an dem die Extrusion beginnt.
SetReverseOffsetSetzt, ob der Abstand der Endbedingung „Abstand von Fläche“ in Richtung 1 oder 2 umgekehrt wird.
SetTranslateSurfaceSetzt, ob das Ende der Extrusion in Richtung 1 oder 2 eine verschobene Kopie der Referenzfläche ist.
SetVertexveraltet ersetzt durch ExtrudeFeatureData2.SetEndConditionReference
SetWallThicknessSetzt 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.