SolidWorksMakroprogrammierung

Methode · DrawingDoc

CreateOrdinateDim4-Methode (DrawingDoc)

Erzeugt eine Koordinatenbemaßung, die mit keiner Geometrie verknüpft ist.

Syntax

Function CreateOrdinateDim4( _
   ByVal P0 As Variant, _
   ByVal P1 As Variant, _
   ByVal P2 As Variant, _
   ByVal P3 As Variant, _
   ByVal P4 As Variant, _
   ByVal P5 As Variant, _
   ByVal Val As Double, _
   ByVal Angle As Double, _
   ByVal TextHeight As Double _
) As Object
Set swDispDim = swDraw.CreateOrdinateDim4(vPunkt, vRichtung, vStart, vEnde, vTextRichtung, vText, 0.05, 0, 0.0035)

Parameter

P0VariantByVal
Array mit drei Double (X, Y, Z): der Bemaßungspunkt.
P1VariantByVal
Array mit drei Double: Einheitsvektor für die Richtung der Koordinatenbemaßung.
P2VariantByVal
Array mit drei Double: Anfangspunkt der Maßhilfslinie.
P3VariantByVal
Array mit drei Double: Endpunkt der Maßhilfslinie.
P4VariantByVal
Array mit drei Double: Einheitsvektor für die Ausrichtung des Texts. (1, 0, 0) ergibt waagerechten Text, der von links nach rechts gelesen wird.
P5VariantByVal
Array mit drei Double: die Lage des Texts.
ValDoubleByVal
Der Wert, den die Bemaßung zeigt. Die Hilfe nennt keine Einheit, vermutlich Meter.
AngleDoubleByVal
Neigung der Zeichen (Schrägstellung) im Bogenmaß.
TextHeightDoubleByVal
Die Texthöhe in Metern.

Rückgabewert

Die neue Bemaßung als DisplayDimension. Was bei einem Fehler zurückkommt, sagt die Hilfe nicht. Prüf das Ergebnis mit Is Nothing.

Beispiel

' swDraw ist die aktive Zeichnung (DrawingDoc), etwa per Set swDraw = swModel.
' Annahme: Blattkoordinaten in Metern, der Nullpunkt der Bemaßung liegt bei X = 0,1 m.
Dim swDispDim As SldWorks.DisplayDimension
Dim dPunkt(2) As Double, dRichtung(2) As Double, dStart(2) As Double, dEnde(2) As Double
Dim dTextRichtung(2) As Double, dText(2) As Double
Dim vPunkt As Variant, vRichtung As Variant, vStart As Variant, vEnde As Variant
Dim vTextRichtung As Variant, vText As Variant
Dim dNull As Double
dNull = 0.1
dPunkt(0) = 0.15: dPunkt(1) = 0.1               ' bemaßter Punkt
dRichtung(0) = 1                               ' gemessen in X-Richtung
dStart(0) = dPunkt(0): dStart(1) = dPunkt(1) + 0.005
dEnde(0) = dPunkt(0): dEnde(1) = dPunkt(1) + 0.03
dTextRichtung(0) = 1                           ' Text waagerecht
dText(0) = dPunkt(0): dText(1) = dPunkt(1) + 0.035
vPunkt = dPunkt: vRichtung = dRichtung: vStart = dStart: vEnde = dEnde
vTextRichtung = dTextRichtung: vText = dText
Set swDispDim = swDraw.CreateOrdinateDim4(vPunkt, vRichtung, vStart, vEnde, vTextRichtung, vText, dPunkt(0) - dNull, 0, 0.0035)
If swDispDim Is Nothing Then Debug.Print "Keine Bemaßung erzeugt." Else Debug.Print "Koordinate " & (dPunkt(0) - dNull) * 1000 & " mm eingefügt."

Bemerkungen

Die Bemaßung hat keine Verbindung zur Geometrie. Den Wert gibst du selbst vor, er ändert sich nicht mit dem Modell. Die Hilfe sagt außerdem, die Bemaßung entstehe zwischen zwei angegebenen Punkten, nennt aber nicht, welche das sind.

Die Hilfe beschreibt die Punkte nur mit Stichworten und nennt kein Koordinatensystem. Wie das Beispiel die Punkte deutet, ist eine Annahme. Probier es in der eigenen Zeichnung aus, bevor du dich darauf verlässt. Die Arrays legst du als Double-Array mit drei Einträgen an und weist es einer Variant-Variablen zu.

Ersetzt DrawingDoc.CreateOrdinateDim3. Eine Koordinatenbemaßung, die an der Geometrie hängt, fügst du mit ModelDocExtension.AddOrdinateDimension ein.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2000

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

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