SolidWorksMakroprogrammierung

Objekt · SldWorks

WeldSymbol-Objekt

Ein Schweißsymbol als Beschriftung: Texte, Nahtsymbol, Kennzeichen wie Baustellennaht oder ringsum, und die Geometrie seiner Darstellung.

Deklaration Dim x As SldWorks.WeldSymbol · in der englischen .NET-Hilfe: IWeldSymbol

Beschreibung

WeldSymbol gibt Zugriff auf Schweißsymbole. Ein Schweißsymbol hat eine waagrechte Bezugslinie mit einem Teil oberhalb und einem unterhalb. In jedem Teil stehen ein Nahtsymbol, Texte links und rechts davon, auf Wunsch ein Text für versetzte Nähte und eine Nahtoberfläche (Kontur). Dazu kommen Kennzeichen wie Baustellennaht, ringsum verlaufende Naht und die Angabe des Schweißprozesses. Wo die Hilfe eine Version nennt, ist es SOLIDWORKS 99 oder 98Plus.

Zugriff

Beispiel

' Fügt an der Auswahl ein Schweißsymbol ein: oben das Nahtsymbol BUTT mit Texten,
' versetzt, symmetrisch, mit Angabe des Schweißprozesses. Gibt danach die Einstellungen aus.
' Vorbedingung: Ein Teil (etwa ein Schweißteil) ist offen, eine Fläche, Kante oder ein
'               Skizzensegment ist ausgewählt.
' Ergebnis:     Das Schweißsymbol steht im Modell, die Werte stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSchweiss As SldWorks.WeldSymbol

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub

    Set swSchweiss = swModel.InsertWeldSymbol3
    If swSchweiss Is Nothing Then
        Debug.Print "Schweißsymbol nicht eingefügt"
        Exit Sub
    End If

    swSchweiss.SetFieldWeld swFieldWeldNone
    swSchweiss.SetPeripheral False
    swSchweiss.SetProcess True, "111", True
    swSchweiss.SetStagger True
    swSchweiss.SetSymmetric swWeldSymmetric
    swSchweiss.SetText True, "a3", "BUTT", "4x50", "(100)", swWeldContourNone

    Debug.Print "Oben: " & swSchweiss.GetText(swWeldLeftTextAbove) & " " & _
                swSchweiss.GetText(swWeldSymbolTextAbove) & " " & swSchweiss.GetText(swWeldRightTextAbove)
    Debug.Print "Prozess: " & swSchweiss.GetText(swWeldProcessText) & _
                IIf(swSchweiss.GetProcessReference, " (mit Rahmen)", "")
    Debug.Print "Versetzt: " & swSchweiss.GetStagger & ", Symmetrie: " & swSchweiss.GetSymmetric
    Debug.Print "Mit Bezugslinie: " & swSchweiss.IsAttached & ", geknickt: " & swSchweiss.HasExtraLeader
    Debug.Print swSchweiss.GetLineCount & " Linien, " & swSchweiss.GetTextCount & " Textstücke"
End Sub

Bemerkungen

Hilfebeispiel: Das Beispiel „Insert Weld Symbol“ fügt in weldment_box3.sldprt ein ISO-Schweißsymbol an der Auswahl ein, setzt alle Kennzeichen und gibt die Zähler und Kennzeichen aus. Es ist das einzige Hilfebeispiel zu diesem Objekt.

Nahtsymbole: Die Namen der Nahtsymbole für WeldSymbol.SetText stehen in der Datei gtol.sym, typisch unter C:\ProgramData\SolidWorks\SolidWorks 20nn\lang\english. Unterstützt werden die ISO-Symbole BUTT, BUSQ, BUSV, BUSB, BUSVBR, BUSBR, BUSU, BUSJ, BACK, FILL, PLUG, SPOT, SEAM, SEAMC, JSPT und JSM.

Darstellung: Die Befehle für Linien, Bögen, Dreiecke, Pfeilspitzen und Textstücke beschreiben, wie SOLIDWORKS das Symbol zeichnet. Die Einheit der Koordinaten nennt die Hilfe nicht, vermutlich sind es wie sonst in der API Meter. Nur bei WeldSymbol.GetTextHeightAtIndex nennt sie Meter, bei WeldSymbol.GetTextAngleAtIndex Bogenmaß.

Beschriftung: Allgemeine Dinge wie Lage, Ebene oder Sichtbarkeit stellst du über die Annotation aus WeldSymbol.GetAnnotation ein.

Eigenschaften und Methoden

Methoden 36, davon 36 beschrieben

NameBeschreibung
GetAnnotationLiefert die Beschriftung (Annotation), zu der das Schweißsymbol gehört.
GetArcAtIndexLiefert Linientyp, Anfangs-, End- und Mittelpunkt und Drehsinn eines Bogens in der Darstellung des Schweißsymbols.
GetArcCountLiefert die Zahl der Bögen in der Darstellung des Schweißsymbols.
GetArrowHeadAtIndexLiefert Spitze, Richtung, Maße und Art einer Pfeilspitze in der Darstellung des Schweißsymbols.
GetArrowHeadCountLiefert die Zahl der Pfeilspitzen in der Darstellung des Schweißsymbols.
GetArrowHeadInfoLiefert Länge, Maße und Art der Pfeilspitze am fernen Ende der Bezugslinie.
GetContourLiefert die Nahtoberfläche (Kontur) oberhalb oder unterhalb der Bezugslinie.
GetFieldWeldLiefert, ob das Schweißsymbol eine Baustellennaht kennzeichnet und wohin die Fahne zeigt.
GetLeaderAtIndexLiefert die Punkte einer Bezugslinie des Schweißsymbols.
GetLeaderCountLiefert die Zahl der Bezugslinien am Schweißsymbol.
GetLineAtIndexLiefert Linientyp, Anfangs- und Endpunkt einer Linie in der Darstellung des Schweißsymbols.
GetLineCountLiefert die Zahl der Linien in der Darstellung des Schweißsymbols.
GetNextLiefert das nächste Schweißsymbol in der Zeichenansicht.
GetPeripheralLiefert, ob das Schweißsymbol eine ringsum verlaufende Naht kennzeichnet.
GetProcessLiefert, ob am Schweißsymbol die Angabe des Schweißprozesses eingeschaltet ist.
GetProcessReferenceLiefert, ob um den Text des Schweißprozesses ein Rahmen steht.
GetStaggerLiefert, ob das Schweißsymbol eine versetzte Naht kennzeichnet.
GetSymmetricLiefert, ob das Schweißsymbol symmetrisch ist, und wenn nicht, ob die Strichlinie über oder unter der Bezugslinie liegt.
GetTextLiefert einen bestimmten Text des Schweißsymbols, etwa den Text links oberhalb der Bezugslinie oder das Nahtsymbol.
GetTextAngleAtIndexLiefert den Winkel eines Textstücks in der Darstellung des Schweißsymbols.
GetTextAtIndexLiefert ein Textstück aus der Darstellung des Schweißsymbols.
GetTextCountLiefert die Zahl der Textstücke in der Darstellung des Schweißsymbols.
GetTextHeightAtIndexLiefert die Schrifthöhe eines Textstücks in der Darstellung des Schweißsymbols.
GetTextInvertAtIndexLiefert, ob ein Textstück in der Darstellung des Schweißsymbols an der X-Achse gespiegelt ist.
GetTextPositionAtIndexLiefert die Lage eines Textstücks relativ zum Ursprung des Schweißsymbols.
GetTextRefPositionAtIndexLiefert, auf welchen Punkt eines Textstücks sich seine Lage bezieht, etwa oben links oder Mitte.
GetTriangleAtIndexLiefert die Eckpunkte, die Füllung und den Linientyp eines Dreiecks in der Darstellung des Schweißsymbols.
GetTriangleCountLiefert die Zahl der Dreiecke in der Darstellung des Schweißsymbols.
HasExtraLeaderLiefert, ob die Bezugslinie des Schweißsymbols geknickt ist, also eine zusätzliche Linie hat.
IsAttachedLiefert, ob das Schweißsymbol mit einer Bezugslinie angehängt ist.
SetFieldWeldLegt fest, ob das Schweißsymbol eine Baustellennaht kennzeichnet und wohin die Fahne zeigt.
SetPeripheralLegt fest, ob das Schweißsymbol eine ringsum verlaufende Naht kennzeichnet.
SetProcessSetzt die Angabe des Schweißprozesses am Schweißsymbol: ein oder aus, Text und Rahmen.
SetStaggerLegt fest, ob das Schweißsymbol eine versetzte Naht kennzeichnet.
SetSymmetricLegt fest, ob das Schweißsymbol symmetrisch ist, und wenn nicht, ob die Strichlinie über oder unter der Bezugslinie liegt.
SetTextSetzt Texte, Nahtsymbol und Kontur im oberen oder unteren Teil des Schweißsymbols.

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

Siehe auch

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

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