SolidWorksMakroprogrammierung

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 Variant
vDaten = swView.GetDatumPoints2

Rü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-Funktion RGB liefert). 0 oder -1 stehen für die Standardfarbe.
  • +1: Linienart. Die Hilfe nennt im Text swLineStyles_e, verweist aber auf swLineTypes_e. Welche Liste gilt, bleibt offen.
  • +2: Linienstärke, ein Wert aus swLineWeights_e, etwa swLW_THIN (0) oder swLW_NORMAL (1).
  • +3: Layer, als Index in die Liste von LayerMgr.GetLayerList. Der Wert 1 heißt, dass der Punkt auf keinem Layer liegt.
  • +4: welche Eigenschaften vom Layer abweichen, als Bitmaske: 1 Farbe, 2 Linienart, 4 Linienstärke. 3 heißt also: Farbe und Linienart sind eigens gesetzt. Dieselben Werte hat die Enumeration swLayerOverride_e, die Hilfe nennt sie hier aber nicht.
  • +5 bis +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 If

Bemerkungen

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.