SolidWorksMakroprogrammierung

Methode · LayerMgr

AddLayer-Methode (LayerMgr)

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

Syntax

Function AddLayer( _
   ByVal NameIn As String, _
   ByVal DescIn As String, _
   ByVal ColorIn As Long, _
   ByVal StyleIn As Long, _
   ByVal WidthIn As Long _
) As Integer
nErgebnis = swLayerMgr.AddLayer("Hilfslinien", "Hilfslinien in Blau", RGB(0, 0, 255), swLineHIDDEN, swLW_THIN)

Parameter

NameInStringByVal
Der Name des neuen Layers.
DescInStringByVal
Die Beschreibung des Layers.
ColorInLongByVal
Die Farbe der Elemente auf dem Layer als COLORREF-Wert. In VBA bildest du ihn mit RGB(Rot, Grün, Blau), 0 ist Schwarz.
StyleInLongByVal
Die Linienart als Wert aus swLineStyles_e, etwa swLineCONTINUOUS (durchgezogen) oder swLineHIDDEN (gestrichelt).
WidthInLongByVal
Die Linienstärke als Wert aus swLineWeights_e, etwa swLW_THIN, swLW_NORMAL oder swLW_THICK.

Rückgabewert

1, wenn der Layer angelegt wurde. Welche Werte sonst kommen, sagt die Hilfe nicht.

Beispiel

' swLayerMgr ist der Layer-Manager der Zeichnung (LayerMgr), etwa aus ModelDoc2.GetLayerManager.
If swLayerMgr.AddLayer("Hilfslinien", "Hilfslinien in Blau", RGB(0, 0, 255), _
                       swLineHIDDEN, swLW_THIN) = 1 Then
    swLayerMgr.SetCurrentLayer "Hilfslinien"
Else
    Debug.Print "Layer nicht angelegt"
End If

Bemerkungen

Ob der neue Layer sichtbar ist und gedruckt wird, kannst du hier nicht angeben. Das geht danach mit Layer.Visible und Layer.Printable oder gleich beim Anlegen mit DrawingDoc.CreateLayer2.

Was bei einem schon vorhandenen Namen geschieht, welche Zeichen der Name enthalten darf und ob der neue Layer danach der aktuelle ist, sagt die Hilfe nicht. Bei DrawingDoc.CreateLayer2 verbietet sie im Namen Backslash und @.

Siehe auch

Verfügbarkeit

SOLIDWORKS 99

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

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