Objekt · SldWorks
Layer-Objekt
Ein Layer einer Zeichnung: Name, Beschreibung, Farbe, Linienart, Linienstärke, ob er sichtbar ist und gedruckt wird, und die Elemente darauf.
Beschreibung
Layer gibt Zugriff auf die Eigenschaften eines Layers und auf die Elemente, die darauf liegen. Layer gibt es nur in Zeichnungen. Jede Zeichnung hat ihre eigenen Layer, verwaltet werden sie vom Layer-Manager (LayerMgr). Die meisten Befehle gibt es seit SOLIDWORKS 99.
Zugriff
LayerMgr.GetLayer: der Layer mit einem bestimmten NamenLayerMgr.GetLayerById: der Layer mit einer bestimmten ID, etwa ausAnnotation.GetVisualPropertiesoderView.GetLines4
Den Layer-Manager liefert ModelDoc2.GetLayerManager. Einen neuen Layer legst du mit DrawingDoc.CreateLayer2 oder LayerMgr.AddLayer an.
Beispiel
' Gibt für jeden Layer der aktiven Zeichnung Name, Beschreibung, ID, Farbe,
' Linienart, Linienstärke, Sichtbarkeit, Druck und die Zahl der Beschriftungen aus.
' Vorbedingung: Eine Zeichnung ist offen.
' Ergebnis: Die Werte stehen im Direktfenster (Strg+G).
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swLayerMgr As SldWorks.LayerMgr
Dim swLayer As SldWorks.Layer
Dim vNamen As Variant
Dim vElemente As Variant
Dim nFarbe As Long
Dim i 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 swLayerMgr = swModel.GetLayerManager
vNamen = swLayerMgr.GetLayerList
If IsEmpty(vNamen) Then Exit Sub
For i = 0 To UBound(vNamen)
Set swLayer = swLayerMgr.GetLayer(vNamen(i))
nFarbe = swLayer.Color
Debug.Print swLayer.Name & " (" & swLayer.Description & "), ID " & swLayer.GetID
Debug.Print " Farbe RGB(" & (nFarbe And &HFF) & ", " & ((nFarbe \ &H100) And &HFF) & ", " & _
((nFarbe \ &H10000) And &HFF) & "), Linienart " & swLayer.Style & _
", Linienstärke " & swLayer.Width
Debug.Print " sichtbar " & swLayer.Visible & ", druckbar " & swLayer.Printable
vElemente = swLayer.GetItems(swLayerItemsOption_Annotations)
If Not IsEmpty(vElemente) Then Debug.Print " " & UBound(vElemente) + 1 & " Beschriftungen"
Next i
End SubBemerkungen
Hilfebeispiele: „Get Layers“ holt den Layer-Manager, gibt den aktuellen Layer aus und dann für jeden Namen aus LayerMgr.GetLayerList Name, Farbe, Beschreibung, ID, Linienart, Sichtbarkeit, Linienstärke und Druck. „Determine if Layer is Visible“ legt mit DrawingDoc.CreateLayer2 einen Layer an, legt die Komponente der ausgewählten Ansicht mit DrawingDoc.ChangeComponentLayer darauf und liest dann Layer.Visible.
Sichtbar und druckbar: Layer.Visible kann den Wert von Layer.Printable ändern, und ein unsichtbarer Layer lässt sich nicht druckbar machen. Setz deshalb erst Visible, lies dann Printable und setz es bei Bedarf.
Abweichende Darstellung: Farbe, Linienart und Linienstärke eines Layers gelten für die Elemente darauf, solange ein Element nicht selbst abweicht. Ob eine Beschriftung abweicht, liefert Annotation.LayerOverride. Auf welchem Layer sie liegt, liest und setzt du mit Annotation.Layer über den Namen.
Änderungen: Ob Änderungen an einem Layer sofort im Grafikbereich erscheinen oder erst nach einem Neuzeichnen, sagt die Hilfe nicht.
Eigenschaften und Methoden
Eigenschaften 7, davon 7 beschrieben
| Name | Beschreibung |
|---|---|
| Color | Liest oder setzt die Linienfarbe des Layers. |
| Description | Liest oder setzt die Beschreibung des Layers. |
| Name | Liest oder setzt den Namen des Layers. |
| Printable | Liest oder setzt, ob der Layer beim Drucken der Zeichnung mitgedruckt wird. |
| Style | Liest oder setzt die Linienart des Layers. |
| Visible | Liest oder setzt, ob der Layer angezeigt wird. |
| Width | Liest oder setzt die Linienstärke des Layers. |
Methoden 2, davon 2 beschrieben
Siehe auch
Englisches Original: ILayer in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.