TextFlow  - AS3

Configuration-objektet för det här TextFlow-objektet. Configuration-objektet anger inledande tecken-, stycke- och behållarformat samt attribut för markering, länkar, fokus och rullning.

Om du inte anger något Configuration-objekt används ett Configuration-standardobjekt i Text Layout Framework, som egenskapen defaultConfiguration sedan hänvisar till.

Relaterade API-element

Standardkonfiguration för alla nya TextFlow-objekt, om ingen konfiguration anges.

Relaterade API-element

Hanterar behållarna för det här elementet.

TextLine-objekt som skapas från elementet visas som underordnade objekt i behållaren. flowComposer hanterar behållarna, och efterhand som texten redigeras läggs rader till i eller tas bort från behållarna. flowComposer hanterar även vissa viktiga attribut, till exempel dispositionsbredd och -höjd samt om rullning är aktiverat.

Behållaren och flowComposer är nära besläktade. Om du återställer flowComposer återställs behållaren till den nya flowComposer-behållaren. På samma sätt återställs flowComposer till behållarens nya flowComposer om behållaren återställs.

Relaterade API-element

En callback-funktion för matchning av elementformat. Du kan använda detta om du exempelvis vill använda CSS-format eller namngivna format.

Relaterade API-element

Genereringsnumret för det här TextFlow-objektet. Åtgärderna undo (ångra) och redo (gör om) använder genereringsnumret för att avgöra om en åtgärd kan ångras eller göras om. Genereringsnumren måste matcha.

Varje modelländring ökar genereringsnumret, så om genereringsnumret ändras vet du att TextFlow-modellen har ändrats.

TextLayoutFormat-objektet för det här TextFlow-objektet. På så sätt kan du optimera återanvändningen av värdformat på flera sätt. Till exempel;

        textFlowA.hostFormat = textFlowB.hostFormat
        

        format = new TextLayoutFormat()
        textFlow.hostFormat = format
        format.fontSize = 24;
        

Relaterade API-element

Den InteractionManager som är kopplad till det här TextFlow-objektet.

Styr all markering och redigering av texten. Om TextFlow inte kan markeras är interactionManager null. Om TextFlow ska vara markeringsbart tilldelar du en interactionManager, som är både en ISelectionManager och en IEditManager. Om ett TextFlow ska vara skrivskyddat, men ändå tillåta markering, tilldelar du en interactionManager som bara är en ISelectionManager.

Relaterade API-element

Konstruktor – skapar en ny TextFlow-instans.

Om du anger en config-parameter kopieras innehållet i Configuration-objektet och du kan inte göra några ändringar. Du kan dock öppna konfigurationsinställningarna via egenskapen configuration. Om config-parametern är null kan du öppna standardkonfigurationsinställningarna via egenskapen defaultConfiguration.

Du kan använda Configuration-objektet för att ställa in konfigureringsbara standardattribut för ett TextFlow. Även om du inte kan ändra Configuration-objektet kan du vid behov åsidosätta standardattribut genom att ange attributen för TextFlow och dess underordnade objekt.

Relaterade API-element

Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser. Du kan registrera händelseavlyssnare på alla noder i visningslistan efter en särskild typ av händelse, fas och prioritet.

När du har registrerat en händelseavlyssnare går det inte att ändra dess prioritet genom ytterligare anrop till addEventListener(). För att kunna ändra avlyssnarens prioritet måste du först anropa removeEventListener(). Sedan går det att registrera avlyssnaren på nytt med den nya prioritetsnivån.

När avlyssnaren har registrerats resulterar efterföljande anrop till addEventListener() med ett annat värde för antingen type eller useCapture i att en separat avlyssnarregistrering skapas. Om du t.ex. först registrerar en avlyssnare med useCapture inställt på true avlyssnar den bara under hämtningsfasen. Om du anropar addEventListener() igen med samma avlyssningsobjekt men med useCapture inställt på false får du två separata avlyssnare: en som avlyssnar under hämtningsfasen och en som avlyssnar under både mål- och bubblingsfasen.

Det går inte att registrera en händelseavlyssnare endast för målfasen eller bubblingsfasen. De faserna är sammankopplade vid registreringen eftersom bubblande bara tillämpas på de som är överordnade målnoden.

När du inte längre behöver en händelseavlyssnare tar du bort den genom att anropa EventDispatcher.removeEventListener(). Annars finns risk för minnesproblem. Objekt med registrerade händelseavlyssnare tas inte automatiskt bort från minnet, eftersom skräpinsamlaren inte tar bort objekt som fortfarande har referenser.

Kopiering av en EventDispatcher-instans innebär inte att de händelseavlyssnare som är kopplade till den kopieras. (Om en nod som du nyss skapat behöver en händelseavlyssnare måste du koppla avlyssnaren efter att du skapat noden.) Om du däremot flyttar en EventDispatcher-instans flyttas den kopplade händelseavlyssnaren med.

Om händelseavlyssnaren är registrerad på en nod samtidigt som en händelse bearbetas på den noden aktiveras inte händelseavlyssnaren under den aktuella fasen, men den kan aktiveras under en senare fas i händelseflödet, t.ex. bubblingsfasen.

Om en händelseavlyssnare tas bort från en nod samtidigt som en händelse bearbetas på den noden, aktiveras den ändå av de aktuella åtgärderna. När händelseavlyssnaren tagits bort anropas den aldrig mer (om den inte registreras på nytt för framtida bearbetning).

Parametrar

Skickar en händelse till händelseflödet. Händelsemålet är det EventDispatcher-objekt som dispatchEvent() anropas till.

Parametrar

Returnerar ett element vars id-egenskap matchar parametern idName. Gör det möjligt att använda ett format baserat på id.

Följande rad anger till exempel formatet "color" som 0xFF0000 (rött), för det element vars id är span1.

         textFlow.getElementByID("span1").setStyle("color", 0xFF0000);
         

Obs! I följande kod används p.addChild(s) för att ta bort s från det ursprungliga överordnade objektet och lägga till det i p, det nya överordnade objektet.

         var s:SpanElement = new SpanElement();
         var p:ParagraphElement = new ParagraphElement();
         ...
         s = textFlow.getElementByID("span3") as SpanElement;
         p.addChild(s);
         textFlow.addChild(p);
         

Parametrar

Relaterade API-element

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 TextFlow_getElementByIDExample extends Sprite
    {
        public function TextFlow_getElementByIDExample()
        {    
            // create the TextFlow object
            var textFlow:TextFlow = new TextFlow();
            
            // xml markup that defines the attributes and contents of a text flow
            var simpleText:String = "<?xml version=\"1.0\" encoding=\"utf-8\"?>" +
            "<flow:TextFlow xmlns:flow=\"http://ns.adobe.com/textLayout/2008\" verticalScrollPolicy=\"auto\" horizontalScrollPolicy=\"auto\" fontSize=\"14\" textIndent=\"15\" marginBottom=\"15\" paddingTop=\"4\" paddingLeft=\"4\">"+
                "<flow:p>"+
                    "<flow:span id='span1'>In the first paragraph of the </flow:span>"+
                    "<flow:span id='span2' fontStyle=\"italic\">cheap </flow:span>"+
                    "<flow:span id='span3'>Western novel, a cowboy meets a saloon girl.</flow:span>"+
                "</flow:p>"+
            "</flow:TextFlow>";
            var s:SpanElement = new SpanElement();
            var s2:SpanElement = new SpanElement();
            var p:ParagraphElement = new ParagraphElement();
            // import the xml markup into a TextFlow object and display it on the stage
            textFlow = TextConverter.importToFlow(simpleText, TextConverter.TEXT_LAYOUT_FORMAT);
            // get element with ID of span3, make a copy of it
            textFlow.getElementByID("span3").setStyle("color", 0xFF0000); 
            textFlow.flowComposer.addController(new ContainerController(this, 200, 800));
            textFlow.flowComposer.updateAllControllers();
        }
    }
}

            
            

Returnerar alla element vars styleName är inställt på styleNameValue.

Parametrar

Relaterade API-element

Returnerar alla element vars typeName är inställt på typeNameValue.

Parametrar

Relaterade API-element

Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse. Då kan du bestämma var i händelseflödeshierarkin ett EventDispatcher-objekt har förändrat hanteringen av en händelsetyp. Använd IEventDispatcher.willTrigger() om du vill ta reda på om en viss händelsetyp faktiskt kommer att aktivera en händelseavlyssnare.

Skillnaden mellan hasEventListener() och willTrigger() är att hasEventListener() bara undersöker det objekt som det hör till, medan willTrigger() undersöker hela händelseflödet för händelsen som angetts av type-parametern.

Parametrar

Ogiltigförklarar all formateringsinformation för ett TextFlow så att det måste beräknas om. Anropa den här metoden när format har ändrats.

Relaterade API-element

Tar bort en avlyssnare från EventDispatcher-objektet. Ett anrop till den här metoden har ingen effekt om det inte finns någon matchande avlyssnare registrerad för EventDispatcher-objektet.

Parametrar

Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen. Den här metoden returnerar true om en händelsavlyssnare aktiveras under någon av faserna i händelseflödet när en händelse av den angivna typen skickas till det här EventDispatcher-objektet eller någon av dess underordnade.

Skillnaden mellan hasEventListener() och willTrigger() är att hasEventListener() bara undersöker det objekt som det hör till, medan willTrigger() undersöker hela händelseflödet för händelsen som angetts av type-parametern.

Parametrar

Skickas när någon klickar på en länk.

Skickas efter varje omdisposition.

Skickas av ett TextFlow-objekt varje gång det skadas. Du kan använda den här händelsen för att ta reda på om TextFlow-objektet har ändrats, men öppna inte själva TextFlow-objektet när den här händelsen skickas. Den här händelsen skickas när TextFlow-ändringar delvis har slutförts, så statusen kan vara inkonsekvent: vissa ändringar har redan slutförts, medans andra återstår. Hämta den information som behövs från händelsen och utför nödvändiga ändringar när kontrollen återgår till programmet.

Om du ändrar en åtgärd nu (när den har utförts) kan ändringen misslyckas.

Skickas när storleken på ett InlineGraphicElement ändras, på grund av att dess bredd eller höjd var inställd på auto eller procent, och bilden har lästs in helt.

Skickas när musknappen trycks ned på en länk.

Skickas när musen förs över en länk.

Skickas när musknappen släpps på en länk.

Skickas när musen flyttas bort från en länk.

Skickas när musen först förs in över en länk.

Skickas av ett TextFlow-objekt när text rullas inuti en kontrollenhetsbehållare.

Skickas när markeringen ändras. Används huvudsakligen för att uppdatera markeringsberoende användargränssnitt. Kan även användas för att ändra markeringen, men inte för att ändra själva textflödet.

Skickas av ett TextFlow-objekt varje gång en behållare får ett nytt DisplayObject tillagt eller uppdaterat på grund av disposition.