Objekt · SldWorks
RuledSurfaceFeatureData-Objekt
Die Definition einer Regelfläche: Art, Kanten, Breite, Winkel, Bezugsrichtung und ob verbunden, getrimmt und zusammengefügt wird.
Beschreibung
RuledSurfaceFeatureData gibt Zugriff auf ein Feature Regelfläche (ruled surface). Eine Regelfläche wächst von Kanten aus um eine bestimmte Breite, etwa tangential oder normal zu einer angrenzenden Fläche, verjüngt oder senkrecht zu einer Bezugsrichtung oder ausgetragen. Die Befehle gibt es seit SOLIDWORKS 2005.
Zugriff
Feature.GetDefinition: bei einem Feature mit dem TypnamenRuledSrfFromEdge
Beispiel
' Gibt Art, Breite und Kanten der ausgewählten Regelfläche aus und macht sie 5 mm breiter.
' Vorbedingung: Ein Teil mit einer Regelfläche ist offen, das Feature ist im
' FeatureManager ausgewählt.
' Ergebnis: Die Regelfläche ist 5 mm breiter, 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.RuledSurfaceFeatureData
Dim vKanten As Variant, vSeiten As Variant
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 <> "RuledSrfFromEdge" Then Exit Sub
Set swDaten = swFeat.GetDefinition
Debug.Print swFeat.Name & ": Art " & swDaten.Type & ", Breite " & swDaten.Distance * 1000 & " mm"
If swDaten.Type = swRuledSurfaceType_TaperedToVector Then
Debug.Print " Winkel " & Round(swDaten.Angle * 180 / PI, 1) & "°"
End If
Debug.Print " Verbinden " & swDaten.Connect & ", trimmen und zusammenfügen " & swDaten.TrimAndKnit
If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
swDaten.GetEdges vKanten, vSeiten
If IsArray(vKanten) Then Debug.Print " " & UBound(vKanten) + 1 & " Kante(n)"
swDaten.Distance = swDaten.Distance + 0.005
If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
End SubBemerkungen
Anlegen: Eine neue Regelfläche legst du mit FeatureManager.InsertRuledSurfaceFromEdge2 an. Das Hilfebeispiel „Get Ruled-Surface Feature Data“ liest nur die Art einer ausgewählten Regelfläche.
Ändern: Nach RuledSurfaceFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du RuledSurfaceFeatureData.ReleaseSelectionAccess auf. Für Kanten, Bezugsrichtung und Bezugsvektor verweist die Hilfe auf das Thema „Accessing Selections that Define Features“.
Was wann gilt: RuledSurfaceFeatureData.Angle gilt nur bei swRuledSurfaceType_TaperedToVector, RuledSurfaceFeatureData.UseVector und RuledSurfaceFeatureData.DirectionVector nur bei swRuledSurfaceType_Sweep. Die Bezugsrichtung aus RuledSurfaceFeatureData.GetDirectionReference gilt bei den Arten verjüngt zum Vektor, senkrecht zum Vektor und ausgetragen.
Einheiten: Die Breite gibt die Hilfe in Metern an, den Winkel in Bogenmaß.
Zahlen der Arten: In swRuledSurfaceType_e reichen die Werte von 1 (tangential) bis 5 (ausgetragen). Die Hilfe zu FeatureManager.InsertRuledSurfaceFromEdge2 nennt für deren Parameter Type die Werte 0 (tangential) bis 4 (ausgetragen). Die Zählung ist dort wirklich um eins kleiner: Type 1 ergab eine Regelfläche, die hier Art 2 (senkrecht zur Fläche) meldet. Für Type an diesem Objekt nimmst du die Konstanten aus swRuledSurfaceType_e.
Eigenschaften und Methoden
Eigenschaften 7, davon 7 beschrieben
| Name | Beschreibung |
|---|---|
| Angle | Liest oder setzt den Winkel einer verjüngten Regelfläche. |
| Connect | Liest oder setzt, ob die Flächen der Regelfläche mit verbindenden Flächen verbunden werden. |
| DirectionVector | Liest oder setzt den Bezugsvektor einer ausgetragenen Regelfläche. |
| Distance | Liest oder setzt, wie weit die Regelfläche von den Kanten aus reicht. |
| TrimAndKnit | Liest oder setzt, ob die Flächen der Regelfläche getrimmt und zusammengefügt werden. |
| Type | Liest oder setzt die Art der Regelfläche: tangential oder normal zur Fläche, verjüngt oder senkrecht zum Vektor oder ausgetragen. |
| UseVector | Liest oder setzt, ob eine ausgetragene Regelfläche einen Bezugsvektor verwendet. |
Methoden 7, davon 7 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die Regelfläche zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen. |
| GetDirectionReference | Liefert die ein oder zwei Elemente, die die Bezugsrichtung der Regelfläche festlegen. |
| GetEdges | Liefert die Kanten, von denen die Regelfläche ausgeht, und je Kante die Seite. |
| GetEdgesCount | Liefert die Zahl der Kanten, von denen die Regelfläche ausgeht. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Regelfläche nicht geändert hast. |
| SetDirectionReference | Legt die ein oder zwei Elemente fest, die die Bezugsrichtung der Regelfläche bestimmen. |
| SetEdges | Legt die Kanten fest, von denen die Regelfläche ausgeht, und je Kante die Seite. |
Nicht aufgeführt sind 2 C++-Varianten (Namen mit I davor, zum Beispiel IGetEdges). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IRuledSurfaceFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.