SolidWorksMakroprogrammierung

Methode · SketchSpline

SetEquationParameters2-Methode (SketchSpline)

Setzt die Gleichung und die übrigen Parameter einer gleichungsgesteuerten Kurve.

Syntax

Function SetEquationParameters2( _
   ByVal XExpression As String, _
   ByVal YExpression As String, _
   ByVal ZExpression As String, _
   ByVal RangeStart As Double, _
   ByVal RangeEnd As Double, _
   ByVal IsAngleRange As Boolean, _
   ByVal RotationAngle As Double, _
   ByVal XOffset As Double, _
   ByVal YOffset As Double, _
   ByVal LockStart As Boolean, _
   ByVal LockEnd As Boolean _
) As Boolean
bOk = swSpline.SetEquationParameters2(XExpression, YExpression, ZExpression, RangeStart, RangeEnd, IsAngleRange, RotationAngle, XOffset, YOffset, LockStart, LockEnd)

Parameter

XExpressionStringByVal
Gleichung für x, bei einer expliziten Kurve leer.
YExpressionStringByVal
Gleichung für y.
ZExpressionStringByVal
Gleichung für z, bei einer 2D-Kurve leer.
RangeStartDoubleByVal
Anfangswert von x.
RangeEndDoubleByVal
Endwert von x.
IsAngleRangeBooleanByVal
True, wenn Bereich und x-Wert ein Winkel im Bogenmaß sind.
RotationAngleDoubleByVal
Drehwinkel der Kurve im Bogenmaß.
XOffsetDoubleByVal
Versatz in x für f(x) bei x = 0.
YOffsetDoubleByVal
Versatz in y für f(x) bei x = 0.
LockStartBooleanByVal
True: Anfangspunkt (RangeStart) der Kurve sperren.
LockEndBooleanByVal
True: Endpunkt (RangeEnd) der Kurve sperren.

Rückgabewert

True, wenn die Parameter gesetzt wurden, sonst False.

Beispiel

' swSpline ist eine gleichungsgesteuerte Kurve (SketchSpline), etwa aus SketchManager.CreateEquationSpline2.
Dim sX As String, sY As String, sZ As String
Dim dVon As Double, dBis As Double, dWinkel As Double, dVersX As Double, dVersY As Double
Dim bWinkel As Boolean, bSperrAnf As Boolean, bSperrEnd As Boolean
If swSpline.GetEquationParameters2(sX, sY, sZ, dVon, dBis, bWinkel, dWinkel, dVersX, dVersY, bSperrAnf, bSperrEnd) Then
    If False = swSpline.SetEquationParameters2(sX, "cos(x)", sZ, dVon, dBis, bWinkel, dWinkel, dVersX, dVersY, bSperrAnf, bSperrEnd) Then
        Debug.Print "Gleichung nicht gesetzt"
    End If
End If

Bemerkungen

Die Hilfe beschreibt die Parameter nur kurz. Ausführlicher ist sie bei SketchManager.CreateEquationSpline2: Bei einer expliziten Kurve y = f(x), nur in 2D, ist XExpression leer, bei einer Parameterkurve stehen x, y und z in Abhängigkeit von t. XOffset, YOffset, IsAngleRange und RotationAngle braucht man nach dieser Seite meist nicht. Anders als beim Anlegen gibst du die Bereichsgrenzen hier als Zahlen an.

Das Hilfebeispiel „Create Equation-driven Curve“ ändert so eine Sinuskurve in eine Kosinuskurve, nutzt dafür aber noch das veraltete SetEquationParameters. Ob die Skizze dafür in Bearbeitung sein muss, sagt die Hilfe nicht.

Übernimmst du die Bereichsgrenzen aus SketchSpline.GetEquationParameters2, kann die Kurve kürzer werden: Für eine Grenze „2*pi“ liefert sie nur 2, und die Kurve endet danach bei x = 2.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2010

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

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