SolidWorksMakroprogrammierung

Methode · DrawingDoc

NewGtol-Methode (DrawingDoc)

Erzeugt in der Zeichnung eine neue Form- und Lagetoleranz und liefert sie zurück.

Syntax

Function NewGtol() As Object
Set swGtol = swDraw.NewGtol

Rückgabewert

Die neue Form- und Lagetoleranz (Gtol). Was bei einem Fehler zurückkommt, sagt die Hilfe nicht. Prüf das Ergebnis vorsichtshalber mit Is Nothing.

Beispiel

' swDraw ist die aktive Zeichnung (DrawingDoc), etwa per Set swDraw = swModel.
Dim swGtol As SldWorks.Gtol
Dim swAnn As SldWorks.Annotation
Dim vPos As Variant
Dim bErfolg As Boolean
Set swGtol = swDraw.NewGtol
If swGtol Is Nothing Then
    Debug.Print "Keine Form- und Lagetoleranz erzeugt."
Else
    ' Linke obere Ecke des Symbols auf 100 mm / 80 mm des Blatts setzen
    Set swAnn = swGtol.GetAnnotation
    bErfolg = swAnn.SetPosition2(0.1, 0.08, 0)
    vPos = swAnn.GetPosition
    Debug.Print "Position: " & vPos(0) * 1000 & " / " & vPos(1) * 1000 & " mm"
End If

Bemerkungen

Die Hilfe sagt nur, dass ein neues Gtol-Objekt entsteht. Wo das Symbol erscheint, ob eine Auswahl als Anhängepunkt für eine Bezugslinie dient und was das Symbol anfangs enthält, ist nicht beschrieben. Vermutlich verhält es sich wie ModelDoc2.InsertGtol: Dort entsteht ein leeres Symbol, bei einer Auswahl mit Bezugslinie in deren Nähe, ohne Auswahl frei stehend am Ursprung. Probier es in deiner Zeichnung aus, bevor du dich darauf verlässt, oder nimm gleich das dokumentierte ModelDoc2.InsertGtol.

Position und Darstellung änderst du über Gtol.GetAnnotation und Annotation. Bei Annotation.SetPosition2 ist der Bezugspunkt einer Form- und Lagetoleranz die linke obere Ecke des Symbols, gemessen von der linken unteren Ecke des Blatts. Den Rahmen füllst du mit Gtol.SetFrameSymbols2 und Gtol.SetFrameValues2. Diese beiden gelten aber nur für Symbole, die in einer SOLIDWORKS-Version vor 2022 erzeugt wurden.

Siehe auch

Verfügbarkeit

In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.

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

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