Bezeichnung
ccontext:TextExtents -- Gibt die Textausdehnungen zurück
Übersicht
t = ccontext:TextExtents(s$)
Beschreibung
Ruft die Grenzen für eine TextZeichenkette ab. Die Grenzen beschreiben ein Rechteck im Benutzerbereich, das den "eingefärbten" Teil des Texts umschließt (wie er von ccontext:ShowText() gezeichnet würde). Darüber hinaus geben die Werte XAdvance und YAdvance den Betrag an, um den der aktuelle Punkt durch ccontext:ShowText() vorgezogen würde.

Diese Funktion gibt eine Tabelle zurück, die die Textbereiche beschreibt. Die Tabelle enthält die folgenden Felder:

XBearing
Der horizontale Abstand vom Ursprung zum ganz linken Teil der gezeichneten Glyphen. Positiv, wenn die Glyphen vollständig rechts vom Ursprung liegen.
YBearing
Der vertikale Abstand vom Ursprung bis zum obersten Teil der gezeichneten Glyphen. Nur positiv, wenn die Glyphen vollständig unterhalb des Ursprungs liegen; wird normalerweise negativ sein.
Width
Breite der Glyphen die gezeichnet wird.
Height
Höhe der Glyphen die gezeichnet wird.
XAdvance
Abstand, der nach dem Zeichnen dieser Glyphen in X-Richtung vorgeschoben werden soll.
YAdvance
Entfernung, die nach dem Zeichnen dieser Glyphen in Y-Richtung vorgeschoben werden soll. Wird normalerweise Null sein, mit Ausnahme des vertikalen Textlayouts, wie es in ostasiatischen Sprachen vorkommt.

Beachten Sie, dass Leerzeichen keinen direkten Einfluss auf die Größe des Rechtecks haben (Width und Height). Sie tragen indirekt dazu bei, indem sie die Position von Nicht-Leerzeichen ändern. Insbesondere nachgestellte Leerzeichen haben wahrscheinlich keinen Einfluss auf die Größe des Rechtecks, wohl aber auf die Werte XAdvance und YAdvance.

Beachten Sie außerdem, dass Textausdehnungen größtenteils, aber nicht vollständig, unabhängig von der aktuellen Transformationsmatrix sind, da sie in Benutzerbereichkoordinaten angegeben werden. Wenn Sie ccontext:Scale() mit Skalierungskoeffizienten von 2.0 auf jeder Achse aufrufen, wird der Text doppelt so groß gezeichnet, aber die gemeldeten Textausdehnungen werden nicht verdoppelt. Sie ändern sich aufgrund von Hinweisen geringfügig (Sie können also nicht davon ausgehen, dass die Metriken unabhängig von der Transformationsmatrix sind), bleiben ansonsten aber unverändert.

Eingaben
s$
Textfolge
Rückgabewerte
t
Tabelle mit den Textumfängen (siehe oben).
Navigation zeigen