Paket | flashx.textLayout.compose |
Klasse | public final class TextFlowLine |
Vererbung | TextFlowLine Object |
Implementiert | IVerticalJustificationLine |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Verwenden Sie diese Klasse, um auf Informationen über die Zusammenstellung einer Textzeile zuzugreifen: die Position, Höhe, Breite usw. Bei einer Änderung des Textflusses (TextFlow) werden die Zeilen unmittelbar vor und an der Position der Änderung als ungültig markiert, da sie neu zusammengestellt werden müssen. Die Zeilen nach der Änderung sind möglicherweise nicht direkt beschädigt, können aber bei der Zusammenstellung des Texts neu erzeugt werden. Sie können auf eine beschädigte TextFlowLine zugreifen. Die Werte, auf die Sie zugreifen, spiegeln jedoch den alten Status des TextFlows wider. Bei der neuen Zusammenstellung des TextFlows werden neue Zeilen erzeugt und Sie erhalten die neue Zeile für eine gegebene Position durch den Aufruf von TextFlow.flowComposer.findLineAtPosition()
.
Eigenschaft | Definiert von | ||
---|---|---|---|
absoluteStart : int [schreibgeschützt]
Die Position der Zeile als absolute Zeichenposition im TextFlow-Objekt. | TextFlowLine | ||
ascent : Number [schreibgeschützt]
Gibt die Anzahl der Pixel von der Grundlinie zur Spitze des höchsten Zeichens in der Zeile an. | TextFlowLine | ||
columnIndex : int [schreibgeschützt] Die Nummer der Spalte, in die die Zeile platziert wurde, wobei die erste Spalte 0 ist. | TextFlowLine | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
controller : ContainerController [schreibgeschützt]
Die Steuerung (ContainerController-Objekt) für den Container, in dem die Zeile platziert wurde. | TextFlowLine | ||
descent : Number [schreibgeschützt]
Gibt die Anzahl der Pixel von der Grundlinie zum unteren Rand der längsten Unterlänge in der Zeile an. | TextFlowLine | ||
height : Number [schreibgeschützt] Die Zeilenhöhe in Pixeln. | TextFlowLine | ||
lineOffset : Number [schreibgeschützt]
Der Offset der Zeile in Pixeln gemäß dem entsprechenden Containereinzug (durch die Absatzausrichtung und den Durchlauf des Container-Blocks bestimmt). Dies wird vor der Zeilenausrichtung im Absatz festgelegt. | TextFlowLine | ||
location : int [schreibgeschützt]
Einer der Werte der TextFlowLineLocation zum Festlegen einer Zeilenposition innerhalb eines Absatzes. | TextFlowLine | ||
paragraph : ParagraphElement [schreibgeschützt]
Der Absatz (ParagraphElement), in dem sich die Zeile befindet. | TextFlowLine | ||
spaceAfter : Number [schreibgeschützt]
Der Leerraum, der nach der Zeile verbleiben soll. | TextFlowLine | ||
spaceBefore : Number [schreibgeschützt]
Der Leerraum, der vor der Zeile stehen soll. | TextFlowLine | ||
textHeight : Number [schreibgeschützt]
Die Höhe der Textzeile, die der Oberlänge plus der Unterlänge entspricht. | TextFlowLine | ||
textLength : int [schreibgeschützt]
Die Anzahl der Zeichen bis zur nächsten Zeile, einschließlich nachgestellter Leerstellen. | TextFlowLine | ||
textLineExists : Boolean [schreibgeschützt]
Zeigt an, ob das flash.text.engine.TextLine-Objekt für diese TextFlowLine vorhanden ist. | TextFlowLine | ||
unjustifiedTextWidth : Number [schreibgeschützt]
Die Breite der Zeile, wenn kein Blocksatz angewendet wurde. | TextFlowLine | ||
validity : String [schreibgeschützt] Die Gültigkeit der Zeile. | TextFlowLine | ||
x : Number
Die horizontale Position der Zeile relativ zu ihrem Container, ausgedrückt in Pixeln als Offset vom linken Rand des Containers. | TextFlowLine | ||
y : Number
Die vertikale Position der Zeile relativ zu ihrem Container, ausgedrückt in Pixeln als Offset vom oberen Rand des Containers. | TextFlowLine |
Methode | Definiert von | ||
---|---|---|---|
TextFlowLine(textLine:flash.text.engine:TextLine, paragraph:ParagraphElement, outerTargetWidth:Number = 0, lineOffset:Number = 0, absoluteStart:int = 0, numChars:int = 0) Konstruktor - erstellt eine neue TextFlowLine-Instanz. | TextFlowLine | ||
Gibt die Zeilenbegrenzungen als Rechteck zurück. | TextFlowLine | ||
Gibt das flash.text.engine.TextLine-Objekt für diese Zeile zurück. Ist dieses wegen des Garbagekollektors nicht mehr vorhanden, wird es eventuell neu erstellt. | TextFlowLine | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
absoluteStart | Eigenschaft |
ascent | Eigenschaft |
ascent:Number
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt die Anzahl der Pixel von der Grundlinie zur Spitze des höchsten Zeichens in der Zeile an. Für eine TextLine, die nur ein Grafikelement enthält, wird ascent
auf 0 gesetzt.
Implementierung
public function get ascent():Number
columnIndex | Eigenschaft |
controller | Eigenschaft |
controller:ContainerController
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die Steuerung (ContainerController-Objekt) für den Container, in dem die Zeile platziert wurde.
Implementierung
public function get controller():ContainerController
Verwandte API-Elemente
descent | Eigenschaft |
descent:Number
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt die Anzahl der Pixel von der Grundlinie zum unteren Rand der längsten Unterlänge in der Zeile an. Für eine TextLine, die nur ein Grafikelement enthält, wird descent
auf 0 gesetzt.
Implementierung
public function get descent():Number
height | Eigenschaft |
lineOffset | Eigenschaft |
lineOffset:Number
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der Offset der Zeile in Pixeln gemäß dem entsprechenden Containereinzug (durch die Absatzausrichtung und den Durchlauf des Container-Blocks bestimmt). Dies wird vor der Zeilenausrichtung im Absatz festgelegt.
Implementierung
public function get lineOffset():Number
location | Eigenschaft |
paragraph | Eigenschaft |
paragraph:ParagraphElement
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der Absatz (ParagraphElement), in dem sich die Zeile befindet.
Implementierung
public function get paragraph():ParagraphElement
Verwandte API-Elemente
spaceAfter | Eigenschaft |
spaceAfter:Number
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der Leerraum, der nach der Zeile verbleiben soll.
Wenn die Zeile die letzte Zeile eines Absatzes ist, die über einen anschließenden Leerraum verfügt, erhält die Zeile einen spaceAfter
-Wert. Befindet sich die Zeile am unteren Ende einer Spalte, wird spaceAfter
ignoriert. Andernfalls befindet sich die Zeile vor einer anderen Zeile in der Spalte und die folgende Zeile muss vertikal platziert werden, um sicherzustellen, dass mindestens der angegebene Leeraum zwischen dieser letzten Absatzzeile und der ersten Zeile des nächsten Absatzes vorhanden ist.
Implementierung
public function get spaceAfter():Number
Verwandte API-Elemente
spaceBefore | Eigenschaft |
spaceBefore:Number
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der Leerraum, der vor der Zeile stehen soll.
Wenn die Zeile die erste Zeile eines Absatzes ist, die über einen vorhergehenden Leerraum verfügt, erhält die Zeile einen spaceBefore
-Wert. Befindet sich die Zeile am oberen Ende einer Spalte, wird spaceBefore
ignoriert. Anderenfalls folgt die Zeile einer anderen Zeile in der Spalte und wird vertikal platziert, um sicherzustellen, dass mindestens der angegebene Leeraum zwischen dieser Zeile und der letzten Zeile des vorherigen Absatzes vorhanden ist.
Implementierung
public function get spaceBefore():Number
Verwandte API-Elemente
textHeight | Eigenschaft |
textHeight:Number
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die Höhe der Textzeile, die der Oberlänge
plus der Unterlänge
entspricht. Der Wert wird anhand der Differenz zwischen den Grundlinien berechnet, die die Zeile begrenzen. Dies ist entweder die Ober- und Unterseite von Ideogrammen oder die Oberlänge und Unterlänge, wobei dies davon abhängt, ob die Grundlinie bei y=0 ideografisch ist (z. B. TextBaseline.IDEOGRAPHIC_TOP).
Implementierung
public function get textHeight():Number
Verwandte API-Elemente
textLength | Eigenschaft |
textLineExists | Eigenschaft |
textLineExists:Boolean
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Zeigt an, ob das flash.text.engine.TextLine
-Objekt für diese TextFlowLine vorhanden ist. Der Wert ist true
, wenn das TextLine-Objekt nicht vom Garbagekollektor bereinigt wurde, andernfalls ist der Wert false
.
Implementierung
public function get textLineExists():Boolean
Verwandte API-Elemente
unjustifiedTextWidth | Eigenschaft |
unjustifiedTextWidth:Number
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die Breite der Zeile, wenn dieser kein Blocksatz zugewiesen wäre. Bei Text ohne Blocksatz ist dieser Wert gleich dem Wert von textLength
. Bei Text mit Blocksatz entspricht dieser Wert der Länge ohne Blocksatz und textLength
repräsentiert die tatsächliche Zeilenbreite. Beispiel: Wenn der folgende String im Blocksatz ausgerichtet ist und eine Breite von 500 zugewiesen wurde, beträgt die tatsächliche Breite 500, die Breite ohne Blocksatz jedoch 268.9921875.
Implementierung
public function get unjustifiedTextWidth():Number
validity | Eigenschaft |
validity:String
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die Gültigkeit der Zeile.
Eine Zeile kann ungültig sein, wenn der Text, die angewendeten Attribute oder die Steuerungseinstellungen seit der Erstellung der Zeile geändert wurden. Eine ungültige Zeile kann weiterhin angezeigt und verwendet werden, wobei jedoch die Werte verwendet werden, die bei der Erstellung aktuell waren. Die von getTextLine()
zurückgegebene Zeile hat ebenfalls den Status „ungültig“.
Implementierung
public function get validity():String
Verwandte API-Elemente
x | Eigenschaft |
x:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die horizontale Position der Zeile relativ zu ihrem Container, ausgedrückt in Pixeln als Offset vom linken Rand des Containers.
Hinweis: Auch wenn diese Eigenschaft technisch die Einstellung read-write
aufweist, sollten Sie sie wie eine Eigenschaft des Typs read-only
behandeln. Diese Set-Funktion ist nur vorhanden, um die Anforderungen der IVerticalJustificationLine-Schnittstelle zu erfüllen, die für diese Eigenschaft eine Set- und eine Get-Funktion definiert. Die Verwendung der Set-Funktion ist zwar möglich, führt jedoch zu nicht vorhersehbaren Ergebnissen.
Implementierung
public function get x():Number
public function set x(value:Number):void
Verwandte API-Elemente
y | Eigenschaft |
y:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die vertikale Position der Zeile relativ zu ihrem Container, ausgedrückt in Pixeln als Offset vom oberen Rand des Containers.
Hinweis: Auch wenn diese Eigenschaft technisch die Einstellung read-write
aufweist, sollten Sie sie wie eine Eigenschaft des Typs read-only
behandeln. Diese Set-Funktion ist nur vorhanden, um die Anforderungen der IVerticalJustificationLine-Schnittstelle zu erfüllen, die für diese Eigenschaft eine Set- und eine Get-Funktion definiert. Die Verwendung der Set-Funktion ist zwar möglich, führt jedoch zu nicht vorhersehbaren Ergebnissen.
Implementierung
public function get y():Number
public function set y(value:Number):void
Verwandte API-Elemente
TextFlowLine | () | Konstruktor |
public function TextFlowLine(textLine:flash.text.engine:TextLine, paragraph:ParagraphElement, outerTargetWidth:Number = 0, lineOffset:Number = 0, absoluteStart:int = 0, numChars:int = 0)
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Konstruktor - erstellt eine neue TextFlowLine-Instanz.
Hinweis: Dies sollte nicht von Clients aufgerufen werden. Es wird zum Schreiben eines eigenen Composers bereitgestellt.
ParametertextLine:flash.text.engine:TextLine — Das für diese Zeile zu verwendende TextLine-Anzeigeobjekt.
| |
paragraph:ParagraphElement — Der Absatz (ParagraphElement), in dem die Zeile platziert wird.
| |
outerTargetWidth:Number (default = 0 ) — Die Breite, mit der die Zeile zusammengestellt wird, ohne Einzüge.
| |
lineOffset:Number (default = 0 ) — Der Offset der Zeile in Pixeln gemäß dem entsprechenden Containereinzug (durch die Absatzausrichtung und den Durchlauf des Container-Blocks bestimmt). Dies wird vor der Zeilenausrichtung im Absatz festgelegt.
| |
absoluteStart:int (default = 0 ) — Die Zeichenposition im Textfluss, an der die Zeile beginnt.
| |
numChars:int (default = 0 ) — Die Anzahl der Zeichen in der Zeile.
|
Verwandte API-Elemente
getBounds | () | Methode |
getTextLine | () | Methode |
public function getTextLine(forceValid:Boolean = false):flash.text.engine:TextLine
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt das flash.text.engine.TextLine
-Objekt für diese Zeile zurück. Ist dieses wegen des Garbagekollektors nicht mehr vorhanden, wird es eventuell neu erstellt. Legen Sie forceValid
als true
fest, damit die TextLine neu erstellt wird. Gibt „null“ zurück, wenn die TextLine nicht neu erstellt werden kann.
Parameter
forceValid:Boolean (default = false ) — wenn „true“, wird die TextLine neu erstellt, falls sie vorhanden, aber ungültig ist.
|
flash.text.engine:TextLine — Objekt für diese Zeile oder null , wenn das TextLine-Objekt nicht neu erstellt werden kann.
|
Verwandte API-Elemente
Tue Jun 12 2018, 10:04 AM Z