Objekt · SldWorks
SplineHandle-Objekt
Ein Splinegriff an einem Punkt eines Skizzensplines: Lage des Punkts, Tangente in Richtung und Gewichtung, Krümmung und Zurücksetzen.
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
SketchSpline.GetSplineHandles: alle Griffe eines Splines als ArraySketchSpline.AddTangencyControlundSketchSpline.AddCurvatureControl: einen neuen Griff für Tangente oder Krümmung an einer Stelle des Splines
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Curvature | Liest oder setzt die Krümmung an einem Splinegriff mit Krümmungssteuerung. |
| CurvatureControlled | Liest oder setzt, ob der Splinegriff eine Krümmungssteuerung hat. |
| Editable | Liest oder setzt, ob der Splinegriff bearbeitet werden kann. |
| Parameter | Liefert die Stelle des Splinegriffs im Parameterraum der Kurve unter dem Spline. |
| RadiusOfCurvature | Liest oder setzt den Krümmungsradius an einem Splinegriff mit Krümmungssteuerung. |
| SplinePointNumber | Liefert die Nummer des Splinepunkts, zu dem der Griff gehört. |
| TangentDriving | Schaltet die Steuerung des Splines über Gewichtung und Richtung der Tangente an diesem Griff ein oder aus. |
| TangentMagnitude | Liest oder setzt die Gewichtung der Tangente des Splinegriffs in einer der beiden Richtungen. |
| TangentPolarDirection | Liest oder setzt den Höhenwinkel der Tangente am Splinegriff. |
| TangentRadialDirection | Liest oder setzt die Richtung der Tangente am Splinegriff als Neigungswinkel gegen eine Achse. |
| X | Liest oder setzt die x-Koordinate des Splinepunkts. |
| Y | Liest oder setzt die y-Koordinate des Splinepunkts. |
| Z | Liest oder setzt die z-Koordinate des Splinepunkts. |
Methoden 2, davon 2 beschrieben
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.