SolidWorksMakroprogrammierung

Objekt · SldWorks

RuledSurfaceFeatureData-Objekt

Die Definition einer Regelfläche: Art, Kanten, Breite, Winkel, Bezugsrichtung und ob verbunden, getrimmt und zusammengefügt wird.

Deklaration Dim x As SldWorks.RuledSurfaceFeatureData · in der englischen .NET-Hilfe: IRuledSurfaceFeatureData

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

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 Sub

Bemerkungen

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

NameBeschreibung
AngleLiest oder setzt den Winkel einer verjüngten Regelfläche.
ConnectLiest oder setzt, ob die Flächen der Regelfläche mit verbindenden Flächen verbunden werden.
DirectionVectorLiest oder setzt den Bezugsvektor einer ausgetragenen Regelfläche.
DistanceLiest oder setzt, wie weit die Regelfläche von den Kanten aus reicht.
TrimAndKnitLiest oder setzt, ob die Flächen der Regelfläche getrimmt und zusammengefügt werden.
TypeLiest oder setzt die Art der Regelfläche: tangential oder normal zur Fläche, verjüngt oder senkrecht zum Vektor oder ausgetragen.
UseVectorLiest oder setzt, ob eine ausgetragene Regelfläche einen Bezugsvektor verwendet.

Methoden 7, davon 7 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Regelfläche zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen.
GetDirectionReferenceLiefert die ein oder zwei Elemente, die die Bezugsrichtung der Regelfläche festlegen.
GetEdgesLiefert die Kanten, von denen die Regelfläche ausgeht, und je Kante die Seite.
GetEdgesCountLiefert die Zahl der Kanten, von denen die Regelfläche ausgeht.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Regelfläche nicht geändert hast.
SetDirectionReferenceLegt die ein oder zwei Elemente fest, die die Bezugsrichtung der Regelfläche bestimmen.
SetEdgesLegt 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.