Methode · View
GetDatumPoints2-Methode (View)
Liefert Lage, Farbe, Linienart, Linienstärke und Layer aller Bezugspunkte (datum points) einer Zeichenansicht in einem Array.
Syntax
Function GetDatumPoints2() As VariantvDaten = swView.GetDatumPoints2Rückgabewert
Array mit Double-Werten, je Punkt acht Stück hintereinander. Das Array hat also 8 * Anzahl der Punkte Einträge. Für den Punkt mit der Nummer i (ab 0) beginnt der Block bei Index 8 * i:
+0: Farbe als Zahl (COLORREF, wie sie die VBA-FunktionRGBliefert).0oder-1stehen für die Standardfarbe.+1: Linienart. Die Hilfe nennt im TextswLineStyles_e, verweist aber aufswLineTypes_e. Welche Liste gilt, bleibt offen.+2: Linienstärke, ein Wert ausswLineWeights_e, etwaswLW_THIN(0) oderswLW_NORMAL(1).+3: Layer, als Index in die Liste vonLayerMgr.GetLayerList. Der Wert1heißt, dass der Punkt auf keinem Layer liegt.+4: welche Eigenschaften vom Layer abweichen, als Bitmaske:1Farbe,2Linienart,4Linienstärke.3heißt also: Farbe und Linienart sind eigens gesetzt. Dieselben Werte hat die EnumerationswLayerOverride_e, die Hilfe nennt sie hier aber nicht.+5bis+7: X, Y und Z des Punkts.
Beispiel
' swView ist eine Zeichenansicht (View), etwa aus DrawingDoc.ActiveDrawingView oder der Auswahl.
Dim vDaten As Variant
Dim lAnzahl As Long, i As Long, j As Long
lAnzahl = swView.GetDatumPointsCount
If lAnzahl > 0 Then
vDaten = swView.GetDatumPoints2
For i = 0 To lAnzahl - 1
j = 8 * i
Debug.Print "Punkt " & i + 1 & ": " & Format(vDaten(j + 5) * 1000, "0.00") & " / " & _
Format(vDaten(j + 6) * 1000, "0.00") & " / " & Format(vDaten(j + 7) * 1000, "0.00") & " mm"
If CLng(vDaten(j + 4)) And swLayerOverrideColor Then Debug.Print " eigene Farbe statt Layerfarbe"
Next i
End IfBemerkungen
Koordinaten: Die Werte beziehen sich auf die Zeichenansicht, nicht auf das Blatt. Für Blattkoordinaten (Ursprung in der linken unteren Ecke des Blatts) sollst du sie mit den drei Werten von View.GetXform verrechnen: Lage der Ansicht auf dem Blatt und Maßstab. Eine fertige Formel nennt die Hilfe nicht. Eine Einheit nennt sie auch nicht, das Beispiel geht wie sonst in der API von Metern aus.
Was ein Bezugspunkt ist: Die Hilfe erklärt nicht, welche Punkte als datum points zählen. Dem Namen nach sind es Referenzpunkte des Modells, die in der Ansicht zu sehen sind. Probier es im eigenen Modell aus, bevor du dich darauf verlässt.
Layer: Dass 1 für „kein Layer“ stehen soll, passt schlecht zu einem Index, der bei 0 beginnt. Prüf den Wert im eigenen Modell.
Die Anzahl der Punkte liefert View.GetDatumPointsCount. Ersetzt View.GetDatumPoints. Genauso aufgebaut ist das Array von View.GetUserPoints2 (user points).
Siehe auch
Verfügbarkeit
SOLIDWORKS 99
Englisches Original: IView::GetDatumPoints2 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.