SolidWorksMakroprogrammierung

Objekt · SldWorks

ReferenceCurve-Objekt

Eine Referenzkurve, etwa eine 3D-Spline-Kurve, eine Kurve aus einer Datei oder eine projizierte Kurve: ihre Segmente als Kanten, Farbe und Sichtbarkeit.

Deklaration Dim x As SldWorks.ReferenceCurve · in der englischen .NET-Hilfe: IReferenceCurve

Beschreibung

ReferenceCurve gibt Zugriff auf Referenzkurven. Dazu zählt die Hilfe 3D-Spline-Kurven, Kurven aus einer Datei, Spiralen und importierte Kurven. Du gehst damit die Segmente der Kurve als Kanten durch, färbst die Kurve und blendest sie ein oder aus. Wie die Kurve festgelegt ist, steht in ihrer Definition, die du mit Feature.GetDefinition holst, bei einer Kurve durch Referenzpunkte etwa ReferencePointCurveFeatureData. GetSegments gibt es seit SOLIDWORKS 2009, für die übrigen Befehle nennt die Hilfe keine Version.

Zugriff

Beispiel

' Geht alle Features des aktiven Teils durch und gibt für jede Referenzkurve
' die Zahl der Segmente und ihre Gesamtlänge in Millimeter aus.
' Vorbedingung: Ein Teil mit Kurven-Features ist offen.
' Ergebnis:     Die Kurven stehen im Direktfenster, das Teil bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swFeat As SldWorks.Feature
    Dim swObj As Object
    Dim swRefKurve As SldWorks.ReferenceCurve
    Dim swKante As SldWorks.Edge
    Dim swKurve As SldWorks.Curve
    Dim swParam As SldWorks.CurveParamData
    Dim dLaenge As Double

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub

    Set swFeat = swModel.FirstFeature
    Do While Not swFeat Is Nothing
        Set swObj = swFeat.GetSpecificFeature2
        If swObj Is Nothing Then
            ' manche Ordner liefern kein Objekt, TypeOf gäbe dann Fehler 91
        ElseIf TypeOf swObj Is SldWorks.ReferenceCurve Then
            Set swRefKurve = swObj
            dLaenge = 0
            Set swKante = swRefKurve.GetFirstSegment
            Do While Not swKante Is Nothing
                Set swKurve = swKante.GetCurve
                Set swParam = swKante.GetCurveParams3
                dLaenge = dLaenge + swKurve.GetLength3(swParam.UMinValue, swParam.UMaxValue)
                Set swKante = swRefKurve.GetNextSegment
            Loop
            Debug.Print swFeat.Name & " (" & swFeat.GetTypeName2 & "): " & _
                swRefKurve.GetSegmentCount & " Segment(e), " & Format(dLaenge * 1000, "0.00") & " mm"
        End If
        Set swFeat = swFeat.GetNextFeature
    Loop
End Sub

Bemerkungen

Welche Kurven: Die Hilfe ist hier widersprüchlich. Die Beschreibung sagt, dass ReferenceCurve keine Referenzkurven-Features wie projizierte Kurven herausgibt. Die Tabelle bei Feature.GetTypeName2 nennt ReferenceCurve aber auch für RefCurve (projizierte Kurve) und CompositeCurve (CompositeCurveFeatureData), und die Hilfebeispiele „Get Curve Segments“ und „Get Reference Curve Information“ holen ReferenceCurve gerade von einer projizierten Kurve. Für Spiralen (Helix) und Kurven aus einer Datei (CurveInFile) nennt die Tabelle dagegen nur die Definition, HelixFeatureData und FreePointCurveFeatureData. Das Beispiel hier prüft das Objekt deshalb mit TypeOf.

Segmente: Die Segmente sind Kanten (Edge). Sie lassen sich nicht auswählen, Select-Methoden liefern für sie Nothing. Ihre Geometrie liest du mit Edge.GetCurve und Edge.GetCurveParams3.

Anlegen: Kurven durch Punkte legst du mit ModelDoc2.Insert3DSplineCurve an, Kurven aus einer Datei mit ModelDoc2.InsertCurveFileBegin und ModelDoc2.InsertCurveFile, Referenzkurven aus Kurvenobjekten mit ModelDoc2.FeatureReferenceCurve. So macht es das Hilfebeispiel „Create Reference Curve“.

Einheiten: Die Hilfebeispiele rechnen Punkte und Längen der Segmente mit * 1000 in Millimeter um, also Meter.

Eigenschaften und Methoden

Methoden 6, davon 6 beschrieben

NameBeschreibung
GetFirstSegmentLiefert das erste Segment der Referenzkurve als Kante.
GetNextSegmentLiefert das nächste Segment der Referenzkurve als Kante.
GetSegmentCountLiefert die Zahl der Segmente der Referenzkurve.
GetSegmentsLiefert alle Segmente der Referenzkurve als Array.
SetColorSetzt die Farbe des Referenzkurven-Features.
SetVisibleBlendet das Referenzkurven-Feature ein oder aus.

Nicht aufgeführt sind 3 C++-Varianten (Namen mit I davor, zum Beispiel IGetFirstSegment). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

Englisches Original: IReferenceCurve in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.