SolidWorksMakroprogrammierung

Methode · Annotation

SetTextFormat-Methode (Annotation)

Setzt das Textformat eines Texts in einer Beschriftung, oder stellt es auf die Vorgabe des Dokuments zurück.

Syntax

Function SetTextFormat( _
   ByVal Index As Long, _
   ByVal UseDoc As Boolean, _
   ByVal TextFormat As Object _
) As Boolean
bErfolg = swAnn.SetTextFormat(Index, UseDoc, TextFormat)

Parameter

IndexLongByVal
Welcher Text der Beschriftung, beginnend bei 0. Wird nur bei Blöcken gebraucht, sonst 0.
UseDocBooleanByVal
True: Textformat aus dem Dokument, TextFormat wird ignoriert. False: TextFormat gilt.
TextFormatObjectByVal
Das neue Textformat (TextFormat). Bei UseDoc = True kommt Nothing.

Rückgabewert

True, wenn das Textformat gesetzt wurde, sonst False.

Beispiel

' swModel ist das Dokument (ModelDoc2), swAnn die Beschriftung (Annotation) einer Notiz darin.
Dim swTextFormat As SldWorks.TextFormat
Set swTextFormat = swAnn.GetTextFormat(0)
swTextFormat.Bold = True
swTextFormat.CharHeight = 0.005                ' 5 mm
If swAnn.SetTextFormat(0, False, swTextFormat) Then
    swModel.ActiveView.GraphicsRedraw Empty
End If

Bemerkungen

Was der Index bedeutet, hängt von der Art ab:

  • Bezugshinweise und Bezugsstellensymbole nehmen immer das Format für Bemaßungen aus dem Dokument. Der Befehl hat keine Wirkung.
  • Form- und Lagetoleranzen, Bemaßungen, einfache Notizen, Oberflächen- und Schweißsymbole nehmen das Format aus dem Dokument oder ein eigenes. Index 0.
  • Blöcke (und zusammengesetzte Notizen aus Dokumenten bis SOLIDWORKS 2015) haben mehrere Texte mit je eigenem Format. Der Index wählt den Text. Bei ungültigem Index liefert der Befehl False.

RTF-Text in Notizen: Enthält eine Notiz eingebettete Formatierungen im Text, hat ein bestimmtes Textformat keine Wirkung, und der Befehl liefert False. Setzt du die Notiz auf das Format des Dokuments, verschwinden alle eingebetteten Schriftangaben. Für ein bestimmtes Format setzt du deshalb erst das des Dokuments und dann das gewünschte.

Neu zeichnen: Damit die Änderung zu sehen ist, zeichnest du neu. Die Hilfe nennt das veraltete ModelDoc2.GraphicsRedraw2, heute nimmst du ModelView.GraphicsRedraw wie im Beispiel.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2000

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

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