Bezeichnung
ccontext:ShowText -- Zeigt den Text an
Übersicht
ccontext:ShowText(s$)
Beschreibung
Ein Zeichenoperator, der die Form aus der in s$ übergebenen Zeichenkette generiert und entsprechend der aktuellen Schriftart, Schriftgröße (Schriftmatrix) und Schriftartoptionen gerendert wird.

Diese Funktion berechnet zunächst eine Reihe von Glyphen für die TextZeichenkette. Die erste Glyphe wird so platziert, dass ihr Ursprung am aktuellen Punkt liegt. Der Ursprung jedes nachfolgenden Glyphen wird gegenüber dem des vorherigen Glyphen um die Vorrückungswerte des vorherigen Glyphen versetzt.

Nach diesem Aufruf wird der aktuelle Punkt zum Ursprung verschoben, an dem die nächste Glyphe in derselben Reihenfolge platziert werden würde. Das heißt, der aktuelle Punkt liegt am Ursprung der endgültigen Glyphe, versetzt um seine Vorwärtswerte. Dies ermöglicht die einfache Anzeige einer einzelnen logischen Zeichenkette mit mehreren Aufrufen von ccontext:ShowText().

Hinweis: Der Funktionsaufruf ccontext:ShowText() ist Teil dessen, was die Cairoer Designer als "Toy"-Text-API bezeichnen. Es ist praktisch für kurze Demos und einfache Programme, wird aber voraussichtlich nicht für ernsthafte Textanwendungen geeignet sein. Siehe ccontext:ShowGlyphs() für die "echte" Textanzeige-API in Cairo.

Eingaben
s$
Zeichenkette, die angezeigt werden soll

Navigation zeigen