SolidWorksMakroprogrammierung

Methode · Annotation

GetTextFormat-Methode (Annotation)

Liefert das Textformat (Schrift, Höhe, Fett usw.) eines Texts in einer Beschriftung.

Syntax

Function GetTextFormat( _
   ByVal Index As Long _
) As Object
Set swTextFormat = swAnn.GetTextFormat(Index)

Parameter

IndexLongByVal
Welcher Text der Beschriftung, beginnend bei 0. Wird nur bei Blöcken gebraucht, sonst 0, siehe Bemerkungen.

Rückgabewert

Das Textformat (TextFormat), egal ob es eigens gesetzt ist oder aus dem Dokument kommt. Nothing bei ungültigem Index.

Beispiel

' swAnn ist die Beschriftung (Annotation) einer Notiz, etwa aus der Auswahl.
Dim swTextFormat As SldWorks.TextFormat
Set swTextFormat = swAnn.GetTextFormat(0)
If Not swTextFormat Is Nothing Then
    Debug.Print swTextFormat.TypeFaceName & ", Höhe " & swTextFormat.CharHeight * 1000 & " mm" & _
        IIf(swAnn.GetUseDocTextFormat(0), " (aus dem Dokument)", " (eigenes Format)")
End If

Bemerkungen

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

  • Bezugshinweise und Bezugsstellensymbole nehmen immer das Textformat für Bemaßungen aus dem Dokument. Index 0.
  • Form- und Lagetoleranzen, Bemaßungen, einfache Notizen, Oberflächen- und Schweißsymbole nehmen entweder das Format aus dem Dokument oder ein eigenes. Index 0.
  • Blöcke (und zusammengesetzte Notizen aus Dokumenten bis SOLIDWORKS 2015) enthalten mehrere Texte mit je eigenem Format. Der Index wählt den Text, die Anzahl liefert Annotation.GetTextFormatCount.

RTF-Text: Enthält eine Notiz eingebettete Formatierungen im Text, stimmt das gelieferte Format nicht unbedingt mit der Anzeige überein. Ob das so ist, liefert Note.HasMultipleFonts.

Ob das Format aus dem Dokument kommt, liefert Annotation.GetUseDocTextFormat. Ändern kannst du es mit Annotation.SetTextFormat.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2000

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

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