SolidWorksMakroprogrammierung

Objekt · SldWorks

ReferencePointCurveFeatureData-Objekt

Die Definition einer Kurve durch Referenzpunkte: die Punkte, durch die sie läuft, und ob sie geschlossen ist.

Deklaration Dim x As SldWorks.ReferencePointCurveFeatureData · in der englischen .NET-Hilfe: IReferencePointCurveFeatureData

Beschreibung

ReferencePointCurveFeatureData gibt Zugriff auf die Daten einer Kurve durch Referenzpunkte. Das ist eine 3D-Spline-Kurve, die durch ausgewählte Skizzenpunkte oder Eckpunkte läuft. Du liest und setzt damit die Punkte und ob die Kurve geschlossen ist. Die Segmente der Kurve als Kanten liefert dagegen das Objekt ReferenceCurve, das du mit Feature.GetSpecificFeature2 holst. Die Befehle gibt es seit SOLIDWORKS 2003.

Zugriff

Beispiel

' Legt eine offene Kurve durch die ausgewählten Eckpunkte an und gibt dann
' ihre Punkte aus.
' Vorbedingung: Ein Teil ist offen, mindestens zwei Eckpunkte oder Skizzenpunkte
'               sind in der gewünschten Reihenfolge ausgewählt.
' Ergebnis:     Eine neue Kurve im FeatureManager, die Angaben stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swFeat As SldWorks.Feature
    Dim swDaten As SldWorks.ReferencePointCurveFeatureData
    Dim vPunkte As Variant
    Dim vArten As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSelMgr = swModel.SelectionManager
    If swSelMgr.GetSelectedObjectCount2(-1) < 2 Then
        Debug.Print "Bitte mindestens zwei Punkte auswählen."
        Exit Sub
    End If
    For i = 1 To swSelMgr.GetSelectedObjectCount2(-1)
        swSelMgr.SetSelectedObjectMark i, 1, swSelectionMarkSet      ' Markierung 1 wie in der Hilfe
    Next i

    swModel.Insert3DSplineCurve False
    swModel.ClearSelection2 True
    Set swFeat = swModel.Extension.GetLastFeatureAdded
    If swFeat Is Nothing Then Exit Sub
    If swFeat.GetTypeName2 <> "3DSplineCurve" Then
        Debug.Print "Keine Kurve entstanden."
        Exit Sub
    End If

    Set swDaten = swFeat.GetDefinition
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    Debug.Print swFeat.Name & ": geschlossen " & swDaten.ClosedCurve & ", " & _
                swDaten.GetThroughPointCount & " Punkt(e)"
    vPunkte = swDaten.GetThroughPoints(vArten)
    swDaten.ReleaseSelectionAccess
    If IsArray(vPunkte) Then
        For i = 0 To UBound(vPunkte)
            If vArten(i) = swSelSKETCHPOINTS Then
                Debug.Print "  Punkt " & i + 1 & ": Skizzenpunkt"
            Else
                Debug.Print "  Punkt " & i + 1 & ": Eckpunkt oder andere Art (" & vArten(i) & ")"
            End If
        Next i
    End If
End Sub

Bemerkungen

Anlegen: Wähle die Punkte vorher mit ModelDocExtension.SelectByID2 und der Markierung 1 aus und rufe ModelDoc2.Insert3DSplineCurve auf. Die Methode liefert das Feature nicht zurück. Das Hilfebeispiel „Create Curve Through Reference Points“ wählt vier Eckpunkte von block20.sldprt aus, legt die Kurve an und wählt sie danach über ihren Namen Curve1 aus. Das Beispiel hier setzt die Markierung der Auswahl stattdessen nachträglich mit SelectionMgr.SetSelectedObjectMark und holt das neue Feature mit ModelDocExtension.GetLastFeatureAdded. Ob die Markierung bei Punkten nötig ist, die du von Hand ausgewählt hast, sagt die Hilfe nicht.

Ändern: Nach ReferencePointCurveFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du ReferencePointCurveFeatureData.ReleaseSelectionAccess auf.

Typname: Zum Typnamen 3DSplineCurve aus Feature.GetTypeName2 gehören diese Definition und als spezielles Objekt ReferenceCurve.

Eigenschaften und Methoden

Eigenschaften 1, davon 1 beschrieben

NameBeschreibung
ClosedCurveLiest oder setzt, ob die Kurve durch Referenzpunkte geschlossen ist.

Methoden 5, davon 5 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Kurve durch Referenzpunkte zurück, damit du die Punkte lesen und ändern kannst, die sie festlegen.
GetThroughPointCountLiefert die Zahl der Punkte, durch die die Kurve läuft.
GetThroughPointsLiefert die Punkte, durch die die Kurve läuft, und ihre Auswahlarten.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Kurve durch Referenzpunkte nicht geändert hast.
SetThroughPointsSetzt die Punkte, durch die die Kurve läuft.

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

Siehe auch

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

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