SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.Layer · in der englischen .NET-Hilfe: ILayer

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

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 Sub

Bemerkungen

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

NameBeschreibung
ColorLiest oder setzt die Linienfarbe des Layers.
DescriptionLiest oder setzt die Beschreibung des Layers.
NameLiest oder setzt den Namen des Layers.
PrintableLiest oder setzt, ob der Layer beim Drucken der Zeichnung mitgedruckt wird.
StyleLiest oder setzt die Linienart des Layers.
VisibleLiest oder setzt, ob der Layer angezeigt wird.
WidthLiest oder setzt die Linienstärke des Layers.

Methoden 2, davon 2 beschrieben

NameBeschreibung
GetIDLiefert die ID des Layers, die in der Zeichnung eindeutig ist und sich nie ändert.
GetItemsLiefert die Elemente einer Art, die auf dem Layer liegen, etwa die Beschriftungen oder Skizzensegmente.

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.