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 ObjectSet swTextFormat = swAnn.GetTextFormat(Index)Parameter
IndexLongByVal- Welcher Text der Beschriftung, beginnend bei
0. Wird nur bei Blöcken gebraucht, sonst0, 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 IfBemerkungen
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.