SolidWorksMakroprogrammierung

Objekt · SldWorks

RevisionCloud-Objekt

Eine Revisionswolke in einer Zeichnung: Form, Bogenradius, Drehwinkel und die Punkte ihres Pfads.

Deklaration Dim x As SldWorks.RevisionCloud · in der englischen .NET-Hilfe: IRevisionCloud

Beschreibung

RevisionCloud gibt Zugriff auf eine Revisionswolke, eine Beschriftung in Wolkenform, mit der du Änderungen in einer Zeichnung markierst. Die Wolke hat eine Form (Ellipse, Rechteck, Polygon oder Freihand), einen Bogenradius und einen Pfad aus Punkten. Die Befehle gibt es seit SOLIDWORKS 2013.

Zugriff

Beispiel

' Fügt in die aktive Zeichenansicht eine Revisionswolke in Form eines Dreiecks ein
' und gibt danach die Punkte ihres Pfads aus.
' Vorbedingung: Eine Zeichnung ist offen, eine Zeichenansicht ist aktiv.
' Ergebnis:     Die Zeichnung hat eine neue Revisionswolke, die Punkte stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swDraw As SldWorks.DrawingDoc
    Dim swWolke As SldWorks.RevisionCloud
    Dim swAnn As SldWorks.Annotation
    Dim vPunkt As Variant
    Dim bErfolg As Boolean
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocDRAWING Then Exit Sub
    Set swDraw = swModel                                   ' dasselbe Dokument als DrawingDoc

    Set swWolke = swDraw.InsertRevisionCloud(swRevisionCloudShape_Polygon)
    If swWolke Is Nothing Then Exit Sub
    Set swAnn = swWolke.GetAnnotation
    bErfolg = swAnn.SetPosition2(0.1, 0.1, 0)              ' Bezugspunkt = erster Punkt
    swWolke.ArcRadius = 0.005

    ' Polygon mit 3 Seiten: 3 + 1 Punkte, der erste und der letzte auf dem Bezugspunkt
    bErfolg = swWolke.SetPathPointAtIndex(-1, 0.1, 0.1, 0)
    bErfolg = swWolke.SetPathPointAtIndex(-1, 0.18, 0.1, 0)
    bErfolg = swWolke.SetPathPointAtIndex(-1, 0.14, 0.16, 0)
    bErfolg = swWolke.SetPathPointAtIndex(-1, 0.1, 0.1, 0)
    If False = swWolke.Finalize Then Debug.Print "Pfad nicht geschlossen"

    For i = 0 To swWolke.GetPathPointCount - 1
        vPunkt = swWolke.GetPathPointAtIndex(i)
        Debug.Print "Punkt " & i & ": " & vPunkt(0) * 1000 & ", " & vPunkt(1) * 1000 & " mm"
    Next i
End Sub

Bemerkungen

Anlegen: Nach DrawingDoc.InsertRevisionCloud gehst du so vor: Mit RevisionCloud.GetAnnotation die Beschriftung holen und mit Annotation.SetPosition2 den Bezugspunkt setzen. Die Hilfe nennt noch das veraltete Annotation.SetPosition. Ohne diesen Schritt beginnt die Wolke im Ursprung (0, 0, 0). Dann RevisionCloud.ArcRadius setzen, mit RevisionCloud.SetPathPointAtIndex und Index = -1 die Punkte anhängen und zuletzt RevisionCloud.Finalize aufrufen. Danach kannst du keine Punkte mehr anhängen, vorhandene aber jederzeit verschieben.

Punkte je Form: Der Bezugspunkt ist bei der Ellipse der Mittelpunkt, beim Rechteck eine Ecke, bei Polygon und Freihand einer der Punkte der Wolke. Mit SetPathPointAtIndex hängst du an:

  • Ellipse: einmal eine Ecke des Rechtecks, in das die Ellipse passt
  • Rechteck: einmal die Ecke gegenüber dem Bezugspunkt
  • Polygon: (Anzahl der Seiten + 1) Mal, der erste und der letzte Punkt liegen auf dem Bezugspunkt
  • Freihand: beliebig oft, der erste und der letzte Punkt liegen auf dem Bezugspunkt

Einheiten: Den Drehwinkel gibt die Hilfe in Bogenmaß an. Für Bogenradius und Punkte nennt sie keine Einheit, vermutlich sind es Meter. Das Hilfebeispiel „Insert Revision Cloud into a Drawing“ setzt den Bogenradius auf 0.00508, also 0,2 Zoll.

Beschriftung: Die Revisionswolke ist eine Annotation vom Typ swRevisionCloud (swAnnotationType_e). Das Hilfebeispiel „Get Annotation Object“ holt aus einer ausgewählten Revisionswolke so die Beschriftung.

Der letzte Punkt, der ein Polygon schließt, zählt danach nicht als Pfadpunkt mit. Die Wolke landet auf dem Blatt, nicht in der aktiven Zeichenansicht.

Eigenschaften und Methoden

Eigenschaften 3, davon 3 beschrieben

NameBeschreibung
AngleLiest oder setzt den Drehwinkel der Revisionswolke.
ArcRadiusLiest oder setzt den größten Radius der Bögen, aus denen die Revisionswolke besteht.
ShapeLiefert die Form der Revisionswolke: Ellipse, Rechteck, Polygon oder Freihand.

Methoden 6, davon 6 beschrieben

NameBeschreibung
FinalizeSchließt den Pfad einer neuen Revisionswolke, nachdem alle Punkte angehängt sind.
GetAnnotationLiefert die Beschriftung der Revisionswolke.
GetNextLiefert die nächste Revisionswolke in der Zeichenansicht oder auf dem Blatt.
GetPathPointAtIndexLiefert die Koordinaten eines Punkts auf dem Pfad der Revisionswolke.
GetPathPointCountLiefert die Zahl der Punkte auf dem Pfad der Revisionswolke.
SetPathPointAtIndexHängt einen Punkt an den Pfad der Revisionswolke an oder verschiebt einen vorhandenen Punkt.

Nicht aufgeführt sind 3 C++-Varianten (Namen mit I davor, zum Beispiel IGetAnnotation). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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