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 

StandardFlowComposer  - AS3

Paketflashx.textLayout.compose
Klassepublic class StandardFlowComposer
VererbungStandardFlowComposer Inheritance FlowComposerBase Inheritance Object
Implementiert IFlowComposer

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

Die StandardFlowComposer-Klasse stellt einen Standardcomposer und Containermanager zur Verfügung.

Jedes Aufrufen von compose() oder updateAllControllers() normalisiert den Textfluss als ersten Schritt. Der Normalisierungsprozess prüft Teile des TextFlow-Objekts, die geändert wurden, und führt die folgenden Schritte aus:

  1. Löscht leere FlowLeafElement- und SubParagraphGroupElement-Objekte.
  2. Führt gleichgeordnete Bereiche zusammen, die identische Attribute aufweisen.
  3. Fügt einen leeren Absatz hinzu, wenn ein Textfluss leer ist.

Um einen StandardFlowComposer zu verwenden, weisen Sie ihn der flowComposer-Eigenschaft eines TextFlow-Objekts zu. Rufen Sie die updateAllControllers()-Methode auf, um den Text in den Containern, die an den Flow-Composer angehängt sind, anzuordnen und anzuzeigen.

Hinweis: Für einen einfachen, statischen Textfluss können Sie auch den der Factory-Klassen für die Textzeile verwenden. Diese Factory-Klassen erstellen im Allgemeinen Zeilen mit weniger Aufwand als ein Flow-Composer, aber unterstützen keine Bearbeitung, dynamischen Änderungen oder Benutzerinteraktion.

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  composing : Boolean
[schreibgeschützt] „true“, falls der Flow-Composer derzeit einen Erstellungsvorgang durchführt.
StandardFlowComposer
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheriteddamageAbsoluteStart : int
[schreibgeschützt] Die absolute Position unmittelbar vor dem ersten Element im Textfluss, für das eine Erstellung und Aktualisierung erforderlich ist.
FlowComposerBase
  numControllers : int
[schreibgeschützt] Die Anzahl der dieser IFlowComposer-Instanz zugewiesenen Container.
StandardFlowComposer
 InheritednumLines : int
[schreibgeschützt] Die Gesamtzahl der Zeilen im Textfluss.
FlowComposerBase
  rootElement : ContainerFormattedElement
[schreibgeschützt] Das mit dieser IFlowComposer-Instanz verknüpfte Stammelement.
StandardFlowComposer
 InheritedswfContext : ISWFContext
Die ISWFContext-Instanz für ggf. notwendige FTE-Aufrufe.
FlowComposerBase
 InheritedtextFlow : flashx.textLayout.elements:TextFlow
[schreibgeschützt] Das TextFlow-Objekt, an das dieser Flow-Composer angehängt wird.
FlowComposerBase
Öffentliche Methoden
 MethodeDefiniert von
  
Erstellt ein StandardFlowComposer-Objekt.
StandardFlowComposer
  
Fügt dieser IFlowComposer-Instanz einen Controller hinzu.
StandardFlowComposer
  
Fügt dieser IFlowComposer-Instanz an der angegebenen Indexposition einen Controller hinzu.
StandardFlowComposer
  
Berechnet, wie viele Zeilen erforderlich sind, um den Inhalt im Stammelement des Textflusses und die Positionen dieser Zeilen in den Anzeigecontainern des Textflusses anzuzeigen.
StandardFlowComposer
  
Erstellt den Inhalt des Stammelements bis zum und einschließlich des Containers an der angegebenen Indexposition.
StandardFlowComposer
  
composeToPosition(absolutePosition:int):Boolean
Erstellt den Inhalt des Stammelements bis zur angegebenen Position.
StandardFlowComposer
 Inherited
damage(startPosition:int, damageLength:int, damageType:String):void
Markieren Sie die Zeilen als beschädigt. Dadurch geben Sie an, dass sie neu erstellt werden müssen.
FlowComposerBase
  
findControllerIndexAtPosition(absolutePosition:int, preferPrevious:Boolean = false):int
Gibt die Indexposition des Controllers zurück, der den Inhalt an der angegebenen Position enthält.
StandardFlowComposer
 Inherited
findLineAtPosition(absolutePosition:int, preferPrevious:Boolean = false):flashx.textLayout.compose:TextFlowLine
Gibt das TextFlowLine-Objekt mit dem Inhalt an der angegebenen Position zurück.
FlowComposerBase
 Inherited
findLineIndexAtPosition(absolutePosition:int, preferPrevious:Boolean = false):int
Gibt die sequenzielle Zeilennummer des TextFlowLine-Objekts zurück, das den Inhalt an der angegebenen Position enthält.
FlowComposerBase
  
Gibt die absolute Position des ersten Inhaltselements im angegebenen ContainerController-Objekt zurück.
StandardFlowComposer
  
Gibt das ContainerController-Objekt an der angegebenen Indexposition zurück.
StandardFlowComposer
  
Gibt die Indexposition des angegebenen ContainerController-Objekts zurück.
StandardFlowComposer
 Inherited
Gibt die Zeile mit der angegebenen Zeilennummer zurück.
FlowComposerBase
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
  
Wird von TextFlow aufgerufen, wenn der Interaktionsmanager sich ändert.
StandardFlowComposer
 Inherited
isDamaged(absolutePosition:int):Boolean
Gibt an, ob TextFlowLine-Objekte zwischen dem Beginn des Textflusses und der Zeile mit dem Inhalt an der angegebenen Position als beschädigt markiert sind.
FlowComposerBase
 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
  
Entfernt alle Controller aus dieser IFlowComposer-Instanz.
StandardFlowComposer
  
Entfernt einen Controller aus dieser IFlowComposer-Instanz.
StandardFlowComposer
  
Entfernt den Controller an der angegebenen Indexposition aus dieser IFlowComposer-Instanz.
StandardFlowComposer
  
setFocus(absolutePosition:int, leanLeft:Boolean = false):void
Legt den Fokus auf den Container, der die vom absolutePosition-Parameter angegebene Position enthält.
StandardFlowComposer
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
  
StandardFlowComposer
 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
  
Erstellt den Inhalt des Stammelements und aktualisiert die Anzeige.
StandardFlowComposer
 Inherited
updateLengths(startPosition:int, deltaLength:int):void
Aktualisieren Sie die Längen in den Zeilen, um das Mapping zu TextFlow beizubehalten.
FlowComposerBase
  
Erstellt und aktualisiert die Anzeige bis zum und einschließlich des Containers an der angegebenen Indexposition.
StandardFlowComposer
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Geschützte Methoden
 MethodeDefiniert von
  
Gibt „true“ zurück, wenn die Erstellung erforderlich ist, ansonsten „false“.
StandardFlowComposer
Eigenschaftendetails

composing

Eigenschaft
composing:Boolean  [schreibgeschützt]

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

„true“, falls der Flow-Composer derzeit einen Erstellungsvorgang durchführt.



Implementierung
    public function get composing():Boolean

numControllers

Eigenschaft 
numControllers:int  [schreibgeschützt]

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

Die Anzahl der dieser IFlowComposer-Instanz zugewiesenen Container.



Implementierung
    public function get numControllers():int

rootElement

Eigenschaft 
rootElement:ContainerFormattedElement  [schreibgeschützt]

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

Das mit dieser IFlowComposer-Instanz verknüpfte Stammelement.

Nur ein TextFlow-Objekt kann ein Stammobjekt sein.



Implementierung
    public function get rootElement():ContainerFormattedElement
Konstruktordetails

StandardFlowComposer

()Konstruktor
public function StandardFlowComposer()

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

Erstellt ein StandardFlowComposer-Objekt.

Um ein StandardFlowComposer-Objekt zu verwenden, weisen Sie es der flowComposer-Eigenschaft eines TextFlow-Objekts zu. Rufen Sie die updateAllControllers()-Methode auf, um den Text in den Containern, die an den Flow-Composer angehängt sind, anzuordnen und anzuzeigen.


Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird ein Textfluss bis zum und einschließlich des Containers der 345. Position erstellt:
package flashx.textLayout.compose.examples
{
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.compose.StandardFlowComposer;

    public class StandardFlowComposer_constructor
    {
        public function createComposer(textFlow:TextFlow):void
        {
             textFlow.flowComposer = new StandardFlowComposer();
        }
    }
}
Methodendetails

addController

()Methode
public function addController(controller:ContainerController):void

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

Fügt dieser IFlowComposer-Instanz einen Controller hinzu.

Der Container wird am Ende der Containerliste hinzugefügt.

Parameter

controller:ContainerController — Das ContainerController-Objekt, das hinzugefügt werden soll.


Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird ein ContainerController erstellt und einem TextFlow-Objekt hinzugefügt:
package flashx.textLayout.compose.examples
{
    public class StandardFlowComposer_addController
    {
        import flash.display.Sprite;
        import flashx.textLayout.elements.TextFlow;
        import flashx.textLayout.container.ContainerController;
        
        public function setupController(textFlow:TextFlow):void
        {
            var container:Sprite = new Sprite();
            var controller:ContainerController = new ContainerController( container, 400, 200 );
            textFlow.flowComposer.addController( controller );
        }
    }
}

addControllerAt

()Methode 
public function addControllerAt(controller:ContainerController, index:int):void

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

Fügt dieser IFlowComposer-Instanz an der angegebenen Indexposition einen Controller hinzu.

Die Liste der Controller ist 0-basiert (der erste Controller weist die Indexposition 0 auf).

Parameter

controller:ContainerController — Das ContainerController-Objekt, das hinzugefügt werden soll.
 
index:int — Eine numerische Indexposition, die die Position in der Controller-Liste angibt, an der das ContainerController-Objekt eingefügt wird.


Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird ein ContainerController erstellt und als erster Container eines TextFlow-Objekts eingefügt:
package flashx.textLayout.compose.examples
{
    public class StandardFlowComposer_addControllerAt
    {
        import flash.display.Sprite;
        import flashx.textLayout.elements.TextFlow;
        import flashx.textLayout.container.ContainerController;
        
        public function setupController(textFlow:TextFlow):void
        {
            var container:Sprite = new Sprite();
            var controller:ContainerController = new ContainerController( container, 400, 200 );
            textFlow.flowComposer.addControllerAt( controller, 0 );
        }
    }
}

compose

()Methode 
public function compose():Boolean

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

Berechnet, wie viele Zeilen erforderlich sind, um den Inhalt im Stammelement des Textflusses und die Positionen dieser Zeilen in den Anzeigecontainern des Textflusses anzuzeigen.

Die compose()-Methode erstellt nur Inhalt, wenn er seit dem letzten Erstellungsvorgang geändert wurde. Ergebnisse werden entsprechend gespeichert, sodass folgende Aufrufe von compose() oder updateAllControllers() keine zusätzliche Neuerstellung durchführen, wenn der Inhalt des Textflusses nicht geändert wurde.

Wenn der Inhalt von Containern geändert wurde, gibt die Methode true zurück.

Rückgabewerte
Boolean — „true“, wenn etwas geändert wurde.

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird ein Textfluss erstellt:
package flashx.textLayout.compose.examples
{
    public class StandardFlowComposer_compose
    {
        import flashx.textLayout.elements.TextFlow;
        
        public function compose(textFlow:TextFlow):void
        {
            textFlow.flowComposer.compose();
        }
    }
}

composeToController

()Methode 
public function composeToController(index:int):Boolean

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

Erstellt den Inhalt des Stammelements bis zum und einschließlich des Containers an der angegebenen Indexposition.

Wenn der Inhalt von Containern bis zum und einschließlich des Containers an der angegebenen Indexposition geändert wurde, gibt die Methode true zurück. Wenn index größer als die Anzahl der Controller (oder nicht angegeben) ist, werden alle Container erstellt.

Parameter

index:int (default = NaN) — Erstellen Sie zumindest bis zu diesem Container im TextFlow. Wenn controllerIndex größer als die Anzahl der Controller ist, wird der Textfluss bis zum Ende des letzten Containers erstellt.

Rückgabewerte
Boolean — „true“, wenn etwas geändert wurde.

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird ein Textfluss bis zum vierten Container erstellt:
package flashx.textLayout.compose.examples
{
    public class StandardFlowComposer_composeToController
    {
        import flashx.textLayout.elements.TextFlow;
        
        public function compose(textFlow:TextFlow):void
        {
            textFlow.flowComposer.composeToController( 3 );
        }
    }
}

composeToPosition

()Methode 
public function composeToPosition(absolutePosition:int):Boolean

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

Erstellt den Inhalt des Stammelements bis zur angegebenen Position.

Wenn der Inhalt von Containern bis zum und einschließlich des Containers mit dem Inhalt an der angegebenen Position geändert wurde, gibt die Methode true zurück. Wenn absolutePosition größer als die Länge von TextFlow (oder nicht angegeben) ist, dann wird der gesamte Fluss erstellt.

Parameter

absolutePosition:int (default = NaN) — Erstellen Sie zumindest bis zu dieser Position im TextFlow. Standardmäßig oder wenn absolutePosition nach dem Ende des Textflusses liegt, wird der Textfluss bis zum Ende des Flusses erstellt.

Rückgabewerte
Boolean — „true“, wenn etwas geändert wurde.

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird ein Textfluss bis zum und einschließlich des Containers der 345. Position erstellt:
package flashx.textLayout.compose.examples
{
    public class StandardFlowComposer_composeToPosition
    {
        import flashx.textLayout.elements.TextFlow;
        
        public function compose(textFlow:TextFlow):void
        {
            textFlow.flowComposer.composeToPosition( 344 );
        }
    }
}

findControllerIndexAtPosition

()Methode 
public function findControllerIndexAtPosition(absolutePosition:int, preferPrevious:Boolean = false):int

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

Gibt die Indexposition des Controllers zurück, der den Inhalt an der angegebenen Position enthält.

Eine Position kann als Trennelement zwischen zwei Zeichen oder anderen Elementen eines Textflusses angesehen werden. Wenn der Wert in absolutePosition eine Position zwischen dem letzten Zeichen eines Containers und dem ersten Zeichen des nächsten ist, wird der vorhergehende Container anschließend zurückgegeben, wenn für den preferPrevious-Parameter true festgelegt wurde, der letzte Container wird zurückgegeben, falls für den preferPrevious-Parameter false festgelegt wurde.

Die Methode gibt -1 zurück, wenn der Inhalt an der angegebenen Position nicht in einem Container oder außerhalb des Bereichs der Positionen im Textfluss ist.

Parameter

absolutePosition:int — Die Position des Inhalts, für den die Containerindexposition gesucht wird.
 
preferPrevious:Boolean (default = false) — Gibt an, welche Containerindexposition zurückgegeben werden soll, wenn sich die Position zwischen dem letzten Element in einem Container und dem ersten Element im nächsten Container befindet.

Rückgabewerte
int — Die Indexposition des Container-Controllers oder -1, falls nicht gefunden.

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird die Indexposition des Containers abgerufen, der das 345. Zeichen oder ein Element eines Textflusses enthält:
package flashx.textLayout.compose.examples
{
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.compose.StandardFlowComposer;
    
    public class StandardFlowComposer_findControllerIndexAtPosition
    {
        public function findControllerIndexAtPosition(textFlow:TextFlow):void
        {
            var index:int = textFlow.flowComposer.findControllerIndexAtPosition( 344 );
        }
    }
}

getAbsoluteStart

()Methode 
public function getAbsoluteStart(controller:ContainerController):int

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

Gibt die absolute Position des ersten Inhaltselements im angegebenen ContainerController-Objekt zurück.

Eine Position wird durch Zählen der Lücken zwischen zwei Zeichen oder anderen Elementen eines Textflusses berechnet. Die Position vor dem ersten Element eines Textflusses ist null. Eine absolute Position ist die Position, die ab Beginn des Textflusses gezählt wird.

Parameter

controller:ContainerController — Ein mit diesem Flow-Composer verknüpftes ContainerController-Objekt.

Rückgabewerte
int — Die Position vor dem ersten Zeichen oder der ersten Grafik im ContainerController.

getControllerAt

()Methode 
public function getControllerAt(index:int):ContainerController

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

Gibt das ContainerController-Objekt an der angegebenen Indexposition zurück.

Parameter

index:int — Die Indexposition des ContainerController-Objekts, das zurückgegeben werden soll.

Rückgabewerte
ContainerController — Das ContainerController-Objekt an der angegebenen Position.

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird ein Verweis auf den ersten ContainerController in einem Textfluss zurückgegeben:
package flashx.textLayout.compose.examples
{
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.container.ContainerController;
    
    public class StandardFlowComposer_getControllerAt
    {
        public function findControllerIndexAtPosition(textFlow:TextFlow):void
        {
            var controller:ContainerController =  textFlow.flowComposer.getControllerAt( 0 );
        }
    }
}

getControllerIndex

()Methode 
public function getControllerIndex(controller:ContainerController):int

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

Gibt die Indexposition des angegebenen ContainerController-Objekts zurück.

Parameter

controller:ContainerController — Ein Verweis auf das ContainerController-Objekt, nach dem gesucht werden soll.

Rückgabewerte
int — Die Indexposition des angegebenen ContainerController-Objekts oder -1, wenn der Controller nicht an diesen Flow-Composer angehängt wird.

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird die Indexposition eines Controllers in einem Textfluss zurückgegeben:
package flashx.textLayout.compose.examples
{
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.container.ContainerController;
    
    public class StandardFlowComposer_getControllerIndex
    {
        public function getControllerIndex(textFlow:TextFlow, controller:ContainerController):void
        {
            var index:int =  textFlow.flowComposer.getControllerIndex( controller );
        }
    }
}

interactionManagerChanged

()Methode 
public function interactionManagerChanged(newInteractionManager:ISelectionManager):void

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

Wird von TextFlow aufgerufen, wenn der Interaktionsmanager sich ändert.

Diese Funktion wird automatisch aufgerufen. Ihr Code ruft diese Methode normalerweise nicht auf. Klassen, durch die der StandardFlowComposer erweitert wird, können diese Methode überschreiben, um Ereignis-Listener und andere Eigenschaften, die vom Interaktionsmanager abhängen, zu aktualisieren.

Parameter

newInteractionManager:ISelectionManager — Die neue ISelectionManager-Instanz.

preCompose

()Methode 
protected function preCompose():Boolean

Gibt „true“ zurück, wenn die Erstellung erforderlich ist, ansonsten „false“.

Rückgabewerte
Boolean

removeAllControllers

()Methode 
public function removeAllControllers():void

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

Entfernt alle Controller aus dieser IFlowComposer-Instanz.

removeController

()Methode 
public function removeController(controller:ContainerController):void

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

Entfernt einen Controller aus dieser IFlowComposer-Instanz.

Parameter

controller:ContainerController — Die ContainerController-Instanz, die entfernt werden soll.

removeControllerAt

()Methode 
public function removeControllerAt(index:int):void

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

Entfernt den Controller an der angegebenen Indexposition aus dieser IFlowComposer-Instanz.

Parameter

index:int — Die Indexposition des ContainerController-Objekts, das entfernt werden soll.

setFocus

()Methode 
public function setFocus(absolutePosition:int, leanLeft:Boolean = false):void

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

Legt den Fokus auf den Container, der die vom absolutePosition-Parameter angegebene Position enthält.

Der StandardFlowComposer ruft die setFocus()-Methode des ContainerController-Objekts auf, das die angegebene Textflussposition enthält.

Parameter

absolutePosition:int — Gibt die Position im Textfluss des Containers an, der den Fokus erhalten soll.
 
leanLeft:Boolean (default = false) — Im Fall von „true“ und wenn die Position vor dem ersten Zeichen in einem Container ist, wird der Fokus auf das Ende des vorherigen Containers gelegt.

Verwandte API-Elemente

setRootElement

()Methode 
public function setRootElement(newRootElement:ContainerFormattedElement):void

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

Parameter

newRootElement:ContainerFormattedElement

updateAllControllers

()Methode 
public function updateAllControllers():Boolean

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

Erstellt den Inhalt des Stammelements und aktualisiert die Anzeige.

Das Textlayout besteht aus zwei Phasen: Erstellung und Anzeige. In der Erstellungsphase berechnet der Flow-Composer die Anzahl der für die Anzeige des Inhalts erforderlichen Zeilen sowie deren Position in den Anzeigecontainern des Textflusses. In der Anzeigephase aktualisiert der Flow-Composer die untergeordneten Anzeigeobjektelemente seiner Container. Die updateAllControllers()-Methode initiiert beide Phasen der Reihe nach. Der StandardFlowComposer überwacht Änderungen am Inhalt, sodass ein vollständiger Erstellungs- und Anzeigezyklus nur durchgeführt wird, wenn Bedarf besteht.

Diese Methode aktualisiert alle Textzeilen und die Anzeigeliste sofort und synchron.

Wenn der Inhalt von Containern geändert wurde, gibt die Methode true zurück.

Rückgabewerte
Boolean — „true“, wenn etwas geändert wurde.

updateToController

()Methode 
public function updateToController(index:int):Boolean

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

Erstellt und aktualisiert die Anzeige bis zum und einschließlich des Containers an der angegebenen Indexposition.

Die updateToController()-Methode erstellt den Inhalt und aktualisiert die Anzeige aller Container bis zum und einschließlich des Containers an der angegebenen Indexposition. Beispiel: Wenn Sie in einer Kette von 20 Containern die Indexposition 10 angeben, stellt updateToController() sicher, dass die ersten zehn Container (Indexpositionen 0-9) erstellt und angezeigt werden. Die Erstellung wird an diesem Punkt beendet. Wenn controllerIndex -1 ist (oder nicht angegeben), werden alle Container aktualisiert.

Diese Methode aktualisiert alle Textzeilen und die Anzeigeliste sofort und synchron.

Wenn der Inhalt von Containern geändert wurde, gibt die Methode true zurück.

Parameter

index:int (default = NaN) — Indexposition des letzten Containers, der aktualisiert werden soll (standardmäßig werden alle Container aktualisiert).

Rückgabewerte
Boolean — Wert true, wenn etwas geändert wurde.
StandardFlowComposer_ClassExample.as

Im folgenden Beispiel wird ein Textfluss mit zwei Containern erstellt und angezeigt. Der Textfluss wird mithilfe der TextConverter importToFlow()-Methode erstellt.
package flashx.textLayout.compose.examples {
    import flash.display.Sprite;
    
    import flashx.textLayout.compose.StandardFlowComposer;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.conversion.TextConverter;
    import flashx.textLayout.elements.TextFlow;

    public class StandardFlowComposer_ClassExample extends Sprite
    {
        private var poem:String = "Sonnet 18\n" +
        "Shall I compare thee to a summer's day?\n" +
        "Thou art more lovely and more temperate:\n" +
        "Rough winds do shake the darling buds of May,\n" +
        "And summer's lease hath all too short a date:\n" +
        "Sometime too hot the eye of heaven shines,\n" +
        "And often is his gold complexion dimmed,\n" +
        "And every fair from fair sometime declines,\n" +
        "By chance, or nature's changing course untrimmed:\n" +
        "But thy eternal summer shall not fade,\n" +
        "Nor lose possession of that fair thou ow'st,\n" +
        "Nor shall death brag thou wand'rest in his shade,\n" +
        "When in eternal lines to time thou grow'st,\n" +
        "So long as men can breathe or eyes can see,\n" +
        "So long lives this, and this gives life to thee.\n" +
        "William Shakespeare\n";

        private var flow:TextFlow;

        public function StandardFlowComposer_ClassExample()
        {
            var firstContainer:Sprite = new Sprite();
            firstContainer.x = 180;
            firstContainer.y = 30;
            this.stage.addChild( firstContainer );
            
            var secondContainer:Sprite = new Sprite();
            secondContainer.x = 30;
            secondContainer.y = 130
            this.stage.addChild( secondContainer );

            var firstController:ContainerController = new ContainerController( firstContainer, 300, 100 );
            var secondController:ContainerController = new ContainerController( secondContainer, 800, 600 );

            flow = TextConverter.importToFlow( poem, TextConverter.PLAIN_TEXT_FORMAT );
            flow.flowComposer = new StandardFlowComposer();;
                        
            flow.flowComposer.addController( firstController );
            flow.flowComposer.addController( secondController );

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