Bezeichnung
AddTextToPath -- fügt Vektortext dem Pfad hinzu (V5.0)
Übersicht
AddTextToPath(id, t$[, table])
Beschreibung
Dieser Befehl fügt den Text in t$ als Vektorgrafik dem aktuellen Pfad hinzu. Aus diesem Grund wird dieser Befehl nur dann funktionieren, wenn ein Vektorfont (zum Beispiel eine TrueType-Schriftart) gerade aktiv ist. Mit Bitmap-Schriften kann dieser Befehl nicht arbeiten. AddTextToPath() wird die aktive Schriftart verwenden, die von dem letzten Aufruf von SetFont() oder UseFont() gesetzt wurde.

Bitte beachten Sie, dass AddTextToPath() den Text über den aktuellen y-Punkt hinzufügt. Wenn also der aktuelle y-Pfadpunkt 240 ist und Sie den Text, der 36 Pixel hoch ist hinzufügen, wird der Text an einer y-Position von 204 (240-36 = 204) anstelle von 240 (wie der aktuelle y-Pfadpunkt) plaziert werden.

Bitte beachten Sie, dass derzeit einige Einschränkungen gelten:

Mit dem optionalen Argument table können Sie weitere Optionen festlegen:

Encoding:
Dieses Argument kann verwendet werden, um die Zeichencodierung innerhalb von t$ anzugeben. Voreingestellt ist die Standardcodierung für die Textbibliothek, welche mit dem Befehl SetDefaultEncoding() festgelegt ist. Siehe SetDefaultEncoding für Details.

Eingaben
id
Identifikator des Pfades, dem Sie den Text hinzufügen möchten
t$
Text, welcher dem Pfad hinzugefügt wird
table
optional: Tabelle für weitere Optionen (siehe oben)
Beispiel
EnableLayers
SetFillStyle(#FILLCOLOR)
SetFormStyle(#ANTIALIAS)
SetFont("Arial", 100, {Engine = #FONTENGINE_INBUILT})
StartPath(1)
MoveTo(1, 0, 0)
AddTextToPath(1, "Hello World")
DrawPath(1, #CENTER, #CENTER + 100, #BLUE, {AnchorX = 0.5,
    AnchorY = 0.5, Rotate = 45})
Der obige Code erzeugt einen Vektorpfad, der den Text "Hello World" enthält. Der Pfad wird dann um 45 Grad gedreht.

Navigation zeigen