SolidWorksMakroprogrammierung

Methode · DrawingDoc

CreateLinearDim4-Methode (DrawingDoc)

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

Syntax

Function CreateLinearDim4( _
   ByVal P0 As Variant, _
   ByVal P1 As Variant, _
   ByVal P2 As Variant, _
   ByVal P3 As Variant, _
   ByVal P4 As Variant, _
   ByVal TextPoint As Variant, _
   ByVal Val As Double, _
   ByVal Angle As Double, _
   ByVal TextHeight As Double _
) As Object
Set swDispDim = swDraw.CreateLinearDim4(vLinieA, vLinieB, vNormale, vA, vB, vText, 0.1, 0, 0.0035)

Parameter

P0VariantByVal
Array mit drei Double (X, Y, Z): der Bemaßungspunkt.
P1VariantByVal
Array mit drei Double: das Ende der Bemaßung.
P2VariantByVal
Array mit drei Double: die Normale der Skizzenebene. Für eine Bemaßung in der Blattebene vermutlich (0, 0, 1).
P3VariantByVal
Array mit drei Double: Bezugspunkt der ersten Maßhilfslinie.
P4VariantByVal
Array mit drei Double: Bezugspunkt der zweiten Maßhilfslinie.
TextPointVariantByVal
Array mit drei Double: die Lage des Maßtexts.
ValDoubleByVal
Der Wert, den die Bemaßung zeigt. Die Hilfe nennt keine Einheit. Bei DrawingDoc.CreateDiamDim4 sind es Meter, vermutlich auch hier.
AngleDoubleByVal
Neigung des Texts 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. P0 und P1 sind die Enden der Maßlinie, P3 und P4 die Fußpunkte der Maßhilfslinien.
Dim swDispDim As SldWorks.DisplayDimension
Dim dA(2) As Double, dB(2) As Double, dLinieA(2) As Double, dLinieB(2) As Double
Dim dNormale(2) As Double, dText(2) As Double
Dim vA As Variant, vB As Variant, vLinieA As Variant, vLinieB As Variant
Dim vNormale As Variant, vText As Variant
dA(0) = 0.1: dA(1) = 0.1                    ' gemessene Punkte
dB(0) = 0.2: dB(1) = 0.1
dLinieA(0) = dA(0): dLinieA(1) = 0.12       ' Maßlinie 20 mm darüber
dLinieB(0) = dB(0): dLinieB(1) = 0.12
dNormale(2) = 1
dText(0) = 0.15: dText(1) = 0.125
vA = dA: vB = dB: vLinieA = dLinieA: vLinieB = dLinieB: vNormale = dNormale: vText = dText
Set swDispDim = swDraw.CreateLinearDim4(vLinieA, vLinieB, vNormale, vA, vB, vText, dB(0) - dA(0), 0, 0.0035)
If swDispDim Is Nothing Then Debug.Print "Keine Bemaßung erzeugt." Else Debug.Print "Bemaßung " & (dB(0) - dA(0)) * 1000 & " mm eingefügt."

Bemerkungen

Die Bemaßung entsteht zwischen den beiden angegebenen Punkten und hat keine Verbindung zur Geometrie. Den Wert gibst du selbst vor, er ändert sich nicht mit dem Modell.

Die Hilfe beschreibt die Punkte nur mit Stichworten. Wie das Beispiel P0, P1, P3 und P4 deutet, ist eine Annahme. Auch das Koordinatensystem nennt die Hilfe nicht. 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.CreateLinearDim3, dem Genauigkeit, Toleranzen, Pfeile und Texte noch als Parameter übergeben wurden. Eine Bemaßung, die an der Geometrie hängt, fügst du mit ModelDocExtension.AddDimension ein.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2000

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

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