SolidWorksMakroprogrammierung

Methode · DrawingDoc

InsertNewNote2-Methode (DrawingDoc)

Erzeugt einen neuen Hinweis in der Zeichnung, wahlweise mit Bezugslinie und Rahmen.

Syntax

Sub InsertNewNote2( _
   ByVal UpperText As String, _
   ByVal LowerText As String, _
   ByVal NoLeader As Boolean, _
   ByVal BentLeader As Boolean, _
   ByVal ArrowStyle As Integer, _
   ByVal LeaderSide As Integer, _
   ByVal Angle As Double, _
   ByVal BalloonStyle As Integer, _
   ByVal BalloonFit As Integer, _
   ByVal UpperNoteContent As Integer, _
   ByVal LowerNoteContent As Integer _
)
swDraw.InsertNewNote2 "A", "", False, False, swCLOSED_ARROWHEAD, swLS_SMART, 0, swBS_Circular, swBF_Tightest, 0, 0

Parameter

UpperTextStringByVal
Text des Hinweises (der „obere“ Text).
LowerTextStringByVal
Wird nicht benutzt. Übergib "".
NoLeaderBooleanByVal
True erzeugt den Hinweis ohne Bezugslinie, False mit.
BentLeaderBooleanByVal
True erzeugt eine geknickte Bezugslinie, False keine geknickte.
ArrowStyleIntegerByVal
Pfeilspitze der Bezugslinie, Wert aus swArrowStyle_e, zum Beispiel swOPEN_ARROWHEAD (0): offen, swCLOSED_ARROWHEAD (1): gefüllt, swDOT_ARROWHEAD (3): gefüllter Punkt, swNO_ARROWHEAD (10): keine.
LeaderSideIntegerByVal

Seite der Bezugslinie, Wert aus swLeaderSide_e:

  • swLS_SMART (0): dem Namen nach automatisch
  • swLS_LEFT (1): links
  • swLS_RIGHT (2): rechts
AngleDoubleByVal
Winkel des Textes. Die Hilfe nennt keine Einheit, vermutlich Bogenmaß.
BalloonStyleIntegerByVal
Rahmenform um den Text, Wert aus swBalloonStyle_e, zum Beispiel swBS_None (0): kein Rahmen, swBS_Circular (1): Kreis, swBS_Triangle (2): Dreieck, swBS_Box (4): Rechteck. swBS_SplitCirc (7) gilt nicht für Hinweise.
BalloonFitIntegerByVal
Größe des Rahmens, Wert aus swBalloonFit_e: swBF_Tightest (0): eng am Text, swBF_1Char (1) bis swBF_5Chars (5): Platz für 1 bis 5 Zeichen, swBF_UserDef (6): benutzerdefiniert.
UpperNoteContentIntegerByVal
Wird nicht benutzt. Übergib 0.
LowerNoteContentIntegerByVal
Wird nicht benutzt. Übergib 0.

Beispiel

' swModel ist die aktive Zeichnung (ModelDoc2), swDraw dasselbe Dokument als DrawingDoc.
' Annahme: Die Bezugslinie zeigt auf das vorher ausgewählte Element, wie bei ModelDoc2.InsertNote.
Dim bErfolg As Boolean
bErfolg = swModel.Extension.SelectByID2("", "EDGE", 0.12, 0.09, 0, False, 0, Nothing, 0)
If False = bErfolg Then Debug.Print "Keine Kante an dieser Stelle gefunden."
swDraw.InsertNewNote2 "A", "", False, False, swCLOSED_ARROWHEAD, swLS_SMART, 0, _
    swBS_Circular, swBF_Tightest, 0, 0
swModel.ClearSelection2 True

Bemerkungen

Der Befehl liefert den neuen Hinweis nicht zurück. Wo der Hinweis landet und woran die Bezugslinie hängt, sagt die Hilfe bei diesem Befehl nicht. Bei ModelDoc2.InsertNote ist es beschrieben: Die Bezugslinie zeigt auf die vorher ausgewählten Elemente, ohne Auswahl steht der Hinweis ohne Bezugslinie im Ursprung. Ob InsertNewNote2 sich genauso verhält, ist nicht dokumentiert.

Brauchst du das Note-Objekt, etwa um den Hinweis danach zu verschieben, nimm ModelDoc2.InsertNote. Ersetzt DrawingDoc.InsertNewNote. Ein Muster aus einem Hinweis erzeugen DrawingDoc.InsertLinearNotePattern und DrawingDoc.InsertCircularNotePattern.

Siehe auch

Verfügbarkeit

In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.

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

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