SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.DowelSymbol · in der englischen .NET-Hilfe: IDowelSymbol

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

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 Sub

Bemerkungen

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

NameBeschreibung
FlippedLiest oder setzt, ob das Passstiftsymbol umgedreht ist.

Methoden 3, davon 3 beschrieben

NameBeschreibung
GetAnnotationLiefert die Beschriftung (Annotation) zum Passstiftsymbol, mit Name, Lage und Layer.
GetArcPointsLiefert Anfangs-, Mittel- und Endpunkt des Bogens, auf dem das Passstiftsymbol sitzt, nur in x und y.
GetNextLiefert 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.