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 BooleanbErfolg = 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), etwaRGB(0, 0, 255)für Blau.0ist Schwarz. LayerStyleLongByValLinienart als
swLineStyles_e, zum Beispiel:swLineCONTINUOUS(0): durchgezogenswLineHIDDEN(1): gestricheltswLinePHANTOM(2),swLineCHAIN(3),swLineCENTER(4),swLineSTITCH(5),swLineCHAINTHICK(6)swLineDEFAULT(7)
LayerWidthLongByValLinienstärke als
swLineWeights_e, zum Beispiel:swLW_THIN(0): dünnswLW_NORMAL(1): normalswLW_THICK(2): dick,swLW_THICK2(3) bisswLW_THICK6(7): noch dicker- Die Enumeration enthält weitere Werte wie
swLW_LAYER(9) oderswLW_CUSTOM(10). Welche davon bei einem Layer sinnvoll sind, sagt die Hilfe nicht.
BOnBooleanByValTruemacht den Layer sichtbar,Falseblendet ihn aus.BPrintBooleanByValTrue, wenn der Layer beim Drucken der Zeichnung mitgedruckt werden soll, sonstFalse.
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 IfBemerkungen
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.