SolidWorksMakroprogrammierung

Methode · DrawingDoc

NewNote-Methode (DrawingDoc)

Erzeugt an der ausgewählten Stelle einen neuen Hinweis mit dem angegebenen Text und der angegebenen Höhe.

Syntax

Sub NewNote( _
   ByVal Text As String, _
   ByVal Height As Double _
)
swDraw.NewNote "Kanten gebrochen", 0.005

Parameter

TextStringByVal
Text des Hinweises.
HeightDoubleByVal
Höhe des Hinweises in Metern, zum Beispiel 0.005 für 5 mm. Vermutlich ist die Schrifthöhe gemeint, die Hilfe sagt nur „Höhe des Hinweises“.

Beispiel

' swModel ist die aktive Zeichnung (ModelDoc2), swDraw dasselbe Dokument als DrawingDoc.
Dim bErfolg As Boolean
swModel.ClearSelection2 True
' Kante einer Zeichenansicht an einem Punkt des Blatts auswählen (Blattkoordinaten in Metern)
bErfolg = swModel.Extension.SelectByID2("", "EDGE", 0.12, 0.09, 0, False, 0, Nothing, swSelectOptionDefault)
If bErfolg Then
    swDraw.NewNote "Kanten gebrochen", 0.005   ' 5 mm hoch
    swModel.ClearSelection2 True
Else
    Debug.Print "An dieser Stelle liegt keine Kante."
End If

Bemerkungen

Der Hinweis entsteht an der ausgewählten Stelle. Was genau als Stelle zählt (der Punkt, an dem ausgewählt wurde, oder das ausgewählte Element), ob der Hinweis eine Bezugslinie zur Auswahl bekommt und was ohne Auswahl passiert, sagt die Hilfe nicht. Probier es in deiner Zeichnung aus, bevor du dich darauf verlässt.

Der Befehl ist ein Sub und liefert den neuen Hinweis nicht zurück. Brauchst du das Note-Objekt, etwa um den Hinweis danach zu verschieben, nimm DrawingDoc.CreateText2 (Hinweis an einer festen Stelle des Blatts) oder ModelDoc2.InsertNote (Hinweis an der Auswahl, mit Bezugslinie). Beide liefern den Hinweis.

Siehe auch

Verfügbarkeit

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

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

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