SolidWorksMakroprogrammierung

Methode · DrawingDoc

InsertLinearNotePattern-Methode (DrawingDoc)

Erzeugt aus dem ausgewählten Hinweis ein lineares Muster mit Kopien in einer oder zwei Richtungen.

Syntax

Function InsertLinearNotePattern( _
   ByVal NumX As Long, _
   ByVal NumY As Long, _
   ByVal SpacingX As Double, _
   ByVal SpacingY As Double, _
   ByVal AngleX As Double, _
   ByVal AngleY As Double, _
   ByVal DeleteInstances As String _
) As Boolean
bErfolg = swDraw.InsertLinearNotePattern(4, 1, 0.03, 0.01, 0, 1.5707963267949, "")

Parameter

NumXLongByVal
Anzahl der Exemplare in Richtung 1 (x-Achse). Der ausgewählte Hinweis zählt mit.
NumYLongByVal
Anzahl der Exemplare in Richtung 2 (y-Achse), ebenfalls einschließlich des Ausgangshinweises. Mit 1 entsteht nur eine Reihe.
SpacingXDoubleByVal
Abstand der Exemplare in Richtung 1. Die Hilfe nennt keine Einheit, vermutlich Meter wie sonst bei Längen in der API.
SpacingYDoubleByVal
Abstand der Exemplare in Richtung 2. Einheit wie bei SpacingX nicht angegeben.
AngleXDoubleByVal
Winkel der Richtung 1 zur x-Achse. Die Hilfe nennt keine Einheit, vermutlich Bogenmaß.
AngleYDoubleByVal
Der Winkel der Richtung 2 zur y-Achse. Einheit wie bei AngleX nicht angegeben. Ob 0 dann wirklich senkrecht nach oben zeigt, ist nicht beschrieben; probier es aus.
DeleteInstancesStringByVal
Exemplare, die im Muster fehlen sollen, als Text im Format "(a) (b) (c) ". Übergib "", wenn alle Exemplare bleiben sollen. Wie die Exemplare nummeriert werden, sagt die Hilfe nicht.

Rückgabewert

True, wenn das Muster erzeugt wurde, sonst False.

Beispiel

' swModel ist die aktive Zeichnung (ModelDoc2), swDraw dasselbe Dokument als DrawingDoc.
Dim swNote As SldWorks.Note
Dim swAnn As SldWorks.Annotation
Dim bErfolg As Boolean
Set swNote = swModel.InsertNote("Prüfpunkt")
Set swAnn = swNote.GetAnnotation
bErfolg = swAnn.SetPosition2(0.05, 0.05, 0)          ' Blattkoordinaten in Metern
swModel.ClearSelection2 True
bErfolg = swAnn.Select3(False, Nothing)
' 4 Exemplare in x-Richtung, 30 mm Abstand, nur eine Reihe
bErfolg = swDraw.InsertLinearNotePattern(4, 1, 0.03, 0.01, 0, 1.5707963267949, "")
Debug.Print "Muster erzeugt: " & bErfolg

Bemerkungen

Der Befehl arbeitet mit dem ausgewählten Hinweis. Wähl also vorher genau einen Hinweis aus, etwa mit Annotation.Select3 oder ModelDocExtension.SelectByID2.

Einheiten für Abstände und Winkel nennt die Hilfe nicht. Meter und Bogenmaß sind naheliegend, prüf das Ergebnis aber in deiner Zeichnung. Ein kreisförmiges Muster aus Hinweisen erzeugt DrawingDoc.InsertCircularNotePattern.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2011

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

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