Methode · View
GetLines4-Methode (View)
Liefert die Daten aller Linien, die in einer Zeichenansicht skizziert wurden, wahlweise mit oder ohne Schraffurlinien.
Syntax
Function GetLines4( _
ByVal CrossHatchOption As Integer _
) As VariantvDaten = swView.GetLines4(swCrossHatchExclude)Parameter
CrossHatchOptionIntegerByValLegt fest, wie Schraffurlinien behandelt werden, als Wert aus
swCrossHatchFilter_e. Die Hilfe beschreibt die Werte nicht einzeln, die Bedeutung folgt aus den Namen:swCrossHatchInclude(0): mit SchraffurlinienswCrossHatchExclude(1): ohne SchraffurlinienswCrossHatchOnly(2): nur SchraffurlinienswCrossHatchAndExplodeOnly(3) undswSolidHatchOnly(4): Was genau sie bewirken, erklärt die Hilfe nicht.
Rückgabewert
Array von Double-Werten mit 12 Werten je Linie, insgesamt also Anzahl der Linien mal 12. Die erste Linie steht an Index 0 bis 11, die zweite an 12 bis 23 und so weiter. Innerhalb einer Linie:
- 0: Farbe als COLORREF-Zahl. 0 oder -1 bedeutet Standardfarbe.
- 1: Linientyp aus
swLineTypes_e, eine Kombination aus Linienart und Linienstärke, zum BeispielswLF_SKETCH(2). - 2: Linienart aus
swLineStyles_e, zum BeispielswLineCONTINUOUS(0) oderswLineHIDDEN(1). - 3: Linienstärke aus
swLineWeights_e, zum BeispielswLW_THIN(0) oderswLW_NORMAL(1). - 4: ID des Layers. Den
Layerdazu bekommst du mitLayerMgr.GetLayerById. - 5: Bitmaske, welche Eigenschaften gegenüber dem Layer abweichend eingestellt sind: 1 Farbe, 2 Linienart, 4 Linienstärke. Der Wert 3 heißt also: Farbe und Linienart weichen vom Layer ab.
- 6 bis 8: Startpunkt (x, y, z).
- 9 bis 11: Endpunkt (x, y, z).
Die Punkte sind Koordinaten im Raum der Ansicht, nicht auf dem Blatt (siehe Bemerkungen). Eine Einheit nennt die Hilfe nicht. Vermutlich sind es wie sonst in der API Meter.
Beispiel
' swView ist eine Zeichenansicht (View), etwa aus DrawingDoc.ActiveDrawingView oder der Auswahl.
Dim vDaten As Variant
Dim lAnzahl As Long
Dim lStart As Long
Dim i As Long
Dim dLaenge As Double
lAnzahl = swView.GetLineCount2(swCrossHatchExclude)
If lAnzahl > 0 Then
vDaten = swView.GetLines4(swCrossHatchExclude)
For i = 0 To lAnzahl - 1
lStart = i * 12
dLaenge = Sqr((vDaten(lStart + 9) - vDaten(lStart + 6)) ^ 2 + (vDaten(lStart + 10) - vDaten(lStart + 7)) ^ 2 + (vDaten(lStart + 11) - vDaten(lStart + 8)) ^ 2)
Debug.Print "Linie " & i + 1 & ": Layer-ID " & vDaten(lStart + 4) & ", Länge " & Format(dLaenge * 1000, "0.00") & " mm"
If vDaten(lStart + 2) = swLineHIDDEN Then Debug.Print " gestrichelt"
Next i
End IfBemerkungen
GetLines4 liefert nur Linien, die in dieser Zeichenansicht skizziert wurden. Die Kanten des Modells, die in der Ansicht zu sehen sind, holst du mit View.GetPolylines7. Die Hilfe nennt dafür noch den veralteten Vorgänger GetPolylines6.
Die Anzahl der Linien liefert View.GetLineCount2. Übergib dort dieselbe Option für Schraffurlinien, sonst passt die Anzahl nicht zum Array.
Die Koordinaten beziehen sich auf die Ansicht. Willst du Blattkoordinaten (Ursprung in der linken unteren Ecke des Blatts), kombinierst du sie mit den drei Werten von View.GetXform: Lage der Ansicht auf dem Blatt (x, y) und Maßstab der Ansicht. Wie genau die Umrechnung aussieht, beschreibt die Hilfe nicht. Das Beispiel rechnet deshalb nur mit den Werten der Ansicht.
Das Blatt muss sichtbar sein. Sie verweist dazu auf Sheet.SheetFormatVisible, was eigentlich das Blattformat betrifft. Was hier genau gemeint ist, bleibt offen.
Ersetzt View.GetLines3, das noch keine Option für Schraffurlinien hatte.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2003
Englisches Original: IView::GetLines4 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.