Bezeichnung
cscaledfont:TextExtents -- Gibt die Textausdehnungen zurück
Übersicht
t = cscaledfont:TextExtents(s$)
Beschreibung
Ruft die Ausdehnung für eine TextZeichenkette ab. Die Ausdehnung beschreiben ein Rechteck im Benutzerbereich, das den "eingefärbten" Teil des am Ursprung (0.0) gezeichneten Texts umschließt, wie er von ccontext:ShowText() gezeichnet würde, wenn der Cairographics-Status auf dieselbe Schriftart, Schriftmatrix, ctm und Schriftoptionen wie die skalierte Schriftart eingestellt wäre. Zusätzlich geben die Werte XAdvance und YAdvance an, um wie viel der aktuelle Punkt durch ccontext:ShowText() vorgerückt würde.

Beachten Sie, dass Leerzeichen nicht direkt zur Größe des Rechtecks beitragen, wie sie in den Feldern Width und Height der Ausmaße enthalten ist. 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.

Diese Funktion gibt eine Tabelle zurück, die die Textbereiche enthält. Eine Beschreibung aller Tabellenfelder finden Sie unter ccontext:TextExtents().

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