Objekt · SldWorks
DowelSymbol-Objekt
Ein Passstiftsymbol (Dowel Pin Symbol) in einer Zeichnung: umdrehen, den zugrunde liegenden Bogen lesen, die Beschriftung holen und zum nächsten Symbol weitergehen.
Beschreibung
DowelSymbol gibt Zugriff auf ein Passstiftsymbol. Ein Passstiftsymbol sitzt in einer Zeichenansicht auf einer Kante, genauer auf einem Bogen oder Kreis (siehe DowelSymbol.GetArcPoints). Lage, Layer und Name stehen bei der zugehörigen Annotation, die du mit DowelSymbol.GetAnnotation bekommst. Die Befehle gibt es seit SOLIDWORKS 2001Plus.
Zugriff
DrawingDoc.InsertDowelSymbol: setzt ein neues Passstiftsymbol auf die ausgewählte Kante oder KantenView.GetFirstDowelSymbolund dannDowelSymbol.GetNext: alle Passstiftsymbole einer Zeichenansicht nacheinanderView.GetDowelSymbolsundView.GetDowelSymbolCount: alle Passstiftsymbole einer Zeichenansicht als Array und ihre AnzahlAnnotation.GetSpecificAnnotation: aus einer Beschriftung, wennAnnotation.GetTypeswDowelSym(swAnnotationType_e) liefertSelectionMgr.GetSelectedObject6: ein ausgewähltes Passstiftsymbol, AuswahltypswSelDOWELSYMS(swSelectType_e), Typname „DOWELSYM“ beiModelDocExtension.SelectByID2
Beispiel
' Dreht alle Passstiftsymbole in den Ansichten des aktuellen Blatts um
' und gibt Name, Zustand und Bogenpunkte aus.
' Vorbedingung: Eine Zeichnung mit Passstiftsymbolen ist offen.
' Ergebnis: Die Symbole sind umgedreht, die Angaben stehen im Direktfenster (Strg+G).
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swDraw As SldWorks.DrawingDoc
Dim swView As SldWorks.View
Dim swStift As SldWorks.DowelSymbol
Dim swAnn As SldWorks.Annotation
Dim vPunkte As Variant
Dim nAnzahl As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocDRAWING Then Exit Sub
Set swDraw = swModel
' Die erste Ansicht ist das Blatt selbst, die Zeichenansichten folgen.
Set swView = swDraw.GetFirstView
Set swView = swView.GetNextView
Do While Not swView Is Nothing
Set swStift = swView.GetFirstDowelSymbol
Do While Not swStift Is Nothing
swStift.Flipped = (swStift.Flipped = False)
nAnzahl = nAnzahl + 1
Set swAnn = swStift.GetAnnotation
vPunkte = swStift.GetArcPoints
Debug.Print swView.GetName2 & " / " & swAnn.GetName & ": umgedreht = " & swStift.Flipped
Debug.Print " Anfang (mm): " & vPunkte(0) * 1000# & ", " & vPunkte(1) * 1000#
Debug.Print " Mitte (mm): " & vPunkte(2) * 1000# & ", " & vPunkte(3) * 1000#
Debug.Print " Ende (mm): " & vPunkte(4) * 1000# & ", " & vPunkte(5) * 1000#
Set swStift = swStift.GetNext
Loop
Set swView = swView.GetNextView
Loop
' Nach dem Umdrehen neu aufbauen, wie es die Hilfe verlangt.
If nAnzahl > 0 Then swModel.EditRebuild3
Debug.Print nAnzahl & " Passstiftsymbol(e) umgedreht."
End SubBemerkungen
Hilfebeispiele: „Flip Dowel Pin Symbol“ wählt in einer Zeichenansicht eine Kreiskante aus, setzt mit DrawingDoc.InsertDowelSymbol ein Passstiftsymbol, wählt es danach mit ModelDocExtension.SelectByID2 und dem Typnamen „DOWELSYM“ aus, setzt DowelSymbol.Flipped auf True, ruft ModelDoc2.EditRebuild3 auf und gibt den Namen der Beschriftung aus. „Get Annotation Object“ holt die Beschriftung eines ausgewählten Passstiftsymbols mit DowelSymbol.GetAnnotation.
Neu aufbauen: Nach dem Umdrehen mit DowelSymbol.Flipped rufst du ModelDoc2.EditRebuild3 auf.
Schleife: DowelSymbol.GetNext liefert das nächste Passstiftsymbol „im aktuellen Blatt, in der Ansicht oder im Modell“. Ob die Schleife ab View.GetFirstDowelSymbol an der Grenze der Ansicht endet, sagt die Hilfe nicht genau. Das Beispiel oben geht von einer Schleife je Ansicht aus.
Automatisch einfügen: Ob SOLIDWORKS Passstiftsymbole beim Anlegen einer Ansicht selbst einfügt, steuern die Dokumenteigenschaften swDetailingAutoInsertDowelSymbols (Teile) und swDetailingAutoInsertDowelSymbolsAsm (Baugruppen) aus swUserPreferenceToggle_e, gelesen mit ModelDocExtension.GetUserPreferenceToggle.
Wenige Befehle: Größe, Form oder Lage des Symbols setzt DowelSymbol nicht. Allgemeine Angaben wie Lage und Layer stehen bei der Annotation.
Eigenschaften und Methoden
Eigenschaften 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| Flipped | Liest oder setzt, ob das Passstiftsymbol umgedreht ist. |
Methoden 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| GetAnnotation | Liefert die Beschriftung (Annotation) zum Passstiftsymbol, mit Name, Lage und Layer. |
| GetArcPoints | Liefert Anfangs-, Mittel- und Endpunkt des Bogens, auf dem das Passstiftsymbol sitzt, nur in x und y. |
| GetNext | Liefert das nächste Passstiftsymbol, für eine Schleife über alle Passstiftsymbole. |
Nicht aufgeführt sind 3 C++-Varianten (Namen mit I davor, zum Beispiel IGetAnnotation). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IDowelSymbol in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.