SolidWorksMakroprogrammierung

Methode · DrawingDoc

CreateLayer2-Methode (DrawingDoc)

Legt in der Zeichnung einen neuen Layer mit Farbe, Linienart, Linienstärke, Sichtbarkeit und Druckeinstellung an.

Syntax

Function CreateLayer2( _
   ByVal Layername As String, _
   ByVal LayerDesc As String, _
   ByVal LayerColor As Long, _
   ByVal LayerStyle As Long, _
   ByVal LayerWidth As Long, _
   ByVal BOn As Boolean, _
   ByVal BPrint As Boolean _
) As Boolean
bErfolg = swDraw.CreateLayer2("Hilfslinien", "Hilfslinien in Blau", RGB(0, 0, 255), swLineHIDDEN, swLW_THIN, True, False)

Parameter

LayernameStringByVal
Name des neuen Layers. Er darf keinen Backslash (\) und kein @ enthalten (siehe Bemerkungen).
LayerDescStringByVal
Beschreibung des Layers.
LayerColorLongByVal
Farbe der Elemente auf diesem Layer als COLORREF-Wert. In VBA bildest du ihn mit RGB(rot, grün, blau), etwa RGB(0, 0, 255) für Blau. 0 ist Schwarz.
LayerStyleLongByVal

Linienart als swLineStyles_e, zum Beispiel:

  • swLineCONTINUOUS (0): durchgezogen
  • swLineHIDDEN (1): gestrichelt
  • swLinePHANTOM (2), swLineCHAIN (3), swLineCENTER (4), swLineSTITCH (5), swLineCHAINTHICK (6)
  • swLineDEFAULT (7)
LayerWidthLongByVal

Linienstärke als swLineWeights_e, zum Beispiel:

  • swLW_THIN (0): dünn
  • swLW_NORMAL (1): normal
  • swLW_THICK (2): dick, swLW_THICK2 (3) bis swLW_THICK6 (7): noch dicker
  • Die Enumeration enthält weitere Werte wie swLW_LAYER (9) oder swLW_CUSTOM (10). Welche davon bei einem Layer sinnvoll sind, sagt die Hilfe nicht.
BOnBooleanByVal
True macht den Layer sichtbar, False blendet ihn aus.
BPrintBooleanByVal
True, wenn der Layer beim Drucken der Zeichnung mitgedruckt werden soll, sonst False.

Rückgabewert

True, wenn der Layer angelegt wurde, sonst False.

Beispiel

' swModel ist die aktive Zeichnung (ModelDoc2), swDraw dasselbe Dokument als DrawingDoc.
Dim swLayerMgr As SldWorks.LayerMgr
Dim swLayer As SldWorks.Layer
Dim bErfolg As Boolean
bErfolg = swDraw.CreateLayer2("Hilfslinien", "Hilfslinien in Blau", RGB(0, 0, 255), _
    swLineHIDDEN, swLW_THIN, True, False)
If False = bErfolg Then
    Debug.Print "Der Layer wurde nicht angelegt."
Else
    ' Alles, was danach entsteht, landet auf diesem Layer
    bErfolg = swDraw.SetCurrentLayer("Hilfslinien")
    Set swLayerMgr = swModel.GetLayerManager
    Set swLayer = swLayerMgr.GetLayer("Hilfslinien")
    Debug.Print swLayer.Name & ": " & swLayer.Description & _
        ", sichtbar " & swLayer.Visible & ", druckbar " & swLayer.Printable
End If

Bemerkungen

Ist der Layer unsichtbar (BOn = False), zeigt SOLIDWORKS die Elemente auf diesem Layer nicht an.

Zum Namen: Die Hilfe verbietet Backslash und @. Auf der Seite des Vorgängers steht dabei „backslash (/)“, gemeint ist dort also der Schrägstrich. Lass im Zweifel \, / und @ weg.

Ob der neue Layer danach der aktuelle Layer ist, sagt die Hilfe nicht. Mit DrawingDoc.SetCurrentLayer machst du ihn ausdrücklich zum aktuellen Layer, alle folgenden Elemente entstehen dann auf ihm. Wann der Befehl False liefert, etwa bei einem schon vorhandenen Namen, beschreibt die Hilfe ebenfalls nicht.

Ersetzt DrawingDoc.CreateLayer, neu ist der Parameter BPrint. Einen vorhandenen Layer holst du mit LayerMgr.GetLayer und änderst ihn über die Eigenschaften von Layer. Den LayerMgr liefert ModelDoc2.GetLayerManager.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2015

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

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