Objekt · SldWorks
WeldSymbol-Objekt
Ein Schweißsymbol als Beschriftung: Texte, Nahtsymbol, Kennzeichen wie Baustellennaht oder ringsum, und die Geometrie seiner Darstellung.
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
ModelDoc2.InsertWeldSymbol3: fügt ein Schweißsymbol einView.GetFirstWeldSymbolmitWeldSymbol.GetNextoderView.GetWeldSymbols: die Schweißsymbole einer ZeichenansichtAnnotation.GetSpecificAnnotation: bei einer Beschriftung der ArtswWeldSymbol(swAnnotationType_e)CosmeticWeldBeadFeatureData.WeldSymbol: das Schweißsymbol einer kosmetischen Schweißraupe
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| GetAnnotation | Liefert die Beschriftung (Annotation), zu der das Schweißsymbol gehört. |
| GetArcAtIndex | Liefert Linientyp, Anfangs-, End- und Mittelpunkt und Drehsinn eines Bogens in der Darstellung des Schweißsymbols. |
| GetArcCount | Liefert die Zahl der Bögen in der Darstellung des Schweißsymbols. |
| GetArrowHeadAtIndex | Liefert Spitze, Richtung, Maße und Art einer Pfeilspitze in der Darstellung des Schweißsymbols. |
| GetArrowHeadCount | Liefert die Zahl der Pfeilspitzen in der Darstellung des Schweißsymbols. |
| GetArrowHeadInfo | Liefert Länge, Maße und Art der Pfeilspitze am fernen Ende der Bezugslinie. |
| GetContour | Liefert die Nahtoberfläche (Kontur) oberhalb oder unterhalb der Bezugslinie. |
| GetFieldWeld | Liefert, ob das Schweißsymbol eine Baustellennaht kennzeichnet und wohin die Fahne zeigt. |
| GetLeaderAtIndex | Liefert die Punkte einer Bezugslinie des Schweißsymbols. |
| GetLeaderCount | Liefert die Zahl der Bezugslinien am Schweißsymbol. |
| GetLineAtIndex | Liefert Linientyp, Anfangs- und Endpunkt einer Linie in der Darstellung des Schweißsymbols. |
| GetLineCount | Liefert die Zahl der Linien in der Darstellung des Schweißsymbols. |
| GetNext | Liefert das nächste Schweißsymbol in der Zeichenansicht. |
| GetPeripheral | Liefert, ob das Schweißsymbol eine ringsum verlaufende Naht kennzeichnet. |
| GetProcess | Liefert, ob am Schweißsymbol die Angabe des Schweißprozesses eingeschaltet ist. |
| GetProcessReference | Liefert, ob um den Text des Schweißprozesses ein Rahmen steht. |
| GetStagger | Liefert, ob das Schweißsymbol eine versetzte Naht kennzeichnet. |
| GetSymmetric | Liefert, ob das Schweißsymbol symmetrisch ist, und wenn nicht, ob die Strichlinie über oder unter der Bezugslinie liegt. |
| GetText | Liefert einen bestimmten Text des Schweißsymbols, etwa den Text links oberhalb der Bezugslinie oder das Nahtsymbol. |
| GetTextAngleAtIndex | Liefert den Winkel eines Textstücks in der Darstellung des Schweißsymbols. |
| GetTextAtIndex | Liefert ein Textstück aus der Darstellung des Schweißsymbols. |
| GetTextCount | Liefert die Zahl der Textstücke in der Darstellung des Schweißsymbols. |
| GetTextHeightAtIndex | Liefert die Schrifthöhe eines Textstücks in der Darstellung des Schweißsymbols. |
| GetTextInvertAtIndex | Liefert, ob ein Textstück in der Darstellung des Schweißsymbols an der X-Achse gespiegelt ist. |
| GetTextPositionAtIndex | Liefert die Lage eines Textstücks relativ zum Ursprung des Schweißsymbols. |
| GetTextRefPositionAtIndex | Liefert, auf welchen Punkt eines Textstücks sich seine Lage bezieht, etwa oben links oder Mitte. |
| GetTriangleAtIndex | Liefert die Eckpunkte, die Füllung und den Linientyp eines Dreiecks in der Darstellung des Schweißsymbols. |
| GetTriangleCount | Liefert die Zahl der Dreiecke in der Darstellung des Schweißsymbols. |
| HasExtraLeader | Liefert, ob die Bezugslinie des Schweißsymbols geknickt ist, also eine zusätzliche Linie hat. |
| IsAttached | Liefert, ob das Schweißsymbol mit einer Bezugslinie angehängt ist. |
| SetFieldWeld | Legt fest, ob das Schweißsymbol eine Baustellennaht kennzeichnet und wohin die Fahne zeigt. |
| SetPeripheral | Legt fest, ob das Schweißsymbol eine ringsum verlaufende Naht kennzeichnet. |
| SetProcess | Setzt die Angabe des Schweißprozesses am Schweißsymbol: ein oder aus, Text und Rahmen. |
| SetStagger | Legt fest, ob das Schweißsymbol eine versetzte Naht kennzeichnet. |
| SetSymmetric | Legt fest, ob das Schweißsymbol symmetrisch ist, und wenn nicht, ob die Strichlinie über oder unter der Bezugslinie liegt. |
| SetText | Setzt 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.