Methode · View
GetPolylines7-Methode (View)
Liefert die Kanten einer Zeichenansicht als Polyliniendaten und dazu die Modellkanten, wahlweise mit, ohne oder nur mit Schraffurlinien.
Syntax
Function GetPolylines7( _
ByVal CrossHatchOption As Integer, _
ByRef Polylines As Variant _
) As VariantvKanten = swView.GetPolylines7(swCrossHatchExclude, vDaten)Parameter
CrossHatchOptionIntegerByValLegt fest, welche Schraffurlinien geliefert werden. Die Hilfe nennt die Zahlen 0 bis 2, sie entsprechen den Werten aus
swCrossHatchFilter_e:swCrossHatchInclude(0): mit SchraffurlinienswCrossHatchExclude(1): ohne SchraffurlinienswCrossHatchOnly(2): nur Schraffurlinien
PolylinesVariantByRef · RückgabeSOLIDWORKS schreibt ein Array von
Double-Werten mit den Linien der Ansicht hinein. Für jede Linie folgen hintereinander:- Typ: 0 Polylinie, 1 Bogen oder Kreis
- Anzahl der folgenden Geometriewerte: bei Typ 0 ist sie 0, bei Typ 1 sind es 12
- Geometriewerte, nur bei Typ 1: Mittelpunkt, Startpunkt, Endpunkt und Normale, je x, y, z
- sechs Linienattribute: Farbe, Linienstil, Linienart, Linienstärke, Layer-ID, Layer-Bitmaske (siehe Bemerkungen)
- Anzahl der Punkte der Polylinie
- die Punkte, je x, y, z
Die Punkte gibt es bei jedem Typ, auch bei Bögen. Eine Einheit nennt die Hilfe nicht. Vermutlich sind es Meter. Ob die Punkte in Koordinaten der Ansicht oder des Blatts angegeben sind, sagt die Hilfe nicht.
Rückgabewert
Array mit den Modellkanten (Edge), die zu den Polylinien gehören. Die Einträge entsprechen den Polylinien in derselben Reihenfolge. Für Silhouettenkanten gibt es keine echte Kante. Die Bemerkungen der Hilfe geben den Eintrag dann als leer (Null) an. An anderer Stelle nennt die Hilfe für diese Einträge Silhouettenkanten (SilhouetteEdge). Was wirklich drinsteht, prüfst du am besten im eigenen Modell.
Beispiel
' swView ist eine Zeichenansicht (View), etwa aus DrawingDoc.ActiveDrawingView oder der Auswahl.
Dim vKanten As Variant
Dim vDaten As Variant
Dim lIdx As Long
Dim lGeom As Long
Dim lPunkte As Long
Dim lBoegen As Long
Dim lPolylinien As Long
vKanten = swView.GetPolylines7(swCrossHatchExclude, vDaten)
If IsEmpty(vDaten) Then
Debug.Print "Keine Daten. Ist die Ansicht schattiert?"
Else
Do While lIdx <= UBound(vDaten)
If vDaten(lIdx) = 1 Then
lBoegen = lBoegen + 1
Debug.Print "Bogen um " & Format(vDaten(lIdx + 2) * 1000, "0.00") & " / " & Format(vDaten(lIdx + 3) * 1000, "0.00") & " mm"
Else
lPolylinien = lPolylinien + 1
End If
lGeom = vDaten(lIdx + 1)
lPunkte = vDaten(lIdx + 2 + lGeom + 6)
' weiter zur nächsten Linie: Kopf, Geometrie, Attribute, Punktzahl, Punkte
lIdx = lIdx + 2 + lGeom + 6 + 1 + lPunkte * 3
Loop
Debug.Print lBoegen & " Bögen oder Kreise, " & lPolylinien & " Polylinien"
If Not IsEmpty(vKanten) Then Debug.Print UBound(vKanten) - LBound(vKanten) + 1 & " Einträge im Kanten-Array"
End IfBemerkungen
Welche Kanten wie geliefert werden: Alle sichtbaren Kanten des Modells in der Ansicht kommen. Bögen und Kreise haben Typ 1 und zusätzlich Mittelpunkt, Start- und Endpunkt. Ellipsen und Splines kommen als angenäherte Polylinien, gerade Kanten ebenfalls, dort ohne Genauigkeitsverlust. Genaue Kurvenparameter für Ellipsen und Splines liefert View.GetPolyLinesAndCurves. Linien, die ein Benutzer in der Ansicht skizziert hat, sind nicht dabei. Die holst du mit View.GetArcs4, View.GetLines4, View.GetSplines3 und View.GetEllipses5.
Die sechs Linienattribute:
- Farbe: entweder direkt eingestellt oder vom Layer.
- Linienstil: kombiniert Linienart und Linienstärke. Zum Auswerten nennt die Hilfe die veralteten
DrawingDoc.GetLineFontInfoundDrawingDoc.GetLineFontName. Der Wert -1 heißt, die Darstellung wurde vermutlich von Hand geändert. Dann gelten die beiden nächsten Werte. - Linienart: lässt sich an
DrawingDoc.GetLineFontInfo2undDrawingDoc.GetLineFontName2übergeben. Nur gültig, wenn der Linienstil -1 ist. - Linienstärke: 0 dünn, 1 normal, 2 dick. Nur gültig, wenn der Linienstil -1 ist.
- Layer-ID: den
Layerdazu liefertLayerMgr.GetLayerById. - Layer-Bitmaske: 1 Farbe, 2 Linienart, 4 Linienstärke weichen vom Layer ab. Der Wert 3 heißt also: Farbe und Linienart sind abweichend eingestellt.
Anzeigemodus: Ist die Ansicht schattiert, schattiert mit Kanten, in Entwurfsqualität oder in schneller HLR/HLV-Darstellung, kommen keine Daten. Stell die Ansicht vorher auf Drahtgitter, verdeckte Kanten entfernt oder verdeckte Kanten sichtbar um. Die Hilfe nennt dafür SetDisplayMode3, aktuell ist View.SetDisplayMode4. In welcher Form "keine Daten" zurückkommt, sagt die Hilfe nicht. Das Beispiel prüft deshalb mit IsEmpty.
Wurden die Teile oder Baugruppen der Zeichnung geändert, erzeugt SOLIDWORKS beim Öffnen nur die Polylinien im sichtbaren Bereich. Mit ModelDoc2.ViewZoomtofit2 erzwingst du, dass alle Polylinien erzeugt werden.
Die Größe des Datenarrays liefert View.GetPolyLineCount5. Ersetzt View.GetPolylines6.
Die Punkte kommen in Metern und beziehen sich nicht auf das Blatt: Die Lage der Ansicht auf dem Blatt steckt nicht darin.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2008
Englisches Original: IView::GetPolylines7 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.