SolidWorksMakroprogrammierung

Methode · View

GetUserPoints2-Methode (View)

Liefert Darstellung und Lage aller vom Benutzer gesetzten Punkte in der Zeichenansicht als Zahlen-Array.

Syntax

Function GetUserPoints2() As Variant
vPunkte = swView.GetUserPoints2

Rückgabewert

Ein Array mit acht Double-Werten pro Punkt, insgesamt also Anzahl * 8 Werte:

  • Index 0, Color: die Farbe als Zahl, 0 oder -1 für die Standardfarbe
  • Index 1, LineStyleIndex: Linienart aus swLineStyles_e, zum Beispiel swLineCONTINUOUS (0) durchgezogen
  • Index 2, LineWidth: Linienstärke aus swLineWeights_e, zum Beispiel swLW_THIN (0) oder swLW_NORMAL (1)
  • Index 3, LayerID: die Nummer des Layers, das Objekt dazu liefert LayerMgr.GetLayerById
  • Index 4, LayerOverride: welche Eigenschaften vom Layer abweichen, Bits aus swLayerOverride_e: 1 Farbe, 2 Linienart, 4 Linienstärke
  • Index 5 bis 7: X, Y, Z des Punkts

Danach folgt der nächste Punkt. Die Anzahl der Punkte liefert View.GetUserPointsCount.

Beispiel

' swModel ist die aktive Zeichnung (ModelDoc2), swView eine Zeichenansicht (View) darin.
Dim swLayerMgr As SldWorks.LayerMgr
Dim swLayer As SldWorks.Layer
Dim vPunkte As Variant
Dim sZeile As String
Dim i As Long, n As Long
If swView.GetUserPointsCount > 0 Then
    Set swLayerMgr = swModel.GetLayerManager
    vPunkte = swView.GetUserPoints2
    For i = 0 To swView.GetUserPointsCount - 1
        n = i * 8
        sZeile = "Punkt " & i + 1 & ": " & Format(vPunkte(n + 5) * 1000, "0.00") & " / " & Format(vPunkte(n + 6) * 1000, "0.00") & " mm"
        Set swLayer = swLayerMgr.GetLayerById(CInt(vPunkte(n + 3)))
        If Not swLayer Is Nothing Then sZeile = sZeile & ", Layer " & swLayer.Name
        Debug.Print sZeile
    Next i
End If

Bemerkungen

Die Koordinaten beziehen sich auf die Ansicht, nicht auf das Blatt. Für Blattkoordinaten (Ursprung links unten auf dem Blatt) kombinierst du sie mit den drei Werten von View.GetXform, also Lage X, Y der Ansicht und ihrem Maßstab. Die genaue Rechnung und die Einheit nennt die Hilfe nicht. Das Beispiel nimmt Meter an, wie sonst in der API.

Das Blatt muss sichtbar sein. Sie verweist dazu auf Sheet.SheetFormatVisible.

Was mit „Punkten des Benutzers“ genau gemeint ist, erklärt die Hilfe nicht. Dem Namen nach sind es Punkte, die jemand in der Ansicht gesetzt hat, nicht Ecken des Modells.

Ersetzt View.GetUserPoints.

Siehe auch

Verfügbarkeit

SOLIDWORKS 99

Englisches Original: IView::GetUserPoints2 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.