Objekt · SldWorks
DrawingComponent-Objekt
Eine Komponente in einer Zeichenansicht (Zeichnungskomponente): Sichtbarkeit, Layer, Linienart und Linienstärke der Komponente in dieser Ansicht.
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
View.RootDrawingComponent2: die Wurzelkomponente einer Zeichenansicht, seit SOLIDWORKS 2026 SP02. Davor gab es die heute veraltete Eigenschaft View.RootDrawingComponent ohne Parameter, die die Hilfebeispiele verwenden.DrawingComponent.GetChildren: die Komponenten unter einer ZeichnungskomponenteView.GetVisibleDrawingComponents: die sichtbaren Zeichnungskomponenten einer AnsichtComponent2.GetDrawingComponent: zu einer Komponente der Baugruppe die Zeichnungskomponente in einer AnsichtEntity.GetDrawingComponent: die Zeichnungskomponente, zu der ein Element in einer Zeichenansicht gehörtSelectionMgr.GetSelectedObjectsComponent4: in einer Zeichnung die Zeichnungskomponente einer ausgewählten Komponente
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Component | Liefert die Komponente der Baugruppe (Component2), auf die sich die Zeichnungskomponente bezieht. |
| Layer | Liest oder setzt den Layer, auf dem die Komponente in der Zeichenansicht liegt. |
| LayerOverride | Liefert, in welcher Darstellung die Komponente vom Layer abweicht (Farbe, Linienart, Linienstärke), oder setzt sie auf den Layer zurück. |
| Name | Liefert den Namen der Zeichnungskomponente. |
| Style | Liest oder setzt die Linienart der Komponente in dieser Zeichenansicht. |
| UseDocumentDefaults | Liest oder setzt, ob für die Linien der Komponente die Vorgaben des Dokuments gelten. |
| View | Liefert die Zeichenansicht, in der die Zeichnungskomponente liegt. |
| Visible | Liest oder setzt, ob die Komponente in dieser Zeichenansicht sichtbar ist. |
| Width | Liest oder setzt die Linienstärke der Komponente in dieser Zeichenansicht. |
Methoden 9, davon 9 beschrieben
| Name | Beschreibung |
|---|---|
| DeSelect | Hebt die Auswahl der Zeichnungskomponente auf. |
| GetChildren | Liefert die Zeichnungskomponenten direkt unter dieser Zeichnungskomponente. |
| GetChildrenCount | Liefert die Zahl der Zeichnungskomponenten direkt unter dieser Zeichnungskomponente. |
| GetLineStyle | Liefert die Linienart einer Kantenart der Zeichnungskomponente, etwa der sichtbaren oder der verdeckten Kanten. |
| GetLineThickness | Liefert die Linienstärke einer Kantenart der Zeichnungskomponente und bei eigener Stärke die Dicke. |
| IsRoot | Liefert, ob dies die Wurzelkomponente der Zeichenansicht ist. |
| Select | Wählt die Zeichnungskomponente aus, wahlweise zusätzlich zur bisherigen Auswahl. |
| SetLineStyle | Setzt die Linienart einer Kantenart der Zeichnungskomponente, etwa der sichtbaren oder der verdeckten Kanten. |
| SetLineThickness | Setzt 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.