Objekt · SldWorks
DraftFeatureData2-Objekt
Die Definition einer Formschräge: Art, Winkel und Richtung, neutrale Ebene oder Trennlinien, die Flächen mit Formschräge, Fortsetzung auf weitere Flächen und Stufenart.
Beschreibung
DraftFeatureData2 gibt Zugriff auf ein Feature Formschräge (draft). Eine Formschräge neigt Flächen um einen Winkel gegenüber einer Richtung. Es gibt drei Arten (swDraftType_e): mit neutraler Ebene, an einer Trennlinie und als Stufenformschräge. Die Befehle gibt es seit SOLIDWORKS 2001Plus, AllowReducedAngle seit 2004. Das Objekt ersetzt das veraltete DraftFeatureData.
Zugriff
Feature.GetDefinition: bei einer Formschräge mit dem TypnamenDraft
Neu anlegen kannst du eine Formschräge mit FeatureManager.InsertMultiFaceDraft.
Beispiel
' Gibt Art, Winkel und Flächen der ausgewählten Formschräge aus und stellt den Winkel auf 3°.
' Vorbedingung: Ein Teil mit einer Formschräge ist offen, die Formschräge ist im
' FeatureManager ausgewählt.
' Ergebnis: Die Formschräge hat 3°, die alten Werte stehen im Direktfenster.
Option Explicit
Sub main()
Const PI As Double = 3.14159265358979
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSel As Object
Dim swFeat As SldWorks.Feature
Dim swDaten As SldWorks.DraftFeatureData2
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
If swFeat.GetTypeName2 <> "Draft" Then Exit Sub
Set swDaten = swFeat.GetDefinition
Select Case swDaten.Type
Case swNeutralPlaneDraft: Debug.Print swFeat.Name & ": neutrale Ebene"
Case swPartingLineDraft: Debug.Print swFeat.Name & ": Trennlinie"
Case swStepDraft: Debug.Print swFeat.Name & ": Stufenformschräge, Stufe " & swDaten.StepType
End Select
Debug.Print " Winkel: " & Round(swDaten.Angle * 180 / PI, 2) & "°, umgekehrt: " & swDaten.ReverseDirection
Debug.Print " wirkt auf " & swDaten.GetDraftedEntityCount & " Element(e)"
If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
Debug.Print " " & swDaten.GetFacesToDraftCount & " Fläche(n), " & swDaten.GetPartingLinesCount & " Trennlinie(n)"
swDaten.Angle = 3 * PI / 180
If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
End SubBemerkungen
Anlegen: FeatureManager.InsertMultiFaceDraft legt eine Formschräge aus vorher ausgewählten Elementen an: die neutrale Ebene oder Richtung mit der Markierung 1, die Flächen mit 2, bei einer Kantenformschräge die Kanten mit 4.
Ändern: Nach DraftFeatureData2.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du DraftFeatureData2.ReleaseSelectionAccess auf. Für neutrale Ebene, Entformungsrichtung, Flächen, Trennlinien und die betroffenen Elemente verweist die Hilfe auf das Thema „Accessing Selections that Define Features“.
Betroffene Flächen: Wie das Hilfebeispiel „Get Faces Affected by Draft Feature“ zeigt, liefert Feature.GetFaces bei einer Formschräge ein leeres Array, weil sie nur vorhandene Flächen ändert und keine neuen erzeugt. Die geänderten Flächen liefert DraftFeatureData2.GetDraftedEntities, im Beispiel ohne Rücksetzen mit AccessSelections.
Einheiten: Den Winkel gibt die Hilfe in Bogenmaß an.
Fehlende Angaben: Welche Eigenschaften bei welcher Art (swDraftType_e) gelten, sagt die Hilfe nicht. Dem Namen nach gehören NeutralPlane zur Formschräge mit neutraler Ebene, PartingLines und die Option „Andere Fläche“ zur Trennlinie und StepType zur Stufenformschräge.
DraftFeatureData2.GetPartingLinesCount liefert auch bei einer Formschräge mit neutraler Ebene 1, obwohl sie keine Trennlinie hat.
Eigenschaften und Methoden
Eigenschaften 10, davon 10 beschrieben
| Name | Beschreibung |
|---|---|
| AllowReducedAngle | Liest oder setzt die Option „Reduzierten Winkel zulassen“ einer Formschräge. |
| Angle | Liest oder setzt den Winkel einer Formschräge, in Bogenmaß. |
| DirectionPull | Liest oder setzt die Fläche, die die Entformungsrichtung einer Formschräge angibt. |
| FacePropagation | Liest oder setzt, ob die Formschräge auf weitere Flächen fortgesetzt wird: keine, tangentiale Flächen oder Flächen an allen, inneren oder äußeren Schleifen. |
| FacesToDraft | Liest oder setzt die Flächen, die eine Formschräge festlegen. |
| NeutralPlane | Liest oder setzt die Fläche, die als neutrale Ebene der Formschräge dient. |
| PartingLines | Liest oder setzt die Trennlinien einer Formschräge. |
| ReverseDirection | Liest oder setzt, ob die Richtung einer Formschräge umgekehrt ist. |
| StepType | Liest oder setzt die Art der Stufe bei einer Stufenformschräge: konisch oder senkrecht. |
| Type | Liefert die Art einer Formschräge: mit neutraler Ebene, an einer Trennlinie oder als Stufenformschräge. |
Methoden 8, davon 8 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die Formschräge zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen. |
| GetDraftedEntities | Liefert die Flächen oder Kanten, auf die die Formschräge wirkt. |
| GetDraftedEntityCount | Liefert die Zahl der Flächen oder Kanten, auf die die Formschräge wirkt. |
| GetFacesToDraftCount | Liefert die Zahl der Flächen, die eine Formschräge festlegen. |
| GetOtherFacesFlagAtIndex | Liefert die Option „Andere Fläche“ für einen Abschnitt der Trennlinie einer Formschräge. |
| GetPartingLinesCount | Liefert die Zahl der Trennlinien einer Formschräge. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Formschräge nicht geändert hast. |
| SetOtherFacesFlagAtIndex | Setzt die Option „Andere Fläche“ für einen Abschnitt der Trennlinie einer Formschräge. |
Nicht aufgeführt sind 6 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IDraftFeatureData2 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.