SolidWorksMakroprogrammierung

Objekt · SldWorks

SplineHandle-Objekt

Ein Splinegriff an einem Punkt eines Skizzensplines: Lage des Punkts, Tangente in Richtung und Gewichtung, Krümmung und Zurücksetzen.

Deklaration Dim x As SldWorks.SplineHandle · in der englischen .NET-Hilfe: ISplineHandle

Beschreibung

SplineHandle gibt Zugriff auf einen Splinegriff. Über die Griffe an den Punkten eines Skizzensplines steuerst du die Form des Splines: die Lage des Punkts, die Richtung und Gewichtung der Tangente und die Krümmung. Die meisten Befehle gibt es seit SOLIDWORKS 2007.

Zugriff

Beispiel

' Gibt für jeden Griff des ausgewählten Skizzensplines Punkt, Lage, Tangente und
' Krümmungsradius aus.
' Vorbedingung: Ein Teil ist offen, ein Spline einer Skizze ist ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, die Skizze bleibt unverändert.
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 swSpline As SldWorks.SketchSpline
    Dim swGriff As SldWorks.SplineHandle
    Dim vGriffe As Variant
    Dim i As Long

    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.SketchSpline Then Exit Sub
    Set swSpline = swSel

    vGriffe = swSpline.GetSplineHandles
    If Not IsArray(vGriffe) Then Exit Sub
    For i = 0 To UBound(vGriffe)
        Set swGriff = vGriffe(i)
        Debug.Print "Punkt " & swGriff.SplinePointNumber & ": " & _
                    Format(swGriff.X * 1000, "0.00") & ", " & Format(swGriff.Y * 1000, "0.00") & ", " & _
                    Format(swGriff.Z * 1000, "0.00") & " mm"
        Debug.Print "  Gewichtung Richtung 1: " & swGriff.TangentMagnitude(swTangentMagnitudeDirection1) & _
                    ", Richtung: " & Format(swGriff.TangentRadialDirection * 180 / PI, "0.0") & "°"
        If swGriff.CurvatureControlled Then Debug.Print "  Krümmungsradius: " & swGriff.RadiusOfCurvature * 1000 & " mm"
    Next i
End Sub

Bemerkungen

Griffe anzeigen: Die Griffe für Tangente und Krümmung schaltest du mit SldWorks.SetUserPreferenceToggle und swDisplayAllSplineHandles (swUserPreferenceToggle_e) ein.

Auswahl: Für einen ausgewählten Splinegriff liefert SelectionMgr.GetSelectedObjectType3 swSelMANIPULATORS.

Einheiten: Die Koordinaten sind wie sonst in der API Meter. Das Hilfebeispiel „Get and Set Spline Handles“ rechnet sie mit * 1000 in Millimeter um. Für Winkel und Krümmung nennt die Hilfe keine Einheit, vermutlich Bogenmaß und 1/Meter.

Hilfebeispiel: Das Hilfebeispiel liest die Griffe direkt aus dem Variant-Array, etwa vGriffe(i).X, und ändert Lage, Gewichtung, Richtung, Krümmungsradius und TangentDriving einzelner Griffe.

Eigenschaften und Methoden

Eigenschaften 13, davon 13 beschrieben

NameBeschreibung
CurvatureLiest oder setzt die Krümmung an einem Splinegriff mit Krümmungssteuerung.
CurvatureControlledLiest oder setzt, ob der Splinegriff eine Krümmungssteuerung hat.
EditableLiest oder setzt, ob der Splinegriff bearbeitet werden kann.
ParameterLiefert die Stelle des Splinegriffs im Parameterraum der Kurve unter dem Spline.
RadiusOfCurvatureLiest oder setzt den Krümmungsradius an einem Splinegriff mit Krümmungssteuerung.
SplinePointNumberLiefert die Nummer des Splinepunkts, zu dem der Griff gehört.
TangentDrivingSchaltet die Steuerung des Splines über Gewichtung und Richtung der Tangente an diesem Griff ein oder aus.
TangentMagnitudeLiest oder setzt die Gewichtung der Tangente des Splinegriffs in einer der beiden Richtungen.
TangentPolarDirectionLiest oder setzt den Höhenwinkel der Tangente am Splinegriff.
TangentRadialDirectionLiest oder setzt die Richtung der Tangente am Splinegriff als Neigungswinkel gegen eine Achse.
XLiest oder setzt die x-Koordinate des Splinepunkts.
YLiest oder setzt die y-Koordinate des Splinepunkts.
ZLiest oder setzt die z-Koordinate des Splinepunkts.

Methoden 2, davon 2 beschrieben

NameBeschreibung
ResetSetzt den Splinegriff auf seinen Anfangszustand zurück.
SelectWählt den Splinegriff aus.

Siehe auch

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

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