SolidWorksMakroprogrammierung

Methode · DrawingDoc

InsertCircularNotePattern-Methode (DrawingDoc)

Erzeugt aus dem ausgewählten Hinweis ein kreisförmiges Muster.

Syntax

Function InsertCircularNotePattern( _
   ByVal ArcRadius As Double, _
   ByVal ArcAngle As Double, _
   ByVal PatternNum As Long, _
   ByVal PatternSpacing As Double, _
   ByVal PatternRotate As Boolean, _
   ByVal DeleteInstances As String _
) As Boolean
bErfolg = swDraw.InsertCircularNotePattern(0.04, 0, 6, 1.0471975512, True, "")

Parameter

ArcRadiusDoubleByVal
Radius des Kreismusters. Die Hilfe nennt keine Einheit, vermutlich Meter wie sonst in der API.
ArcAngleDoubleByVal
Ein Winkel bezogen auf die Hinweise, die gemustert werden. Was er genau festlegt und in welcher Einheit, sagt die Hilfe nicht. Vermutlich Bogenmaß.
PatternNumLongByVal
Gesamtzahl der Exemplare, der ausgewählte Hinweis zählt mit.
PatternSpacingDoubleByVal
Winkelabstand zwischen den Exemplaren im Bogenmaß.
PatternRotateBooleanByVal
True, um das Muster zu drehen, sonst False. Vermutlich drehen sich dann die Hinweise mit, die Hilfe erklärt es nicht genauer.
DeleteInstancesStringByVal
Exemplare, die weggelassen werden, als Zeichenfolge im Format "(a) (b) (c) ". Vermutlich stehen in den Klammern die Nummern der Exemplare. Für keines eine leere Zeichenfolge "".

Rückgabewert

True, wenn das Muster erzeugt wurde, sonst False.

Beispiel

' swDraw ist die aktive Zeichnung (DrawingDoc), etwa per Set swDraw = swModel.
' Vorher einen Hinweis auf dem Blatt auswählen.
Dim bErfolg As Boolean
Dim dPi As Double
Dim dRadius As Double
dPi = 4 * Atn(1)
dRadius = 40 / 1000                 ' 40 mm
' 6 Exemplare im Abstand von 60 Grad, mitdrehen, keines weglassen
bErfolg = swDraw.InsertCircularNotePattern(dRadius, 0, 6, dPi / 3, True, "")
Debug.Print "Kreismuster erzeugt: " & bErfolg

Bemerkungen

Der Befehl nimmt den ausgewählten Hinweis (Note) als Vorlage. Wähl ihn also vorher aus, etwa mit ModelDocExtension.SelectByID2 und dem Typ "NOTE". Ob mehrere Hinweise auf einmal gehen, sagt die Hilfe nicht.

Wo der Mittelpunkt des Kreises liegt und in welche Richtung das Muster läuft, ist nicht dokumentiert. Probier die Werte im eigenen Blatt aus, bevor du dich darauf verlässt. Ein Muster in Zeilen und Spalten erzeugst du mit DrawingDoc.InsertLinearNotePattern.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2011

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

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