SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.DraftFeatureData2 · in der englischen .NET-Hilfe: IDraftFeatureData2

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

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 Sub

Bemerkungen

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

NameBeschreibung
AllowReducedAngleLiest oder setzt die Option „Reduzierten Winkel zulassen“ einer Formschräge.
AngleLiest oder setzt den Winkel einer Formschräge, in Bogenmaß.
DirectionPullLiest oder setzt die Fläche, die die Entformungsrichtung einer Formschräge angibt.
FacePropagationLiest 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.
FacesToDraftLiest oder setzt die Flächen, die eine Formschräge festlegen.
NeutralPlaneLiest oder setzt die Fläche, die als neutrale Ebene der Formschräge dient.
PartingLinesLiest oder setzt die Trennlinien einer Formschräge.
ReverseDirectionLiest oder setzt, ob die Richtung einer Formschräge umgekehrt ist.
StepTypeLiest oder setzt die Art der Stufe bei einer Stufenformschräge: konisch oder senkrecht.
TypeLiefert die Art einer Formschräge: mit neutraler Ebene, an einer Trennlinie oder als Stufenformschräge.

Methoden 8, davon 8 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Formschräge zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen.
GetDraftedEntitiesLiefert die Flächen oder Kanten, auf die die Formschräge wirkt.
GetDraftedEntityCountLiefert die Zahl der Flächen oder Kanten, auf die die Formschräge wirkt.
GetFacesToDraftCountLiefert die Zahl der Flächen, die eine Formschräge festlegen.
GetOtherFacesFlagAtIndexLiefert die Option „Andere Fläche“ für einen Abschnitt der Trennlinie einer Formschräge.
GetPartingLinesCountLiefert die Zahl der Trennlinien einer Formschräge.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Formschräge nicht geändert hast.
SetOtherFacesFlagAtIndexSetzt 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.