ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flashx.textLayout.compose 

TextFlowLine  - AS3

Paketflashx.textLayout.compose
Klassepublic final class TextFlowLine
VererbungTextFlowLine Inheritance Object
Implementiert IVerticalJustificationLine

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Die TextFlowLine-Klasse repräsentiert eine einzelne Textzeile in einem Textfluss.

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().



Öffentliche Eigenschaften
 EigenschaftDefiniert 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
 Inheritedconstructor : 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
Öffentliche Methoden
 MethodeDefiniert 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
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftendetails

absoluteStart

Eigenschaft
absoluteStart:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Die Position der Zeile als absolute Zeichenposition im TextFlow-Objekt.



Implementierung
    public function get absoluteStart():int

Verwandte API-Elemente

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 
columnIndex:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Die Nummer der Spalte, in die die Zeile platziert wurde, wobei die erste Spalte 0 ist.



Implementierung
    public function get columnIndex():int

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 
height:Number  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Die Zeilenhöhe in Pixeln.



Implementierung
    public function get height():Number

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 
location:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Einer der Werte der TextFlowLineLocation zum Festlegen einer Zeilenposition innerhalb eines Absatzes.



Implementierung
    public function get location():int

Verwandte API-Elemente

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 
textLength:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Die Anzahl der Zeichen bis zur nächsten Zeile, einschließlich nachgestellter Leerstellen.



Implementierung
    public function get textLength():int

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

Konstruktordetails

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.

Parameter
textLine: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

Methodendetails

getBounds

()Methode
public function getBounds():Rectangle

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Gibt die Zeilenbegrenzungen als Rechteck zurück.

Rückgabewerte
Rectangle — Ein Rechteck, das die Abgrenzungen der Zeile repräsentiert.

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.

Rückgabewerte
flash.text.engine:TextLine — Objekt für diese Zeile oder null, wenn das TextLine-Objekt nicht neu erstellt werden kann.

Verwandte API-Elemente





[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.