SolidWorksMakroprogrammierung

Objekt · SldWorks

DrawingComponent-Objekt

Eine Komponente in einer Zeichenansicht (Zeichnungskomponente): Sichtbarkeit, Layer, Linienart und Linienstärke der Komponente in dieser Ansicht.

Deklaration Dim x As SldWorks.DrawingComponent · in der englischen .NET-Hilfe: IDrawingComponent

Beschreibung

DrawingComponent steht für eine referenzierte Komponente in einer Zeichenansicht. Das Objekt verbindet die Component2 der Baugruppe mit der Zeichenansicht (View) der Zeichnung. So änderst du die Einstellungen einer Komponente für die Zeichnung, ohne sie vorher auszuwählen. Die Einstellungen gelten nur für diese eine Ansicht. Die meisten Befehle gibt es seit SOLIDWORKS 2004, die Linienarten je Kantenart und UseDocumentDefaults seit SOLIDWORKS 2012.

Zugriff

Beispiel

' Geht durch alle Komponenten der ausgewählten Zeichenansicht und gibt
' Name, Layer, Sichtbarkeit, Linienart und Linienstärke aus.
' Vorbedingung: Eine Zeichnung einer Baugruppe ist offen, eine
'               Zeichenansicht ist ausgewählt.
' Ergebnis:     Der Komponentenbaum steht eingerückt im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swView As SldWorks.View
    Dim swWurzel As SldWorks.DrawingComponent

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocDRAWING Then Exit Sub

    Set swSelMgr = swModel.SelectionManager
    If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelDRAWINGVIEWS Then
        Debug.Print "Bitte eine Zeichenansicht auswählen."
        Exit Sub
    End If
    Set swView = swSelMgr.GetSelectedObject6(1, -1)

    Set swWurzel = swView.RootDrawingComponent        ' ab SOLIDWORKS 2026 SP02: RootDrawingComponent2(False)
    If swWurzel Is Nothing Then
        Debug.Print "Die Ansicht hat keine Zeichnungskomponenten."
        Exit Sub
    End If
    Debug.Print "Ansicht " & swView.Name
    Ausgeben swWurzel, "  "
End Sub

Sub Ausgeben(swDrawComp As SldWorks.DrawingComponent, sEinzug As String)
    Dim swKind As SldWorks.DrawingComponent
    Dim vKinder As Variant
    Dim i As Long

    If swDrawComp.IsRoot Then
        Debug.Print sEinzug & "(Wurzel)"
    Else
        Debug.Print sEinzug & swDrawComp.Name & ": Layer """ & swDrawComp.Layer & """" _
            & ", sichtbar " & swDrawComp.Visible _
            & ", Linienart " & swDrawComp.Style & ", Linienstärke " & swDrawComp.Width
    End If

    vKinder = swDrawComp.GetChildren
    If Not IsEmpty(vKinder) Then
        For i = 0 To UBound(vKinder)
            Set swKind = vKinder(i)
            Ausgeben swKind, sEinzug & "  "
        Next i
    End If
End Sub

Bemerkungen

Hilfebeispiele: „Get Components' Properties in Drawing View“ geht wie das Beispiel oben rekursiv durch den Baum und gibt Layer, LayerOverride, Style, Visible und Width aus. „Hide Drawing Components“ blendet so alle Komponenten der ausgewählten Ansicht aus, „Put Assembly Components in Drawing View on Different Layers“ legt für jede Komponente einen Layer an und setzt DrawingComponent.Layer. „Get Components in Drawing View“ setzt für die sichtbaren Kanten jeder Komponente eine eigene Linienart und Linienstärke. Alle holen die Wurzel noch über die veraltete Eigenschaft View.RootDrawingComponent.

Wurzelkomponente: Die Wurzel ist vermutlich die Baugruppe der Ansicht selbst, die Hilfe sagt dazu nur, dass DrawingComponent.IsRoot beim Durchlaufen hilft. Ein Kommentar im Hilfebeispiel sagt, dass DrawingComponent.Visible auf sie nicht wirkt und ihre Component2 leere Namen liefert. Das Beispiel oben gibt für die Wurzel deshalb nur „(Wurzel)“ aus.

Linien der Komponente: DrawingComponent.Style und DrawingComponent.Width gelten für die ganze Komponente, Werte aus swLineStyles_e und swLineWeights_e. Getrennt nach Kantenart aus swDrawingComponentLineFontOption_e (sichtbar, verdeckt, tangential, Schraffur, SpeedPak) setzt du sie mit DrawingComponent.SetLineStyle und DrawingComponent.SetLineThickness. Das Hilfebeispiel schaltet dafür vorher DrawingComponent.UseDocumentDefaults aus. Wie die beiden Wege zusammenspielen, sagt die Hilfe nicht.

Layer: Layer gibt es nur in Zeichnungen. Die Darstellung des Layers gilt, solange DrawingComponent.LayerOverride keine Abweichung meldet. Layer verwaltest du mit dem LayerMgr.

Neu aufbauen: Nach dem Setzen von DrawingComponent.Visible soll die Zeichnung neu aufgebaut werden. Die Hilfe nennt dafür das veraltete ModelDoc2.Rebuild. Heute baust du etwa mit ModelDoc2.EditRebuild3 neu auf.

Die Reihenfolge der Unterkomponenten aus DrawingComponent.GetChildren ist nicht fest und kann sich zwischen zwei Läufen ändern. Verlass dich also nicht auf einen bestimmten Index.

Eigenschaften und Methoden

Eigenschaften 9, davon 9 beschrieben

NameBeschreibung
ComponentLiefert die Komponente der Baugruppe (Component2), auf die sich die Zeichnungskomponente bezieht.
LayerLiest oder setzt den Layer, auf dem die Komponente in der Zeichenansicht liegt.
LayerOverrideLiefert, in welcher Darstellung die Komponente vom Layer abweicht (Farbe, Linienart, Linienstärke), oder setzt sie auf den Layer zurück.
NameLiefert den Namen der Zeichnungskomponente.
StyleLiest oder setzt die Linienart der Komponente in dieser Zeichenansicht.
UseDocumentDefaultsLiest oder setzt, ob für die Linien der Komponente die Vorgaben des Dokuments gelten.
ViewLiefert die Zeichenansicht, in der die Zeichnungskomponente liegt.
VisibleLiest oder setzt, ob die Komponente in dieser Zeichenansicht sichtbar ist.
WidthLiest oder setzt die Linienstärke der Komponente in dieser Zeichenansicht.

Methoden 9, davon 9 beschrieben

NameBeschreibung
DeSelectHebt die Auswahl der Zeichnungskomponente auf.
GetChildrenLiefert die Zeichnungskomponenten direkt unter dieser Zeichnungskomponente.
GetChildrenCountLiefert die Zahl der Zeichnungskomponenten direkt unter dieser Zeichnungskomponente.
GetLineStyleLiefert die Linienart einer Kantenart der Zeichnungskomponente, etwa der sichtbaren oder der verdeckten Kanten.
GetLineThicknessLiefert die Linienstärke einer Kantenart der Zeichnungskomponente und bei eigener Stärke die Dicke.
IsRootLiefert, ob dies die Wurzelkomponente der Zeichenansicht ist.
SelectWählt die Zeichnungskomponente aus, wahlweise zusätzlich zur bisherigen Auswahl.
SetLineStyleSetzt die Linienart einer Kantenart der Zeichnungskomponente, etwa der sichtbaren oder der verdeckten Kanten.
SetLineThicknessSetzt die Linienstärke einer Kantenart der Zeichnungskomponente, als feste Stufe oder als eigene Dicke.

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

Siehe auch

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

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