SolidWorksMakroprogrammierung

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 Variant
vDaten = swView.GetLines4(swCrossHatchExclude)

Parameter

CrossHatchOptionIntegerByVal

Legt 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 Schraffurlinien
  • swCrossHatchExclude (1): ohne Schraffurlinien
  • swCrossHatchOnly (2): nur Schraffurlinien
  • swCrossHatchAndExplodeOnly (3) und swSolidHatchOnly (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 Beispiel swLF_SKETCH (2).
  • 2: Linienart aus swLineStyles_e, zum Beispiel swLineCONTINUOUS (0) oder swLineHIDDEN (1).
  • 3: Linienstärke aus swLineWeights_e, zum Beispiel swLW_THIN (0) oder swLW_NORMAL (1).
  • 4: ID des Layers. Den Layer dazu bekommst du mit LayerMgr.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 If

Bemerkungen

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.