SolidWorksMakroprogrammierung

Methode · DrawingDoc

CreateAngDim4-Methode (DrawingDoc)

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

Syntax

Function CreateAngDim4( _
   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 P6 As Variant, _
   ByVal TextPoint As Variant, _
   ByVal TextHeight As Double _
) As Object
Set swDispDim = swDraw.CreateAngDim4(vP0, vP1, vP2, vP3, vP4, vP5, vP6, vText, 0.005)

Parameter

P0VariantByVal
Array mit drei Double-Werten X, Y, Z. Der Endpunkt der Bemaßung.
P1VariantByVal
Array mit drei Double-Werten. Der Punkt der Bemaßung.
P2VariantByVal
Array mit drei Double-Werten: Anfangspunkt der ersten Maßhilfslinie.
P3VariantByVal
Array mit drei Double-Werten: Endpunkt der ersten Maßhilfslinie.
P4VariantByVal
Array mit drei Double-Werten: Anfangspunkt der zweiten Maßhilfslinie.
P5VariantByVal
Array mit drei Double-Werten: Endpunkt der zweiten Maßhilfslinie.
P6VariantByVal
Array mit drei Double-Werten: die Normale der Ebene, in der die Bemaßung liegt. Auf dem Blatt vermutlich 0, 0, 1.
TextPointVariantByVal
Array mit drei Double-Werten: die Stelle des Maßtexts.
TextHeightDoubleByVal
Die Texthöhe in Metern.

Rückgabewert

Die neue Bemaßung (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), hier als Parameter der Prozedur übergeben.
' Scheitel bei X = 100 mm, Y = 100 mm, erster Schenkel waagrecht, zweiter um 30° gedreht.
Sub WinkelSetzen(swDraw As SldWorks.DrawingDoc)
    Const PI As Double = 3.14159265358979
    Dim swDispDim As SldWorks.DisplayDimension
    Dim dX As Double, dY As Double, dW As Double
    dX = 0.1: dY = 0.1: dW = 30 * PI / 180
    Set swDispDim = swDraw.CreateAngDim4( _
        Punkt(dX + 0.04 * Cos(dW), dY + 0.04 * Sin(dW)), _
        Punkt(dX + 0.04 * Cos(dW / 2), dY + 0.04 * Sin(dW / 2)), _
        Punkt(dX, dY), Punkt(dX + 0.05, dY), _
        Punkt(dX, dY), Punkt(dX + 0.05 * Cos(dW), dY + 0.05 * Sin(dW)), _
        Punkt(0, 0, 1), _
        Punkt(dX + 0.045 * Cos(dW / 2), dY + 0.045 * Sin(dW / 2)), _
        0.005)
    If swDispDim Is Nothing Then
        Debug.Print "Keine Bemaßung erzeugt."
    Else
        Debug.Print "Winkelbemaßung erzeugt."
    End If
End Sub

' Baut ein Array aus drei Double-Werten.
Function Punkt(ByVal dX As Double, ByVal dY As Double, Optional ByVal dZ As Double = 0) As Variant
    Dim d(2) As Double
    d(0) = dX: d(1) = dY: d(2) = dZ
    Punkt = d
End Function

Bemerkungen

Die Bemaßung entsteht aus den Punkten, die du angibst. Sie ist mit keiner Geometrie verknüpft und ändert sich deshalb nicht mit dem Modell. Einen Wert für den Winkel übergibst du nicht.

Ersetzt DrawingDoc.CreateAngDim3. Die neue Version unterscheidet sich in der Zahl der Parameter: Pfeilgröße, Maßtext sowie Abstand und Überstand der Maßhilfslinien fallen weg. Der Hinweis in der Hilfe nennt dabei CreateDiamDim4, gemeint ist vermutlich der Vorgänger CreateAngDim3.

Die Hilfe ist hier sehr knapp. Sie nennt für die Punkte weder Einheit noch Koordinatensystem. Vermutlich sind es Blattkoordinaten in Metern wie bei TextHeight. Was „Endpunkt“ (P0) und „Punkt“ (P1) der Bemaßung genau bedeuten, erklärt sie nicht. Das Beispiel legt P0 an das Ende des Maßbogens auf dem zweiten Schenkel und P1 in die Mitte des Bogens. Das ist eine Annahme. Probier es in der eigenen Zeichnung aus, bevor du dich darauf verlässt.

Jeder Punkt ist ein Array aus drei Double-Werten. Array(...) liefert in VBA dagegen ein Array aus Variant. Das Beispiel baut die Punkte deshalb mit einer kleinen Funktion.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2000

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

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