Objekt · SldWorks
RevisionCloud-Objekt
Eine Revisionswolke in einer Zeichnung: Form, Bogenradius, Drehwinkel und die Punkte ihres Pfads.
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
DrawingDoc.InsertRevisionCloud: fügt eine neue Revisionswolke einView.GetFirstRevisionCloud2und dannRevisionCloud.GetNext: die Revisionswolken einer Zeichenansicht nacheinanderView.GetRevisionClouds: alle Revisionswolken einer ZeichenansichtSelectionMgr.GetSelectedObject6: wenn eine Revisionswolke ausgewählt ist (AuswahltypswSelREVISIONCLOUDS)
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Angle | Liest oder setzt den Drehwinkel der Revisionswolke. |
| ArcRadius | Liest oder setzt den größten Radius der Bögen, aus denen die Revisionswolke besteht. |
| Shape | Liefert die Form der Revisionswolke: Ellipse, Rechteck, Polygon oder Freihand. |
Methoden 6, davon 6 beschrieben
| Name | Beschreibung |
|---|---|
| Finalize | Schließt den Pfad einer neuen Revisionswolke, nachdem alle Punkte angehängt sind. |
| GetAnnotation | Liefert die Beschriftung der Revisionswolke. |
| GetNext | Liefert die nächste Revisionswolke in der Zeichenansicht oder auf dem Blatt. |
| GetPathPointAtIndex | Liefert die Koordinaten eines Punkts auf dem Pfad der Revisionswolke. |
| GetPathPointCount | Liefert die Zahl der Punkte auf dem Pfad der Revisionswolke. |
| SetPathPointAtIndex | Hä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.