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 BooleanbErfolg = 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ß.
PatternRotateBooleanByValTrue, um das Muster zu drehen, sonstFalse. 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: " & bErfolgBemerkungen
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.