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.elements 

ParagraphElement  - AS3

Paketflashx.textLayout.elements
Klassepublic final class ParagraphElement
VererbungParagraphElement Inheritance ParagraphFormattedElement Inheritance FlowGroupElement Inheritance FlowElement Inheritance Object

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

Die ParagraphElement-Klasse repräsentiert einen Absatz in der Textflusshierarchie. Das übergeordnete Element ist ein ParagraphFormattedElement und die untergeordneten Elemente können Bereiche (SpanElement), Bilder (inLineGraphicElement), Hyperlinks (LinkElement) und TCY-Elemente (Tatechuuyoko - ta-tae-chu-yo-ko) (TCYElement) enthalten. Der Absatztext wird in einem oder mehreren SpanElement-Objekten gespeichert, die die Textbereiche mit den gemeinsam verwendeten Attributen definieren. Ein TCYElement-Objekt definiert einen kurzen japanischen Text, der senkrecht zum Rest der Zeile steht, wie in einem waagerechten Text in einer senkrechten Zeile. Außerdem kann ein TCYElement mehrere Bereiche enthalten.

Standard-MXML-EigenschaftmxmlChildren

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 InheritedalignmentBaseline : *
TextLayoutFormat: Gibt die Grundlinie an, an dem die dominierende Grundlinie ausgerichtet wird.
FlowElement
 InheritedbackgroundAlpha : *
TextLayoutFormat: Alpha-Wert (Transparenz) für den Hintergrund (übernimmt Standardwert, wenn während der Kaskade nicht definiert).
FlowElement
 InheritedbackgroundColor : *
TextLayoutFormat: Hintergrundfarbe des Texts (übernimmt Standardwert, wenn während der Kaskade nicht definiert).
FlowElement
 InheritedbaselineShift : *
TextLayoutFormat: Betrag, um den die Grundlinie vom dominantBaseline-Wert verschoben wird.
FlowElement
 InheritedblockProgression : *
TextLayoutFormat: Gibt eine vertikale oder horizontale Abfolge der Zeilenplatzierung an.
FlowElement
 InheritedbreakOpportunity : *
TextLayoutFormat: Gibt die Position von Zeilenumbrüchen in einem mehrzeiligen Text an.
FlowElement
 InheritedcffHinting : *
TextLayoutFormat: Die für diesen Text verwendete Art des CFF-Hintings.
FlowElement
 InheritedclearFloats : *
TextLayoutFormat: Steuert, wie der Text bei einem Float umbricht.
FlowElement
 Inheritedcolor : *
TextLayoutFormat: Farbe des Texts.
FlowElement
 InheritedcolumnCount : *
TextLayoutFormat: Anzahl der Textspalten (übernimmt Standardwert, wenn während der Kaskade nicht definiert).
FlowElement
 InheritedcolumnGap : *
TextLayoutFormat: Gibt den Zwischenraum in Pixeln an, der zwischen den Spalten gelassen werden soll (übernimmt Standardwert, wenn während der Kaskade nicht definiert).
FlowElement
 InheritedcolumnWidth : *
TextLayoutFormat: Spaltenbreite in Pixeln (übernimmt Standardwert, wenn während der Kaskade nicht definiert).
FlowElement
 InheritedcomputedFormat : flashx.textLayout.formats:ITextLayoutFormat
[schreibgeschützt] Gibt die berechneten Formatattribute zurück, die für dieses Element wirksam sind.
FlowElement
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedcoreStyles : Object
[schreibgeschützt] Gibt die coreStyles für dieses FlowElement zurück.
FlowElement
 InheriteddigitCase : *
TextLayoutFormat: Die für diesen Text verwendete Ziffernart.
FlowElement
 InheriteddigitWidth : *
TextLayoutFormat: Die für diesen Text verwendete Ziffernbreite.
FlowElement
 Inheriteddirection : *
TextLayoutFormat: Gibt die standardmäßige bidirektionale Einbettungsebene des Texts im Textblock an.
FlowElement
 InheriteddominantBaseline : *
TextLayoutFormat: Gibt an, welche Elementgrundlinie an der alignmentBaseline ausgerichtet wird, um die vertikale Position des Elements auf der Linie zu bestimmen.
FlowElement
 InheritedfirstBaselineOffset : *
TextLayoutFormat: Gibt die Grundlinienposition der ersten Linie im Container an.
FlowElement
 InheritedfontFamily : *
TextLayoutFormat: Der Name der zu verwendenden Schriftart oder eine durch Kommas getrennte Liste mit Schriftartnamen.
FlowElement
 InheritedfontLookup : *
TextLayoutFormat: Zu verwendende Schriftartsuche.
FlowElement
 InheritedfontSize : *
TextLayoutFormat: Die Textgröße in Pixeln.
FlowElement
 InheritedfontStyle : *
TextLayoutFormat: Stil des Texts.
FlowElement
 InheritedfontWeight : *
TextLayoutFormat: Schriftartstärke.
FlowElement
 Inheritedformat : flashx.textLayout.formats:ITextLayoutFormat
Direkt für dieses Element angewendete TextLayoutFormat-Eigenschaften.
FlowElement
 Inheritedid : String
Weist einem Element einen identifizierenden Namen zu, sodass es möglich ist, einen Stil für das Element durch Verweis auf die ID festzulegen.
FlowElement
 InheritedjustificationRule : *
TextLayoutFormat: Regel zum Ausrichten von Text in einem Absatz.
FlowElement
 InheritedjustificationStyle : *
TextLayoutFormat: Der Stil, der zum Ausrichten des Absatzes verwendet wird.
FlowElement
 Inheritedkerning : *
TextLayoutFormat: Beim Kerning werden die Pixel zwischen bestimmten Zeichenpaaren angepasst, um die Lesbarkeit zu verbessern.
FlowElement
 InheritedleadingModel : *
TextLayoutFormat: Gibt das Zeilenabstandsmodell an, das eine Kombination von Zeilenabstandsbasis und Zeilenabstandsrichtung ist.
FlowElement
 InheritedligatureLevel : *
TextLayoutFormat: Steuert, welche in der Schriftart definierten Ligaturen im Text verwendet werden können.
FlowElement
 InheritedlineBreak : *
TextLayoutFormat: Steuert Zeilenumbruch im Container (übernimmt Standardwert, wenn während der Kaskade nicht definiert).
FlowElement
 InheritedlineHeight : *
TextLayoutFormat: Steuerelemente für den Zeilenabstand des Texts.
FlowElement
 InheritedlineThrough : *
TextLayoutFormat: Wenn „true“, wird Durchstreichung angewendet, d. h eine mitten durch den Text gezogene Linie.
FlowElement
 InheritedlinkActiveFormat : *
TextLayoutFormat: Definiert die Formatierungsattribute für Links im normalen Status.
FlowElement
 InheritedlinkHoverFormat : *
TextLayoutFormat: Definiert die Formatierungsattribute, die für Links verwendet werden, über die der Mauszeiger bewegt wird („Hover“-Status).
FlowElement
 InheritedlinkNormalFormat : *
TextLayoutFormat: Definiert die Formatierungsattribute für Links im normalen Status.
FlowElement
 InheritedlistAutoPadding : *
TextLayoutFormat: Legt einen automatischen Einzug für die Startkante von Listen fest, wenn der Auffüllwert der Liste auf dieser Seite „auto“ lautet.
FlowElement
 InheritedlistMarkerFormat : *
TextLayoutFormat: Definiert die Listenmarkierungen der Formatierungsattribute.
FlowElement
 InheritedlistStylePosition : *
TextLayoutFormat: Zulässige Werte sind ListStylePosition.INSIDE, ListStylePosition.OUTSIDE, FormatValue.INHERIT. Standardwert ist nicht definiert, d. h. wurde nicht festgelegt. Wenn die Eigenschaft während einer Kaskade nicht definiert ist, wird der Wert aus einem übergeordneten Element übernommen.
FlowElement
 InheritedlistStyleType : *
TextLayoutFormat: Zulässige Werte sind ListStyleType.UPPER_ALPHA, ListStyleType.LOWER_ALPHA, ListStyleType.UPPER_ROMAN, ListStyleType.LOWER_ROMAN, ListStyleType.NONE, ListStyleType.DISC, ListStyleType.CIRCLE, ListStyleType.SQUARE, ListStyleType.BOX, ListStyleType.CHECK, ListStyleType.DIAMOND, ListStyleType.HYPHEN, ListStyleType.ARABIC_INDIC, ListStyleType.BENGALI, ListStyleType.DECIMAL, ListStyleType.DECIMAL_LEADING_ZERO, ListStyleType.DEVANAGARI, ListStyleType.GUJARATI, ListStyleType.GURMUKHI, ListStyleType.KANNADA, ListStyleType.PERSIAN, ListStyleType.THAI, ListStyleType.URDU, ListStyleType.CJK_EARTHLY_BRANCH, ListStyleType.CJK_HEAVENLY_STEM, ListStyleType.HANGUL, ListStyleType.HANGUL_CONSTANT, ListStyleType.HIRAGANA, ListStyleType.HIRAGANA_IROHA, ListStyleType.KATAKANA, ListStyleType.KATAKANA_IROHA, ListStyleType.LOWER_ALPHA, ListStyleType.LOWER_GREEK, ListStyleType.LOWER_LATIN, ListStyleType.UPPER_ALPHA, ListStyleType.UPPER_GREEK, ListStyleType.UPPER_LATIN, FormatValue.INHERIT. Standardwert ist nicht definiert, d. h. wurde nicht festgelegt. Wenn die Eigenschaft während einer Kaskade nicht definiert ist, wird der Wert aus einem übergeordneten Element übernommen.
FlowElement
 Inheritedlocale : *
TextLayoutFormat: Das Gebietsschema des Texts.
FlowElement
 InheritedmxmlChildren : Array
Wendet ein Array von untergeordneten Elementen auf dieses Objekt an.
FlowGroupElement
 InheritednumChildren : int
[schreibgeschützt] Gibt die Anzahl der untergeordneten FlowElements dieses FlowGroupElement-Objekts zurück.
FlowGroupElement
 InheritedpaddingBottom : *
TextLayoutFormat: Der untere Versatz in Pixeln.
FlowElement
 InheritedpaddingLeft : *
TextLayoutFormat: Der linke Einzug in Pixeln.
FlowElement
 InheritedpaddingRight : *
TextLayoutFormat: Der rechte Einzug in Pixeln.
FlowElement
 InheritedpaddingTop : *
TextLayoutFormat: Der obere Versatz in Pixeln.
FlowElement
 InheritedparagraphEndIndent : *
TextLayoutFormat: Eine Zahl, die den Versatz des unteren Absatzrands in Pixeln angibt.
FlowElement
 InheritedparagraphSpaceAfter : *
TextLayoutFormat: Eine Zahl, die den Leerraum nach dem Absatz (in Pixeln) festlegt.
FlowElement
 InheritedparagraphSpaceBefore : *
TextLayoutFormat: Eine Zahl, die den Wert für den Leeraum vor dem Absatz in Pixeln angibt.
FlowElement
 InheritedparagraphStartIndent : *
TextLayoutFormat: Eine Zahl, die den Versatz des oberen Absatzrands angibt in Pixeln angibt.
FlowElement
 Inheritedparent : FlowGroupElement
[schreibgeschützt] Gibt das übergeordnete Element dieses FlowElement-Objekts zurück.
FlowElement
 InheritedparentRelativeEnd : int
[schreibgeschützt] Gibt das relative Ende diesesFlowElement-Objekts im übergeordneten Element zurück.
FlowElement
 InheritedparentRelativeStart : int
[schreibgeschützt] Gibt den relativen Beginn diesesFlowElement-Objekts im übergeordneten Element zurück.
FlowElement
 InheritedrenderingMode : *
TextLayoutFormat: Der für diesen Text verwendete Wiedergabemodus.
FlowElement
 InheritedstyleName : *
TextLayoutFormat: Weist einem Element eine identifizierende Klasse zu, sodass es möglich ist, einen Stil für das Element durch Verweis auf styleName festzulegen.
FlowElement
 Inheritedstyles : Object
[schreibgeschützt] Gibt die Stile für dieses FlowElement zurück.
FlowElement
 InheritedtabStops : *
TextLayoutFormat: Gibt die Tabulatoren an, die dem Absatz zugewiesen sind.
FlowElement
 InheritedtextAlign : *
TextLayoutFormat: Ausrichtung der Zeilen im Absatz relativ zum Container.
FlowElement
 InheritedtextAlignLast : *
TextLayoutFormat: Ausrichtung der letzten (oder einzigen) Zeile im Absatz relativ zum Container im ausgerichteten Text.
FlowElement
 InheritedtextAlpha : *
TextLayoutFormat: Wert für Alpha (Transparenz) des Texts.
FlowElement
 InheritedtextDecoration : *
TextLayoutFormat: Auszeichnung im Text.
FlowElement
 InheritedtextIndent : *
TextLayoutFormat: Eine Zahl, die die Einrückung der ersten Zeile des Absatzes in Pixeln festlegt.
FlowElement
 InheritedtextJustify : *
TextLayoutFormat: Gibt Optionen für die Ausrichtung des Texts an.
FlowElement
 InheritedtextLength : int
[schreibgeschützt] Gibt die Gesamtlänge des Textes, der zum FlowElement-Objekt und den untergeordneten Elementen gehört, zurück.
FlowElement
 InheritedtextRotation : *
TextLayoutFormat: Bestimmt die Gradzahl zum Drehen dieses Texts.
FlowElement
 Inheritedtracking : Object
[Nur Schreiben] Legt das Verfolgen fest und ist synonym mit der trackingRight-Eigenschaft.
FlowElement
 InheritedtrackingLeft : *
TextLayoutFormat: Zahl in Pixeln (oder Prozent der Schriftgröße, z. B. 120 %), die die Laufweite (manuelles Kerning) angibt, auf die linke Seite jedes Zeichens angewendet werden soll.
FlowElement
 InheritedtrackingRight : *
TextLayoutFormat: Zahl in Pixeln (oder Prozent der Schriftgröße, z. B. 120 %), die die Laufweite (manuelles Kerning) angibt, die auf die rechte Seite jedes Zeichens angewendet werden soll.
FlowElement
 InheritedtypeName : String
Zu jedem FlowElement gehört ein typeName.
FlowElement
 InheritedtypographicCase : *
TextLayoutFormat: Die für diesen Text verwendete typografische Buchstabenart.
FlowElement
 InheriteduserStyles : Object
Ermöglicht das Lesen und Schreiben von Benutzerstilen in einem FlowElement-Objekt.
FlowElement
 InheritedverticalAlign : *
TextLayoutFormat: Vertikale Ausrichtung oder Blocksatz (übernimmt Standardwert, wenn während der Kaskade nicht definiert).
FlowElement
 InheritedwhiteSpaceCollapse : *
TextLayoutFormat: Blendet Leerraum aus oder behält ihn bei, wenn Text in einem TextFlow importiert wird.
FlowElement
 InheritedwordSpacing : *
TextLayoutFormat: Legt den optimalen, minimalen und maximalen Abstand (als Vielfaches der Breite einer normalen Leerstelle) zwischen Wörtern fest, der beim Blocksatz verwendet wird.
FlowElement
Öffentliche Methoden
 MethodeDefiniert von
  
Konstruktor - repräsentiert einen Absatz in einem Textfluss.
ParagraphElement
 Inherited
Hängt ein untergeordnetes FlowElement-Objekt an.
FlowGroupElement
 Inherited
Fügt der festgelegten Indexposition ein untergeordnetes FlowElement-Objekt hinzu.
FlowGroupElement
 Inherited
Löscht den vom styleProp-Parameter festgelegten Stil aus diesem FlowElement-Objekt.
FlowElement
 Inherited
deepCopy(relativeStart:int = 0, relativeEnd:int = -1):FlowElement
Erstellt eine tiefe Kopie dieses FlowElement-Objekts, einschließlich untergeordneter Elemente, indem der Inhalt zwischen zwei festgelegten Zeichenpositionen kopiert und die Kopie als FlowElement-Objekt zurückgegeben wird.
FlowElement
 Inherited
Vergleicht die userStyles dieses Elements mit den userStyles anderer Elemente.
FlowElement
 Inherited
findChildIndexAtPosition(relativePosition:int):int
Diese Methode sucht für eine gegebene relative Textposition nach der Indexposition des ersten untergeordneten FlowElements, das die relative Position enthält.
FlowGroupElement
 Inherited
findLeaf(relativePosition:int):FlowLeafElement
Sucht bei einer gegebenen relativen Textposition nach dem Blattelement, das die Position enthält.
FlowGroupElement
  
findNextAtomBoundary(relativePosition:int):int
Führt einen Suchlauf vorwärts von der angegebenen Position an durch, um nach der Position im Text des nächsten Atoms zu suchen, und gibt die Indexposition zurück.
ParagraphElement
  
findNextWordBoundary(relativePosition:int):int
Gibt die Indexposition der nächsten Wortgrenze im Text zurück.
ParagraphElement
  
findPreviousAtomBoundary(relativePosition:int):int
Führt einen Suchlauf rückwärts von der zur Verfügung gestellten Position an durch, um nach der Position im Text des vorherigen Atoms zu suchen und gibt die Indexposition zurück.
ParagraphElement
  
findPreviousWordBoundary(relativePosition:int):int
Gibt die Indexposition der vorherigen Wortgrenze im Text zurück.
ParagraphElement
 Inherited
Gibt die Startposition des Elements im Textfluss als absolute Indexposition zurück.
FlowElement
 Inherited
getCharAtPosition(relativePosition:int):String
Gibt das Zeichen an der festgelegten Position relativ zu diesem FlowElement-Objekt zurück.
FlowElement
 Inherited
getCharCodeAtPosition(relativePosition:int):int
Gibt den Zeichencode an der festgelegten Position relativ zu diesem FlowElement zurück.
FlowElement
 Inherited
Gibt das untergeordnete FlowElement an der festgelegten Indexposition zurück.
FlowGroupElement
 Inherited
Sucht in untergeordneten Elementen nach dem festgelegten FlowElement-Objekt und gibt dessen Indexposition zurück.
FlowGroupElement
 Inherited
Gibt den Beginn dieses Elements relativ zu einem übergeordneten Element zurück.
FlowElement
 Inherited
Gibt das erste untergeordnete FlowLeafElement für diese Gruppe zurück.
FlowGroupElement
 Inherited
Gibt das letzte untergeordnete FlowLeafElement für diese Gruppe zurück.
FlowGroupElement
  
Gibt den Absatz zurück, der diesem folgt, oder den Wert „null“, wenn keine weiteren Absätze vorhanden sind.
ParagraphElement
 Inherited
Gibt das nächste gleichgeordnete FlowElement in der Textflusshierarchie zurück.
FlowElement
 Inherited
Gibt das mit diesem Element verknüpfte ParagraphElement-Objekt zurück.
FlowElement
  
Gibt den Absatz zurück, der diesem vorangeht, oder null, wenn dieser Absatz der erste im TextFlow ist.
ParagraphElement
 Inherited
Gibt das vorherige gleichgeordnete FlowElement in der Textflusshierarchie zurück.
FlowElement
 Inherited
getStyle(styleProp:String):*
Gibt den Wert des vom styleProp-Parameter festgelegten Stils zurück. Dieser legt den Stilnamen fest und kann einen beliebigen Benutzerstilnamen enthalten.
FlowElement
 Inherited
getText(relativeStart:int = 0, relativeEnd:int = -1, paragraphSeparator:String = " "):String
[override]
FlowGroupElement
 Inherited
Durchsucht die Textflusshierarchie in aufsteigender Richtung, um das TextFlow-Stammobjekt für das Element zurückzugeben.
FlowElement
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Wird für MXML-Objekte aufgerufen, nachdem das Implementierungsobjekt erstellt und sämtliche im MXML-Tag angegebenen Komponenteneigenschaften initialisiert wurden.
FlowElement
 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
Entfernt das angegebene untergeordnete FlowElement-Objekt aus der Gruppe.
FlowGroupElement
 Inherited
Entfernt das untergeordnete FlowElement-Objekt an der festgelegten Indexposition.
FlowGroupElement
 Inherited
replaceChildren(beginChildIndex:int, endChildIndex:int, ... rest):void
Ersetzt untergeordnete Elemente in der Gruppe durch die festgelegten neuen Elemente.
FlowGroupElement
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
setStyle(styleProp:String, newValue:*):void
Legt für den vom styleProp-Parameter festgelegten Stil den vom newValue-Parameter festgelegten Wert fest.
FlowElement
 Inherited
shallowCopy(relativeStart:int = 0, relativeEnd:int = -1):FlowElement
Erstellt eine Kopie dieses FlowElement-Objekts, indem der Inhalt zwischen zwei angegebenen Zeichenpositionen kopiert wird.
FlowElement
 Inherited
Teilt dieses Objekt an der Position, die durch den childIndex-Parameter festgelegt wurde.
FlowGroupElement
 Inherited
splitAtPosition(relativePosition:int):FlowElement
Teilt dieses FlowElement-Objekt an der vom relativePosition-Parameter angegebenen Position, die einer relativen Position im Text für dieses Element entspricht.
FlowElement
 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
Konstruktordetails

ParagraphElement

()Konstruktor
public function ParagraphElement()

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

Konstruktor - repräsentiert einen Absatz in einem Textfluss.

Methodendetails

findNextAtomBoundary

()Methode
public function findNextAtomBoundary(relativePosition:int):int

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

Führt einen Suchlauf vorwärts von der angegebenen Position an durch, um nach der Position im Text des nächsten Atoms zu suchen, und gibt die Indexposition zurück. Der Begriff Atom bezeichnet sowohl Grafikelemente als auch Zeichen (auch Gruppen von kombinierten Zeichen), die unsichtbaren Entitäten, aus denen eine Textzeile besteht.

Parameter

relativePosition:int — Startposition im Text, beginnend bei „0“

Rückgabewerte
int — Indexposition im Text des folgenden Atoms

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )

In diesem Beispiel werden die nächsten Atomgrenzen ab bestimmten Offsets in einem Absatz gefunden.
package flashx.textLayout.elements.examples
{
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class ParagraphElement_findNextAtomBoundary  extends Sprite
    {
        public function ParagraphElement_findNextAtomBoundary()
        {
            // create the TextFlow, ParagraphElement and SpanElement objects to hold paragraph
            var textFlow:TextFlow = new TextFlow();
            var paragraph:ParagraphElement = new ParagraphElement();    
            var span:SpanElement = new SpanElement();
            // assign text to the span; add span to paragraph and paragraph to TextFlow
            span.text = "Hello brave, new world!";
            paragraph.addChild(span);
            textFlow.addChild(paragraph);
            // assign a controller to the stage and update it to compose and display text
            textFlow.flowComposer.addController(new ContainerController(this, 200, 400));
            textFlow.flowComposer.updateAllControllers();
            // find the next atom boundaries from offsets 5 and 10
            var atomBoundary:int = paragraph.findNextAtomBoundary(4);                           
            trace(atomBoundary); // 5 
            atomBoundary = paragraph.findNextAtomBoundary(10);                           
            trace(atomBoundary); // 11  
        }
    }
}

findNextWordBoundary

()Methode 
public function findNextWordBoundary(relativePosition:int):int

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

Gibt die Indexposition der nächsten Wortgrenze im Text zurück.

Führt einen Suchlauf vorwärts von der angegebenen Position an durch, um nach der nächsten Position im Text zu suchen, an der ein Wort beginnt oder endet.

Parameter

relativePosition:int — Startposition im Text, beginnend bei „0“

Rückgabewerte
int — Indexposition im Text der nächsten Wortgrenze

Beispiel  ( Verwendung dieses Beispiels )

In diesem Beispiel werden die nächsten Wortgrenzen in einem Absatz ab bestimmten Offsets gefunden.
package flashx.textLayout.elements.examples
{
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class ParagraphElement_findNextWordBoundary  extends Sprite
    {
        public function ParagraphElement_findNextWordBoundary()
        {
            // create the TextFlow, ParagraphElement and SpanElement objects to hold paragraph
            var textFlow:TextFlow = new TextFlow();
            var paragraph:ParagraphElement = new ParagraphElement();    
            var span:SpanElement = new SpanElement();
            // assign text to the span; add span to paragraph and paragraph to TextFlow
            span.text = "Hello brave, new world!";
            paragraph.addChild(span);
            textFlow.addChild(paragraph);
            // assign a controller to the stage and update it to compose and display text
            textFlow.flowComposer.addController(new ContainerController(this, 200, 400));
            textFlow.flowComposer.updateAllControllers();
            // find the next word boundary from offsets 0 and 12
            var wordBoundary:int = paragraph.findNextWordBoundary(0);                           
            trace(wordBoundary); // 5 
            wordBoundary = paragraph.findNextWordBoundary(12);                           
            trace(wordBoundary); // 13        
        }
    }
}

findPreviousAtomBoundary

()Methode 
public function findPreviousAtomBoundary(relativePosition:int):int

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

Führt einen Suchlauf rückwärts von der zur Verfügung gestellten Position an durch, um nach der Position im Text des vorherigen Atoms zu suchen und gibt die Indexposition zurück. Der Begriff Atom bezeichnet sowohl Grafikelemente als auch Zeichen (auch Gruppen von kombinierten Zeichen), die unsichtbaren Entitäten, aus denen eine Textzeile besteht.

Parameter

relativePosition:int — Startposition im Text, beginnend bei „0“

Rückgabewerte
int — Indexposition im Text des vorherigen Clusters

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )

In diesem Beispiel werden die vorherigen Atomgrenzen ab bestimmten Offsets in einem Absatz gefunden.
package flashx.textLayout.elements.examples
{
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class ParagraphElement_findPreviousAtomBoundary  extends Sprite
    {
        public function ParagraphElement_findPreviousAtomBoundary()
        {
            // create the TextFlow, ParagraphElement and SpanElement objects to hold paragraph
            var textFlow:TextFlow = new TextFlow();
            var paragraph:ParagraphElement = new ParagraphElement();    
            var span:SpanElement = new SpanElement();
            // assign text to the span; add span to paragraph and paragraph to TextFlow
            span.text = "Hello brave, new world!";
            paragraph.addChild(span);
            textFlow.addChild(paragraph);
            // assign a controller to the stage and update it to compose and display text
            textFlow.flowComposer.addController(new ContainerController(this, 200, 400));
            textFlow.flowComposer.updateAllControllers();
            // find the previous atom boundaries from offsets 6 and 13
            var atomBoundary:int = paragraph.findPreviousAtomBoundary(6);                           
            trace(atomBoundary); // 5 
            atomBoundary = paragraph.findPreviousAtomBoundary(13);                           
            trace(atomBoundary); // 12      
        }
    }
}

findPreviousWordBoundary

()Methode 
public function findPreviousWordBoundary(relativePosition:int):int

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

Gibt die Indexposition der vorherigen Wortgrenze im Text zurück.

Führt einen Suchlauf rückwärts von der angegebenen Position an durch, um nach der vorherigen Position im Text zu suchen, an der ein Wort beginnt oder endet.

Parameter

relativePosition:int — Startposition im Text, beginnend bei „0“

Rückgabewerte
int — Indexposition im Text der vorherigen Wortgrenze

Beispiel  ( Verwendung dieses Beispiels )

In diesem Beispiel werden die vorherigen Wortgrenzen in einem Absatz ab bestimmten Offsets gefunden.
package flashx.textLayout.elements.examples
{
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class ParagraphElement_findPreviousWordBoundary  extends Sprite
    {
        public function ParagraphElement_findPreviousWordBoundary()
        {
            // create the TextFlow, ParagraphElement and SpanElement objects to hold paragraph
            var textFlow:TextFlow = new TextFlow();
            var paragraph:ParagraphElement = new ParagraphElement();    
            var span:SpanElement = new SpanElement();
            // assign text to the span; add span to paragraph and paragraph to TextFlow
            span.text = "Hello brave, new world!";
            paragraph.addChild(span);
            textFlow.addChild(paragraph);
            // assign a controller to the stage and update it to compose and display text
            textFlow.flowComposer.addController(new ContainerController(this, 200, 400));
            textFlow.flowComposer.updateAllControllers();
            // find the previous word boundary from offsets 0 and 12
            var wordBoundary:int = paragraph.findPreviousWordBoundary(22);                           
            trace(wordBoundary); // 17 
            wordBoundary = paragraph.findPreviousWordBoundary(11);                           
            trace(wordBoundary); // 6  
        }
    }
}

getNextParagraph

()Methode 
public function getNextParagraph():ParagraphElement

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

Gibt den Absatz zurück, der diesem folgt, oder den Wert „null“, wenn keine weiteren Absätze vorhanden sind.

Rückgabewerte
ParagraphElement — Der Textabsatz oder „null“, wenn keine weiteren Absätze vorhanden sind.

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )

In diesem Beispiel werden drei Textabsätze aus XML-Markup importiert, auf den ersten Absatz mithilfe der getChildAtIndex(0)-Methode zugegriffen und die getNextParagraph()-Methode für den Zugriff auf den zweiten Absatz verwendet.
package flashx.textLayout.elements.examples
{
    import flash.display.Sprite;
    import flashx.textLayout.conversion.TextConverter;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class ParagraphElement_getNextParagraph  extends Sprite
    {
        public function ParagraphElement_getNextParagraph()
        {
            // create TextFlow object
            var textFlow:TextFlow = new TextFlow();        
            // create content for TextFlow using XML markup
            var simpleText:String = "<?xml version=\"1.0\" encoding=\"utf-8\"?>" +
                "<flow:TextFlow xmlns:flow=\"http://ns.adobe.com/textLayout/2008\">"+
                    "<flow:p>"+
                        "<flow:span>This is the first paragraph.</flow:span>"+    
                    "</flow:p>"+
                    "<flow:p>"+
                        "<flow:span>This is the second paragraph.</flow:span>"+    
                    "</flow:p>"+
                    "<flow:p>"+
                        "<flow:span>This is the third paragraph.</flow:span>"+ 
                    "</flow:p>"+
                "</flow:TextFlow>";
            // import the xml markup into a TextFlow object and display it on the stage
            textFlow = TextConverter.importToFlow(simpleText, TextConverter.TEXT_LAYOUT_FORMAT);
            textFlow.flowComposer.addController(new ContainerController(this, 200, 400));
            textFlow.flowComposer.updateAllControllers();
            // get first paragraph
            var p:ParagraphElement = textFlow.getChildAt(0) as ParagraphElement;
            // get next paragraph and display its content
            var nextParagraph:ParagraphElement = p.getNextParagraph();
            trace("nextParagraph.text is: " + nextParagraph.getText());
        }
    }
}

getPreviousParagraph

()Methode 
public function getPreviousParagraph():ParagraphElement

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

Gibt den Absatz zurück, der diesem vorangeht, oder null, wenn dieser Absatz der erste im TextFlow ist.

Rückgabewerte
ParagraphElement

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )

In diesem Beispiel werden drei Textabsätze aus XML-Markup importiert, auf den zweiten Absatz mithilfe der getChildAtIndex(1)-Methode zugegriffen und die getPreviousParagraph()-Methode für den Zugriff auf den ersten Absatz verwendet.
package flashx.textLayout.elements.examples
{
    import flash.display.Sprite;
    import flashx.textLayout.conversion.TextConverter;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class ParagraphElement_getPreviousParagraph  extends Sprite
    {
        public function ParagraphElement_getPreviousParagraph()
        {
            // create TextFlow object
            var textFlow:TextFlow = new TextFlow();        
            // create content for TextFlow using XML markup
            var simpleText:String = "<?xml version=\"1.0\" encoding=\"utf-8\"?>" +
                "<flow:TextFlow xmlns:flow=\"http://ns.adobe.com/textLayout/2008\">"+
                    "<flow:p>"+
                        "<flow:span>This is the first paragraph.</flow:span>"+    
                    "</flow:p>"+
                    "<flow:p>"+
                        "<flow:span>This is the second paragraph.</flow:span>"+    
                    "</flow:p>"+
                    "<flow:p>"+
                        "<flow:span>This is the third paragraph.</flow:span>"+ 
                    "</flow:p>"+
                "</flow:TextFlow>";
            // import the xml markup into a TextFlow object and display it on the stage
            textFlow = TextConverter.importToFlow(simpleText, TextConverter.TEXT_LAYOUT_FORMAT);
            textFlow.flowComposer.addController(new ContainerController(this, 200, 400));
            textFlow.flowComposer.updateAllControllers();
            // get second paragraph (first = 0)
            var p:ParagraphElement = textFlow.getChildAt(1) as ParagraphElement;
            // get  previous paragraph and display its content
            var prevParagraph:ParagraphElement = p.getPreviousParagraph();
            trace("prevParagraph.text is: " + prevParagraph.getText());
        }
    }
}

ParagraphElementExample.as

In diesem Beispiel werden drei Textabsätze erstellt und formatiert.
package flashx.textLayout.elements.examples
{
    import flash.display.Sprite;
    import flash.text.engine.FontPosture;
    
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.TextLayoutFormat;

    public class ParagraphElementExample extends Sprite {
        
        // create the TextFlow object
        private var textFlow:TextFlow = new TextFlow();
        
        // Create Strings of text for the paragraphs
        private var para1String:String = "In the first paragraph of a "
        private var para1String2:String = "cheap" 
        private var para1String3:String ="Western novel, a cowboy meets a saloon girl.";
        private var para2String:String = "In the middle of the cheap novel a really bad guy, "+
                        "who is having a relationship with the saloon girl, sees the cowboy help "+
                        "her onto her horse as she smiles at him warmly."
        private var para3String:String = "In the last paragraph of the cheap novel, the cowboy kills "+
                            "the really bad guy in a shootout in the middle of main street and "+ 
                            "then rides into the sunset with the saloon girl on the back of his horse."; 
                  
        public function ParagraphElementExample()
        {
            // create a TextLayoutFormat object to use in formatting the paragraphs
            var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
            var paragraph1:ParagraphElement = new ParagraphElement();
            
            // create the ParagraphElement objects
            var paragraph2:ParagraphElement = new ParagraphElement();
            var paragraph3:ParagraphElement = new ParagraphElement();
            
            // create the SpanElement objects to hold the content of the paragraphs
            var p1Span1:SpanElement = new SpanElement();
            var p1Span2:SpanElement = new SpanElement();
            var p1Span3:SpanElement = new SpanElement();
            var p2Span:SpanElement = new SpanElement();
            var p3Span:SpanElement = new SpanElement();
            
            // assign the strings of text for the 1st paragraph to spans
            p1Span1.text = para1String;
            p1Span2.text = para1String2;
            p1Span2.fontStyle = FontPosture.ITALIC;  // italicize 'cheap'
            p1Span3.text = para1String3;
            
            // add spans to first paragraph
            paragraph1.addChild(p1Span1);
            paragraph1.addChild(p1Span2);
            paragraph1.addChild(p1Span3);
            
            // assign the string of text for the 2nd paragraph to a span
            // and add the span to the second paragraph
            p2Span.text = para2String;
            paragraph2.addChild(p2Span);
            
            // assign the string of text for the 3rd paragraph to a span
            // and add the span to the third paragraph
            p3Span.text = para3String;
            paragraph3.addChild(p3Span);
            
            // add the paragraphs to the TextFlow
            textFlow.addChild(paragraph1);
            textFlow.addChild(paragraph2);
            textFlow.addChild(paragraph3);
            
            // set the text formatting properties
            textLayoutFormat.fontSize = 14;
            textLayoutFormat.textIndent = 15;
            textLayoutFormat.paragraphSpaceAfter = 15;
            textLayoutFormat.paddingTop = 4;
            textLayoutFormat.paddingLeft = 4;
            
            // assign the format object to the TextFlow
            textFlow.hostFormat = textLayoutFormat;
            
            // assign a controller to the stage and update it to compose and 
            // display the text
            textFlow.flowComposer.addController(new ContainerController(this, 200, 400));
            textFlow.flowComposer.updateAllControllers();
        }
    }
}
ParagraphElementExample2.as

In diesem Beispiel wird ein XML-Markup in ein TextFlow-Objekt importiert. Das XML-Markup definiert die gleichen drei Textabsätze und die zugehörige Formatierung wie im vorhergehenden Beispiel.
package flashx.textLayout.elements.examples
{
    import flash.display.Sprite;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.conversion.TextConverter;
    import flashx.textLayout.container.ContainerController;
    
    public class ParagraphElementExample2 extends Sprite {
        
        // create the TextFlow object
        private var textFlow:TextFlow = new TextFlow();
        
        // xml markup that defines the attributes and contents of a text flow
        private var simpleText:String = "<?xml version=\"1.0\" encoding=\"utf-8\"?>" +
                "<flow:TextFlow xmlns:flow=\"http://ns.adobe.com/textLayout/2008\" verticalScrollPolicy=\"auto\" horizontalScrollPolicy=\"auto\" editingMode=\"readWrite\" fontSize=\"14\" textIndent=\"15\" marginBottom=\"15\" paddingTop=\"4\" paddingLeft=\"4\">"+
                    "<flow:p>"+
                        "<flow:span>In the first paragraph of a </flow:span>"+
                        "<flow:span fontStyle=\"italic\">cheap</flow:span>"+
                        "<flow:span> Western novel, a cowboy meets a saloon girl.</flow:span>"+
                    "</flow:p>"+
                    "<flow:p>"+
                        "<flow:span>In the middle of the cheap novel a really bad guy, </flow:span>"+
                        "<flow:span>who is having a relationship with the saloon girl, sees the cowboy help </flow:span>"+
                        "<flow:span>her onto her horse as she smiles at him warmly.</flow:span>"+ 
                    "</flow:p>"+
                    "<flow:p>"+
                        "<flow:span>In the last paragraph of the cheap novel, the cowboy kills the really </flow:span>"+ 
                        "<flow:span> bad guy in a shootout in the middle of main street and then rides into the sunset with </flow:span>"+
                        "<flow:span>the saloon girl on the back of his horse.</flow:span>" + 
                    "</flow:p>"+
                  "</flow:TextFlow>";
                  
        public function ParagraphElementExample2()
        {
            // import the xml markup into a TextFlow object and display it on the stage
            textFlow = TextConverter.importToFlow(simpleText, TextConverter.TEXT_LAYOUT_FORMAT);
            textFlow.flowComposer.addController(new ContainerController(this, 200, 400));
            textFlow.flowComposer.updateAllControllers();
        }
    }
}




[ 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.