Objekt · SldWorks
Note-Objekt
Steht für eine Notiz: Text, Ballon, Stücklisten-Ballon, Hyperlink, Wasserzeichen und die Geometrie, aus der sie gezeichnet wird.
Beschreibung
Eine Notiz ist eine Beschriftung mit Text, in Zeichnungen, Teilen und Baugruppen. Auch Ballons, Stücklisten-Ballons und Biegelinien-Notizen von Blechteilen sind Notizen. Note enthält, was nur Notizen haben: Text, Ballon, Hyperlink und die Linien, aus denen sie gezeichnet werden. Lage, Layer, Sichtbarkeit und Textformat stehen bei der zugehörigen Annotation, die du mit Note.GetAnnotation bekommst.
Zugriff
View.GetFirstNote2und dannNote.GetNext: alle Notizen einer Zeichenansicht oder eines BlattsView.GetNotes: alle Notizen einer Zeichenansicht als ArrayAnnotation.GetSpecificAnnotation: aus einer Beschriftung mitAnnotation.GetTypeswNoteModelDoc2.InsertNoteundDrawingDoc.CreateText2: eine neue NotizModelDocExtension.InsertBOMBalloon2,ModelDocExtension.InsertStackedBalloon2undDrawingDoc.AutoBalloon5: neue BallonsDrawingDoc.InsertRevisionSymbol: ein neues RevisionssymbolPartDoc.InsertBendNotes: Biegelinien-Notizen eines BlechteilsSketchBlockDefinition.GetNotesundSketchBlockInstance.GetAttributes: Notizen in BlöckenBalloonStack.MasterundBalloonStack.AddTo: Ballons eines Ballonstapels
Beispiel
' Listet alle Notizen der aktiven Zeichnung auf, mit Art und Lage.
' Vorbedingung: Eine Zeichnung ist geöffnet.
' Ergebnis: Eine Zeile je Notiz im Direktfenster (Strg+G).
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swDraw As SldWorks.DrawingDoc
Dim swView As SldWorks.View
Dim swNote As SldWorks.Note
Dim vPunkt As Variant
Dim sArt As String
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocDRAWING Then Exit Sub
Set swDraw = swModel
Set swView = swDraw.GetFirstView ' zuerst das Blatt selbst
Do While Not swView Is Nothing
Set swNote = swView.GetFirstNote2
Do While Not swNote Is Nothing
If swNote.IsBomBalloon Then
sArt = "Stücklisten-Ballon " & swNote.GetBomBalloonText(True)
ElseIf swNote.HasBalloon Then
sArt = "Ballon"
ElseIf swNote.GetHyperlinkText <> "" Then
sArt = "Hyperlink auf " & swNote.GetHyperlinkText
Else
sArt = "Notiz"
End If
vPunkt = swNote.GetTextPoint2
If Not IsEmpty(vPunkt) Then sArt = sArt & " bei " & Format(vPunkt(0) * 1000, "0") & _
" / " & Format(vPunkt(1) * 1000, "0") & " mm"
Debug.Print swView.GetName2 & ": " & sArt & ", """ & swNote.GetText & """"
Set swNote = swNote.GetNext
Loop
Set swView = swView.GetNextView
Loop
End SubBemerkungen
Variablenname: swNote ist auch der Name einer Konstanten aus swAnnotationType_e. Brauchst du im selben Makro beides, etwa für Annotation.GetType = swNote, nenn die Variable anders, zum Beispiel swNoteObj.
Koordinaten: Die Punkte der Geometrie-Befehle sind im Dokumentraum: in Zeichnungen vom Ursprung des Blatts unten links, in Teilen und Baugruppen vom Ursprung des Modells. Eine Einheit nennt die Hilfe meist nicht. Ausdrücklich in Metern sind nur Note.SetHeight und Note.GetTextHeightAtIndex.
Index der Texte: Die Hilfe zählt die GetText…AtIndex-Befehle uneinheitlich: Note.GetTextAtIndex, Note.GetTextAngleAtIndex, Note.GetTextPositionAtIndex, Note.GetTextRefPositionAtIndex und Note.GetTextLineSpacingAtIndex ab 1, Note.GetTextFontAtIndex, Note.GetTextHeightAtIndex und Note.GetTextInvertAtIndex ab 0.
Zusammengesetzte Notizen: Sie lassen sich in SOLIDWORKS nicht mehr anlegen. Befehle dafür sind nur für alte Dateien gedacht. Ersatz sind Blöcke (SketchBlockDefinition, SketchBlockInstance).
View.GetFirstNote2 gibt es erst seit SOLIDWORKS 2025 SP01. In älteren Versionen bricht das Beispiel damit mit Laufzeitfehler 438 ab, dort nimmst du den Vorgänger View.GetFirstNote.
Eigenschaften und Methoden
Eigenschaften 17, davon 17 beschrieben
| Name | Beschreibung |
|---|---|
| AllUpperCase | Liest oder setzt, ob der Text einer Notiz in Großbuchstaben angezeigt wird. |
| Angle | Liest oder setzt den Drehwinkel einer Notiz, im Bogenmaß. |
| BehindSheet | Liest oder setzt, ob eine Notiz im Blattformat einer Zeichnung hinter dem Blatt liegt, etwa als Wasserzeichen. |
| HasMultipleFonts | Liefert, ob eine Notiz mehrere Schriften enthält, also eingebettete Formatierungen im Text. |
| IncludeDimPrefixSuffixTolerance | Liest oder setzt, ob eine Notiz mit verknüpfter Bemaßung auch deren Präfix, Suffix und Toleranz zeigt. |
| IsBendLineNote | Liefert, ob eine Notiz eine Biegelinien-Notiz eines Blechteils ist. |
| LockPosition | Liest oder setzt, ob eine Notiz verankert ist, ihre Lage also festgehalten wird. |
| PromptText | Liest oder setzt den Text der Eingabeaufforderung einer Notiz. |
| PropertyLinkedText | Liest oder setzt den Text einer Notiz mit ihren Verknüpfungen, etwa $PRPVIEW:"SW-Long Date" statt des Datums. |
| ReadOnly | Liest oder setzt, ob eine Notiz schreibgeschützt ist. |
| TagName | Liest oder setzt den Tag-Namen einer Notiz, etwa einer Attribut-Notiz in einem Block. |
| TextRightToLeft | Liest oder setzt, ob eine Notiz von rechts nach links geschrieben wird. Nur bei Hebräisch als Systemsprache. |
| ToBoundingBox | Liest oder setzt die Option „Bis zum Begrenzungsrahmen“ für die Bezugslinien einer Notiz. |
| Visible | Liest oder setzt, ob eine Notiz beim Erstellen eines Blocks im Block sichtbar ist. |
| WatermarkBehindGeometry | Liest oder setzt, ob ein Wasserzeichen in einem Teil oder einer Baugruppe hinter der Geometrie liegt. |
| WatermarkNote | Liest oder setzt, ob eine Notiz in einem Teil oder einer Baugruppe ein Wasserzeichen ist. |
| WatermarkTransparencyLevel | Liest oder setzt, wie durchsichtig ein Wasserzeichen ist, von 0 bis 1. |
Methoden 87, davon 64 beschrieben, 23 veraltet
| Name | Beschreibung |
|---|---|
| AddText | veraltet |
| BeginSketchEdit | veraltet |
| EndSketchEdit | veraltet |
| GetAnnotation | Liefert die Beschriftung (Annotation) zu einer Notiz, mit Lage, Layer, Bezugslinien und Textformat. |
| GetArcAtIndex | Liefert einen Bogen, aus dem eine Notiz gezeichnet wird: Linientyp, Anfang, Ende, Mitte und Drehsinn. |
| GetArcCount | Liefert, aus wie vielen Bögen eine Notiz gezeichnet wird. |
| GetArrowHeadAtIndex | Liefert Lage, Richtung, Maße und Art einer Pfeilspitze am Ende einer Bezugslinie der Notiz. |
| GetArrowHeadCount | Liefert die Anzahl der Pfeilspitzen einer Notiz. |
| GetArrowHeadInfo | Liefert Maße und Art der Pfeilspitze am Ende der Bezugslinie einer Notiz. |
| GetAttachPos | Liefert den Anhängepunkt einer Notiz, also wo ihre Bezugslinie am Modell ansetzt. |
| GetBalloonInfo | Liefert Mittelpunkt, einen Randpunkt und Radius des Ballons um den Text einer Notiz. |
| GetBalloonOptions | Liefert die Einstellungen einer Positionsnummer, etwa Form, Größe, Text und Menge. |
| GetBalloonPadding | Liefert den Innenabstand eines Ballons. Gilt nur bei der engsten Ballongröße. |
| GetBalloonSize | Liefert die Größe eines Ballons: für wie viele Zeichen, eng anliegend oder eigene Größe. |
| GetBalloonStack | Liefert den Ballonstapel, zu dem ein Ballon gehört, oder Nothing. |
| GetBalloonStyle | Liefert die Form eines Ballons, etwa Kreis, Dreieck oder Sechseck. |
| GetBendLineValues | veraltet ersetzt durch Note.GetBendLineValues2 |
| GetBendLineValues2 | Liefert die Werte einer Biegelinien-Notiz: Richtung, Winkel, Radius und die Punkte der Biegelinie. |
| GetBomBalloonText | Liefert den oberen oder unteren Text eines Stücklisten-Ballons. |
| GetBomBalloonTextStyle | Liefert, woher der obere oder untere Text eines Stücklisten-Ballons kommt: Positionsnummer, Menge, Eigenschaft oder eigener Text. |
| GetCompoundTextAtIndex | veraltet |
| GetCompoundTextCount | veraltet |
| GetExtent | Liefert den umschließenden Rahmen einer Notiz in Blattkoordinaten: untere linke und obere rechte Ecke. |
| GetExtentAtIndex | veraltet |
| GetFontInfo | Liefert zurzeit nur den Linientyp einer Notiz, keine Schriftangaben. |
| GetHeight | Liefert die Texthöhe einer Notiz. |
| GetHeightAtIndex | veraltet |
| GetHeightInPoints | Liefert die Texthöhe einer Notiz in Punkt, etwa 8, 10 oder 12. |
| GetHyperlinkText | Liefert den Hyperlink einer Notiz, eine Internetadresse oder einen Dateipfad. |
| GetLeaderAtIndex | Liefert die Punkte einer Bezugslinie einer Notiz: keine, zwei bei gerader, drei bei geknickter Bezugslinie. |
| GetLeaderCount | Liefert die Anzahl der Bezugslinien einer Notiz. |
| GetLeaderInfo | Liefert die Punkte der Bezugslinie einer Notiz, ohne Index. |
| GetLeaderNumPointsAt | Liefert, aus wie vielen Punkten eine Bezugslinie einer Notiz besteht. |
| GetLineAtIndex | Liefert eine Linie, aus der eine Notiz gezeichnet wird: Linientyp, Anfangs- und Endpunkt. |
| GetLineCount | Liefert, aus wie vielen Linienstücken eine Notiz gezeichnet wird. |
| GetName | Liefert den Namen einer Notiz. Leer, wenn die Notiz zu einem Block gehört. |
| GetNext | Liefert die nächste Notiz einer Zeichenansicht, für eine Schleife über alle Notizen. |
| GetSketch | veraltet |
| GetText | Liefert den Text einer Notiz, mit den Werten verknüpfter Eigenschaften und Bemaßungen. |
| GetTextAngleAtIndex | Liefert den Winkel eines einzelnen Texts in einer Notiz, im Bogenmaß gegen den Uhrzeigersinn von der X-Achse. |
| GetTextAtIndex | Liefert einen einzelnen Text einer Notiz, die aus mehreren Texten besteht. |
| GetTextCount | Liefert, aus wie vielen einzelnen Texten eine Notiz besteht. |
| GetTextFontAtIndex | Liefert den Namen der Schrift eines einzelnen Texts in einer Notiz. |
| GetTextFormat | veraltet ersetzt durch Annotation.GetTextFormat |
| GetTextFormatAtIndex | veraltet ersetzt durch Annotation.GetTextFormat |
| GetTextHeightAtIndex | Liefert die Höhe eines einzelnen Texts in einer Notiz, in Metern. |
| GetTextInvertAtIndex | Liefert, ob ein einzelner Text einer Notiz an der X-Achse gespiegelt ist. |
| GetTextJustification | Liefert die waagrechte Ausrichtung des Texts einer Notiz: links, zentriert oder rechts. |
| GetTextJustificationAtIndex | veraltet |
| GetTextLineSpacingAtIndex | Liefert den Zeilenabstand eines einzelnen Texts in einer Notiz. |
| GetTextOffsetAtIndex | veraltet |
| GetTextPoint | veraltet ersetzt durch Note.GetTextPoint2 |
| GetTextPoint2 | Liefert den Bezugspunkt einer Notiz: die linke obere Ecke ihres Textrahmens. |
| GetTextPositionAtIndex | Liefert die Lage eines einzelnen Texts einer Notiz im Dokument. |
| GetTextRefPositionAtIndex | Liefert, auf welchen Punkt sich die Lage eines Texts in einer Notiz bezieht, etwa oben links oder Mitte. |
| GetTextTokens | Ohne Beschreibung in der Hilfe. Dem Namen nach: liefert die Textteile einer Notiz mit Lage, Breite und Höhe. |
| GetTextVerticalJustification | Liefert die senkrechte Ausrichtung des Texts einer Notiz: oben, Mitte oder unten. |
| GetTriangleAtIndex | Liefert ein Dreieck, aus dem eine Notiz gezeichnet wird, etwa eine Pfeilspitze: drei Eckpunkte, gefüllt, Linientyp. |
| GetTriangleCount | Liefert, aus wie vielen Dreiecken eine Notiz gezeichnet wird. |
| GetUpperRight | Liefert den rechten oberen Punkt des Texts einer Notiz. |
| GetUseDocTextFormat | veraltet ersetzt durch Annotation.GetUseDocTextFormat |
| HasBalloon | Liefert, ob eine Notiz einen Ballon hat. |
| HasExtraLeader | Liefert, ob die Bezugslinie einer Notiz geknickt ist. |
| IsAttached | Liefert, ob eine Notiz mit einer Bezugslinie angehängt ist. |
| IsAttribute | veraltet |
| IsBomBalloon | Liefert, ob eine Notiz ein Stücklisten-Ballon ist. |
| IsCompoundNote | veraltet |
| IsStackedBalloon | Liefert, ob eine Notiz zu einem Ballonstapel gehört. |
| IsStackedBalloonMaster | Liefert, ob eine Notiz die Haupt-Notiz eines Ballonstapels ist. |
| MakeStackedBalloon | Macht aus einem Ballon einen Ballonstapel. |
| SetBalloon | Setzt Form und Größe des Ballons einer Notiz, oder entfernt ihn. |
| SetBalloonPadding | Setzt den Innenabstand eines Ballons. Gilt nur bei der engsten Ballongröße. |
| SetBomBalloonText | Setzt oberen und unteren Text eines Stücklisten-Ballons, als Positionsnummer, Menge, Eigenschaft oder eigenen Text. |
| SetHeight | Setzt die Texthöhe einer Notiz in Metern. |
| SetHeightInPoints | Setzt die Texthöhe einer Notiz in Punkt, etwa 8, 10 oder 12. |
| SetHyperlinkText | Setzt einen Hyperlink in eine Notiz, auf eine Internetadresse oder eine Datei. |
| SetName | Gibt einer Notiz einen neuen Namen. |
| SetText | Ersetzt den Text einer Notiz. |
| SetTextAtIndex | veraltet |
| SetTextFormat | veraltet ersetzt durch Annotation.SetTextFormat |
| SetTextFormatAtIndex | veraltet ersetzt durch Annotation.SetTextFormat |
| SetTextJustification | Setzt die waagrechte Ausrichtung des Texts einer Notiz: links, zentriert oder rechts. |
| SetTextJustificationAtIndex | veraltet |
| SetTextOffsetAtIndex | veraltet |
| SetTextPoint | Verschiebt eine Notiz: setzt ihren Ursprung, die linke obere Ecke des Textrahmens. |
| SetTextVerticalJustification | Setzt die senkrechte Ausrichtung des Texts einer Notiz: oben, Mitte oder unten. |
| SetZeroLengthLeader | veraltet |
Nicht aufgeführt sind 26 C++-Varianten (Namen mit I davor, zum Beispiel IGetAnnotation). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: INote in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.