Methode · DrawingDoc
InsertRevisionCloud-Methode (DrawingDoc)
Fügt eine Revisionswolke mit der angegebenen Form in eine Zeichenansicht oder ein Blatt ein.
Syntax
Function InsertRevisionCloud( _
ByVal CloudShape As Long _
) As ObjectSet swWolke = swDraw.InsertRevisionCloud(swRevisionCloudShape_Rectangle)Parameter
CloudShapeLongByValForm der Revisionswolke, Wert aus
swRevisionCloudShape_e:swRevisionCloudShape_Freehand(0): FreihandswRevisionCloudShape_Ellipse(1): EllipseswRevisionCloudShape_Rectangle(2): RechteckswRevisionCloudShape_Polygon(3): Polygon
Rückgabewert
Die neue Revisionswolke (RevisionCloud). Sie ist danach noch nicht fertig: Lage, Punkte und Abschluss setzt du wie in den Bemerkungen beschrieben. Was bei einem Fehler zurückkommt, sagt die Hilfe nicht; prüf mit Is Nothing.
Beispiel
' swDraw ist die aktive Zeichnung (DrawingDoc), etwa per Set swDraw = swModel.
Dim swWolke As SldWorks.RevisionCloud
Dim swAnn As SldWorks.Annotation
Dim bErfolg As Boolean
Set swWolke = swDraw.InsertRevisionCloud(swRevisionCloudShape_Rectangle)
If Not swWolke Is Nothing Then
Set swAnn = swWolke.GetAnnotation
bErfolg = swAnn.SetPosition2(0.1, 0.08, 0) ' erste Ecke
swWolke.ArcRadius = 0.004 ' Bogenradius
bErfolg = swWolke.SetPathPointAtIndex(-1, 0.16, 0.12, 0) ' gegenüberliegende Ecke
bErfolg = swWolke.Finalize ' Pfad schließen
Debug.Print "Punkte im Pfad: " & swWolke.GetPathPointCount
End IfBemerkungen
Nach dem Aufruf gehst du so vor:
- Mit
RevisionCloud.GetAnnotationdie Beschriftung der Wolke holen. - Mit deren Position den Bezugspunkt setzen. Die Hilfe nennt dafür
Annotation.SetPosition, das Beispiel nimmt den NachfolgerAnnotation.SetPosition2. Lässt du den Schritt weg, beginnt die Wolke im Ursprung (0, 0, 0). Der Bezugspunkt ist bei der Ellipse der Mittelpunkt, beim Rechteck eine Ecke, bei Polygon und Freihand einer der Punkte der Wolke. - Mit
RevisionCloud.ArcRadiusden Bogenradius setzen. - Mit
RevisionCloud.SetPathPointAtIndexundIndex = -1Punkte anhängen: bei der Ellipse einmal eine Ecke des Rechtecks, in das die Ellipse passt, beim Rechteck einmal die Ecke gegenüber dem Bezugspunkt, beim Polygon (Anzahl Seiten + 1) Mal, bei Freihand beliebig oft. Bei Polygon und Freihand müssen der erste und der letzte Punkt auf dem Bezugspunkt liegen. - Mit
RevisionCloud.Finalizeden Pfad schließen. Danach kannst du keine Punkte mehr anhängen.
Einen vorhandenen Punkt verschiebst du mit RevisionCloud.SetPathPointAtIndex und seinem Index. Einheiten nennt die Hilfe weder für den Bezugspunkt noch für den Bogenradius; vermutlich Meter, beim Bezugspunkt in Blattkoordinaten.
Ob die Wolke in eine Zeichenansicht oder ins Blatt kommt, hängt vermutlich davon ab, ob eine Ansicht aktiv ist. Die Hilfe sagt dazu nur „in eine Ansicht oder ein Blatt“. Vorhandene Revisionswolken einer Ansicht liefert View.GetRevisionClouds.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2013
Englisches Original: IDrawingDoc::InsertRevisionCloud in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.