SolidWorksMakroprogrammierung

Objekt · SldWorks

Environment-Objekt

Die Umgebung von SOLIDWORKS mit der Symbolbibliothek: Linien, Bögen, Kreise, Dreiecke und Texte, aus denen ein Symbol für Form- und Lagetoleranzen besteht.

Deklaration Dim x As SldWorks.Environment · in der englischen .NET-Hilfe: IEnvironment

Beschreibung

Mit Environment analysierst du Text und Geometrie, aus denen ein Symbol für Form- und Lagetoleranzen gezeichnet wird. Das hilft etwa, wenn du eine Notiz mit einem solchen Symbol übersetzen willst. Du sprichst ein Symbol über seinen Namen in der Form <Bibliothek-Symbol> an, etwa <MOD-DEG> oder <GTOL-SPROF>. Bibliothek und Symbol stehen in der Textdatei gtol.sym unter C:\ProgramData\SolidWorks\SolidWorks 20nn\lang\english. Seit wann es die meisten Befehle gibt, nennt die Hilfe nicht. GetSymArcs2 gibt es seit SOLIDWORKS 2015 SP01, GetIsBound seit SOLIDWORKS 2017.

Zugriff

Beispiel

' Gibt aus, woraus das Symbol für Profil einer Fläche besteht, dazu
' die Linien und die Texte mit ihrer Lage.
' Vorbedingung: SOLIDWORKS läuft. Das Hilfebeispiel öffnet vorher ein Teil,
'               ob das nötig ist, sagt die Hilfe nicht.
' Ergebnis:     Die Angaben stehen im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Const SYMBOL As String = "<GTOL-SPROF>"
    Dim swApp As SldWorks.SldWorks
    Dim swEnv As SldWorks.Environment
    Dim vZahl As Variant
    Dim vLinien As Variant
    Dim vTexte As Variant
    Dim vPunkte As Variant
    Dim bGebunden As Boolean
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swEnv = swApp.GetEnvironment
    If swEnv Is Nothing Then Exit Sub

    swEnv.GetIsBound SYMBOL, bGebunden
    vZahl = swEnv.GetSymEdgeCounts(SYMBOL)
    Debug.Print SYMBOL & ", gebunden: " & bGebunden
    Debug.Print vZahl(0) & " Linien, " & vZahl(1) & " Bögen, " & vZahl(2) & " Kreise, " & _
        vZahl(3) & " Texte, " & vZahl(4) & " Dreiecke"

    If vZahl(0) > 0 Then
        vLinien = swEnv.GetSymLines(SYMBOL)
        For i = 0 To vZahl(0) - 1
            Debug.Print "  Linie " & i & ": " & vLinien(6 * i) & " / " & vLinien(6 * i + 1) & _
                " bis " & vLinien(6 * i + 3) & " / " & vLinien(6 * i + 4)
        Next i
    End If

    If vZahl(3) > 0 Then
        vTexte = swEnv.GetSymText(SYMBOL)
        vPunkte = swEnv.GetSymTextPoints(SYMBOL)
        For i = 0 To vZahl(3) - 1
            Debug.Print "  Text " & vTexte(i) & " bei " & vPunkte(3 * i) & " / " & vPunkte(3 * i + 1)
        Next i
    End If
End Sub

Bemerkungen

Bezug auf die Texthöhe: Alle Zahlen aus Environment beziehen sich auf eine Texthöhe von 1. Hat ein Symbol die Texthöhe 0,15, multiplizierst du die Werte mit 0,15. Die Koordinaten sind also keine Meter, sondern Vielfache der Texthöhe. In welchem Bezugssystem sie stehen, etwa mit dem Ursprung an einer Ecke des Symbols, sagt die Hilfe nicht.

Erst zählen, dann lesen: Die Größe der Arrays hängt davon ab, wie viele Linien, Bögen, Kreise, Texte und Dreiecke das Symbol hat. Diese Zahlen liefert Environment.GetSymEdgeCounts.

Gtol: Auch Gtol hat Befehle mit denselben Namen, etwa Gtol.GetSymEdgeCounts. Dort gibst du das Symbol aber über einen Index an, und es gibt weder Dreiecke noch GetSymArcs2 oder GetIsBound.

Hilfebeispiel: „Analyze Text and Geometry in GTol Symbol“ öffnet ein Teil aus den Tutorial-Beispielen, holt die Umgebung mit SldWorks.GetEnvironment und gibt für <GTOL-SPROF> aus, ob es gebunden ist, die fünf Zahlen, alle Koordinaten der Linien und alle Werte der Bögen aus Environment.GetSymArcs2.

Veraltet: Environment.GetSymArcs ist durch Environment.GetSymArcs2 ersetzt, das je Bogen zusätzlich liefert, ob er gefüllt ist und ob seine Sehne gezeichnet wird.

SldWorks.GetEnvironment liefert die Symbolbibliothek auch ohne offenes Dokument mit demselben Ergebnis, ein offenes Teil brauchst du nicht.

Eigenschaften und Methoden

Methoden 9, davon 8 beschrieben, 1 veraltet

NameBeschreibung
GetIsBoundLiefert, ob ein Symbol der Symbolbibliothek gebunden ist, also wie es im Text einer Notiz oder eines Maßes horizontal eingepasst wird.
GetSymArcsveraltet ersetzt durch Environment.GetSymArcs2
GetSymArcs2Liefert Mittel-, Anfangs- und Endpunkt aller Bögen eines Symbols der Symbolbibliothek und ob sie gefüllt sind und eine Sehne haben.
GetSymCirclesLiefert Radius und Mittelpunkt aller Kreise eines Symbols der Symbolbibliothek.
GetSymEdgeCountsLiefert, wie viele Linien, Bögen, Kreise, Texte und Dreiecke ein Symbol der Symbolbibliothek hat.
GetSymLinesLiefert Anfangs- und Endpunkt aller Linien eines Symbols der Symbolbibliothek.
GetSymTextLiefert die Texte eines Symbols der Symbolbibliothek.
GetSymTextPointsLiefert die Lage aller Texte eines Symbols der Symbolbibliothek.
GetSymTrianglesLiefert die drei Eckpunkte aller Dreiecke eines Symbols der Symbolbibliothek und ob sie gefüllt sind.

Nicht aufgeführt sind 6 C++-Varianten (Namen mit I davor, zum Beispiel IGetSymArcs). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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