Bezeichnung
TextExtent -- gibt detaillierte Informationen zu einem Textumfang zurück (V2.5)
Übersicht
extent = TextExtent(string$[, t])
Beschreibung
Dieser Befehl gibt detaillierte Informationen über den Umfang der angegebenen Zeichenfolge string$ mit den aktuellen Schriftart- und Stileinstellungen zurück. Im Gegensatz zu TextWidth(), die nur die Breite der Cursor-Vorwärtsbewegung zurückgibt, berechnet TextExtent() das exakte Grenzrechteck für die angegebene Zeichenkette.

Dieser Befehl gibt in den Feldern der Tabelle extent folgende Informationen zurück:

MinX:
Der Versatz auf der linken Seite des Rechtecks. Der ist oft negativ.

MinY:
Der Versatz von der Grundlinie bis zum oberen Rand des Rechtecks. Der ist immer negativ.

MaxX:
Der Versatz zur rechten Seite des Rechtecks.

MaxY:
Der Versatz von der Grundlinie bis zum unteren Rand des Rechtecks.

Width:
Dies ist der gleiche Wert wie beim Befehl TextWidth().

Height:
Dies ist der gleiche Wert wie beim Befehl TextHeight().

Die Werte in MinX, MinY, MaxX und MaxY beziehen sich immer auf die aktuelle Cursorposition. Wenn zum Beispiel MinX -10 ist, bedeutet dies, dass Print() diese Zeichenkette -10 Pixel von der aktuellen Cursorposition auf der X-Achse wiedergeben würde. Der Wert in Width gibt an, wo der Cursor nach dem Wiedergabevorgang enden würde. Dies ist oft weniger als MaxX-1. Im Fall von kursivem Text ist das letzte Zeichen normalerweise hinter der abschließenden Cursorposition.

Um die volle Breite der angegebenen Zeichenkette zu berechnen, subtrahiere einfach MinX von MaxX und addiere 1, d.h. Volle_Breite = MaxX - MinX + 1.

Ab Hollywood 4.7 gibt es das optionale Argument encoding, das verwendet werden kann, um die Zeichencodierung innerhalb von string$ anzugeben. Dies ist standardmäßig auf die Zeichencodierung festgelegt, die als Standardcodierung der Textbibliothek mit dem Befehl SetDefaultEncoding() festgelegt wurde. Siehe SetDefaultEncoding für Details.

Ab Hollywood 10.0 akzeptiert dieser Befehl ein optionales Tabellenargument, mit dem Sie die folgenden zusätzlichen Optionen angeben können:

Encoding:
Dieser Tag kann verwendet werden, um die von string$ verwendete Zeichencodierung anzugeben. Es wir standardmäßig die Zeichencodierung verwendet, die als Standard der Textbibliothek eingestellt ist, die mit dem Befehl SetDefaultEncoding() festgelegt wurde. Siehe SetDefaultEncoding für Details.

Charspacing:
Ermöglicht Ihnen, den Abstand zwischen den Zeichen anzupassen. Sie können diesen auf einen positiven oder negativen Wert setzen. Ein positiver Wert vergrößert den Abstand zwischen den Zeichen, ein negativer Wert verringert ihn. (V10.0)

Eingaben
string$
Quelltext
t
optional: Tabellenargument, das weitere Optionen enthält (siehe oben) (V10.0)
Rückgabewerte
extent
detaillierte Informationen über die Textdimensionen

Navigation zeigen