SolidWorksMakroprogrammierung

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 Object
Set swWolke = swDraw.InsertRevisionCloud(swRevisionCloudShape_Rectangle)

Parameter

CloudShapeLongByVal

Form der Revisionswolke, Wert aus swRevisionCloudShape_e:

  • swRevisionCloudShape_Freehand (0): Freihand
  • swRevisionCloudShape_Ellipse (1): Ellipse
  • swRevisionCloudShape_Rectangle (2): Rechteck
  • swRevisionCloudShape_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 If

Bemerkungen

Nach dem Aufruf gehst du so vor:

  1. Mit RevisionCloud.GetAnnotation die Beschriftung der Wolke holen.
  2. Mit deren Position den Bezugspunkt setzen. Die Hilfe nennt dafür Annotation.SetPosition, das Beispiel nimmt den Nachfolger Annotation.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.
  3. Mit RevisionCloud.ArcRadius den Bogenradius setzen.
  4. Mit RevisionCloud.SetPathPointAtIndex und Index = -1 Punkte 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.
  5. Mit RevisionCloud.Finalize den 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.