TextFlow  - AS3

Het Configuration-object voor dit TextFlow-object. Het Configuration-object geeft de initiële teken- en alinea-opmaken aan, alsook de initiële containeropmaak en kenmerken voor selectiemarkering, koppelingen, focus en opschuiven.

Als u geen Configuration-object opgeeft, gebruikt het Text Layout Framework een standaard Configuration-object, waarnaar wordt verwezen door de defaultConfiguration-eigenschap.

Verwante API-elementen

De standaardconfiguratie voor alle nieuwe TextFlow-objecten als de configuratie niet is opgegeven.

Verwante API-elementen

Beheert de containers voor dit element.

De textLines die van het element worden gemaakt, verschijnen als onderliggende elementen van de container. De flowComposer beheert de containers en wanneer de tekst wordt bewerkt worden er regels aan de container toegevoegd en eruit verwijderd. De flowComposer registreert een aantal belangrijke kenmerken, zoals de breedte en hoogte voor de samenstelling, of Opschuiven is ingeschakeld enz.

De container en flowComposer zijn nauw met elkaar verbonden. Als u flowComposer herstelt, wordt de container ingesteld als de nieuwe container van flowComposer. Als de container is hersteld, wordt flowComposer ingesteld als de nieuwe flowComposer van de container.

Verwante API-elementen

Een callback-functie voor het oplossen van elementstijlen. U kunt dit bijvoorbeeld gebruiken om stijlen te voorzien met behulp van CSS of benoemde stijlen.

Verwante API-elementen

Het generatiegetal voor dit TextFlow-object. De bewerkingen Ongedaan maken en Opnieuw gebruiken het generatiegetal om te valideren of het toegelaten is om een bewerking ongedaan te maken of opnieuw uit te voeren. De generatiegetallen moeten overeenkomen.

Elke modelwijziging vergroot generatie, zodat u weet dat het TextFlow-model is gewijzigd wanneer het generatiegetal is gewijzigd.

Het TextLayoutFormat-object voor dit TextFlow-object. Hiermee worden meerdere optimalisaties ingeschakeld voor het hergebruik van hostopmaken. Bijvoorbeeld;

        textFlowA.hostFormat = textFlowB.hostFormat
        

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

Verwante API-elementen

De InteractionManager die is gekoppeld aan dit TextFlow-object.

Beheert alle selectie en bewerkingen in de tekst. De interactionManager is null, als de TextFlow niet kan worden geselecteerd. Om de TextFlow te kunnen bewerken, moet u een interactionManager toewijzen die tegelijkertijd een ISelectionManager en een IEditManager is. Om een alleen-lezen-TextFlow te maken die waarin selectie mogelijk is, wijst u een interactionManager toe die alleen een ISelectionManager is.

Verwante API-elementen

Constructor: maakt een nieuwe TekstFlow-instantie.

Als u een config-parameter opgeeft, wordt de inhoud van het Configuration-object gekopieerd en kunt u geen wijzigingen maken. U kunt configuratie-instellingen echter bekijken via de Configuration-eigenschap. Als de config-parameter null is, kunt u de standaardconfiguratie-instellingen bekijken via de defaultConfiguration-eigenschap.

Het Configuration-object biedt een mechanisme voor het instellen van configureerbare standaardkenmerken op een TextFlow. U kunt geen wijzigingen in het Configuration-object maken, maar u kunt wel indien nodig standaardkenmerken negeren door de kenmerken van TextFlow en onderliggende elementen in te stellen.

Verwante API-elementen

Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. U kunt gebeurtenislisteners registreren op alle knooppunten in het weergaveoverzicht van een specifiek type gebeurtenis, fase of prioriteit.

Nadat het registreren van een gebeurtenislistener is voltooid, kunt u de prioriteit ervan niet wijzigen door extra aanroepen van addEventListener(). Wanneer u de prioriteit van een listener wilt wijzigen, moet u eerst removeEventListener() aanroepen. U kunt de listener opnieuw registreren met het nieuwe prioriteitsniveau.

Nadat de listener is geregistreerd, resulteren volgende aanroepen van addEventListener() met een andere waarde voor type of useCapture in het maken van een afzonderlijke listenerregistratie. Wanneer u bijvoorbeeld eerst een listener registreert bij useCapture ingesteld op true, luistert deze alleen tijdens de vastlegfase. Wanneer u addEventListener() opnieuw aanroept met hetzelfde listenerobject maar met useCapture ingesteld op false, hebt u twee afzonderlijke listeners: één die tijdens de vastlegfase luistert en één die tijdens de doel- en terugkoppelfasen luistert.

U kunt geen gebeurtenislistener registeren voor alleen de doel- of terugkoppelfase. Deze fasen worden bij de registratie gekoppeld, omdat terugkoppeling alleen van toepassing is op voorouders van het doelknooppunt.

Wanneer u een gebeurtenislistener niet langer nodig hebt, kunt u deze verwijderen door EventDispatcher.removeEventListener() aan te roepen; anders kan dit resulteren in geheugenproblemen. Objecten met geregistreerde gebeurtenislisteners worden niet automatisch verwijderd uit het geheugen, omdat de opschoonfunctie geen objecten verwijdert waar nog verwijzingen naar bestaan.

Het kopiëren van een instantie EventDispatcher kopieert de daaraan gekoppelde gebeurtenislisteners. (Wanneer uw nieuwe knooppunt een gebeurtenislistener nodig heeft, moet u de listener eraan koppelen na het maken van het knooppunt.) Wanneer u echter een instantie EventDispatcher verplaatst, worden de daaraan gekoppelde listeners mee verplaatst.

Wanneer de gebeurtenislistener wordt geregistreerd op een knooppunt terwijl een gebeurtenis op dit knooppunt wordt verwerkt, wordt de gebeurtenislistener niet geactiveerd tijdens de huidige fase maar kan wel worden geactiveerd in een latere fase in de gebeurtenisstroom, zoals de terugkoppelfase.

Wanneer een gebeurtenislistener wordt verwijderd uit een knooppunt terwijl een gebeurtenis wordt verwerkt op het knooppunt, wordt deze nog steeds geactiveerd door de huidige handelingen. Nadat deze is verwijderd, wordt de gebeurtenislistener niet meer aangeroepen (tenzij deze opnieuw wordt geregistreerd voor toekomstige verwerking).

Parameters

Verzendt een gebeurtenis naar de gebeurtenisstroom. Het doel van de gebeurtenis is het object EventDispatcher waar dispatchEvent() op wordt aangeroepen.

Parameters

Retourneert een element waarvan de id-eigenschap overeenkomt met de idName-parameter. Biedt de mogelijkheid om een stijl toe te passen die is gebaseerd op de id.

De volgende regel stelt bijvoorbeeld "Kleur" in op 0xFF0000 (rood) voor het element met de id span1.

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

Opmerking: in de volgende code verwijdert p.addChild(s) s uit het originele bovenliggende element en voegt het toe aan p, het nieuwe bovenliggende element.

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

Parameters

Verwante API-elementen

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();
        }
    }
}

            
            

Retourneert alle elementen waarvoor styleName is ingesteld op styleNameValue.

Parameters

Verwante API-elementen

Retourneert alle elementen waarvoor typeName is ingesteld op typeNameValue.

Parameters

Verwante API-elementen

Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. Op die manier kunt u bepalen waar een object EventDispatcher het afhandelen van een gebeurtenis in de hiërarchie van de gebeurtenisstroom heeft gewijzigd. Wanneer u wilt bepalen of een specifiek gebeurtenistype daadwerkelijk een gebeurtenislistener activeert, kunt u IEventDispatcher.willTrigger() gebruiken.

Het verschil tussen hasEventListener() en willTrigger() is dat hasEventListener() alleen het object controleert waar het toe behoort, terwijl willTrigger() de gehele gebeurtenisstroom controleert voor de gebeurtenis die is opgegeven door de parameter type.

Parameters

Maakt alle opmaakgegevens van een TextFlow ongeldig, zodat de opmaak opnieuw moet worden berekend. Roep deze methode aan wanneer er stijlen zijn gewijzigd.

Verwante API-elementen

Verwijdert een listener uit het object EventDispatcher. Wanneer geen overeenkomende listener is geregistreerd bij het object EventDispatcher, heeft een aanroep van deze methode geen invloed.

Parameters

Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. Deze methode retourneert true wanneer een gebeurtenislistener wordt geactiveerd tijdens een willekeurige fase van de gebeurtenisstroom wanneer een gebeurtenis van het opgegeven type wordt verzonden naar dit object EventDispatcher of een van de afstammingen.

Het verschil tussen hasEventListener() en willTrigger() is dat hasEventListener() alleen het object controleert waar het toe behoort, terwijl willTrigger() de gehele gebeurtenisstroom controleert voor de gebeurtenis die is opgegeven door de parameter type.

Parameters

Verzonden wanneer er op een koppeling wordt geklikt.

Verzonden nadat opnieuw is samengesteld.

Verzonden door een TextFlow-object bij beschadiging. Met deze gebeurtenis kunt u achterhalen dat de TextFlow is gewijzigd, maar u hebt geen toegang tot de TextFlow zelf wanneer deze gebeurtenis wordt verzonden. Deze gebeurtenis wordt verzonden wanneer TextFlow-wijzigingen gedeeltelijk zijn voltooid, dus deze kan zich in een inconsistente toestand bevinden; sommige wijzigingen zijn al voltooid en andere wijzigingen moeten nog worden uitgevoerd. Haal de informatie op die u nodig hebt van de gebeurtenis en maak de vereiste wijzigingen nadat de besturing teruggaat naar uw toepassing.

Het wijzigen van een bewerking mislukt mogelijk op dat moment (nadat de bewerking is uitgevoerd).

Verzonden wanneer de grootte van een InlineGraphicElement wordt aangepast omdat de breedte of hoogte is ingesteld op auto of percentage en de afbeelding net is geladen.

Verzonden wanneer op de muis wordt geklikt als deze zich boven een koppeling bevindt.

Verzonden wanneer de muis zich over een koppeling verplaatst.

Verzonden wanneer de muis wordt losgeklikt boven een koppeling.

Verzonden wanneer de muis zich niet meer in een koppeling bevindt.

Verzonden wanneer de muis zich voor het eerst in een koppeling bevindt.

Verzonden door een TextFlow-object nadat door tekst is geschoven in een controllercontainer.

Verzonden wanneer de selectie is gewijzigd. Primair gebruikt om een selectieafhankelijke gebruikersinterface bij te werken. Kan ook worden gebruikt om de selectie te wijzigen, maar niet om de TextFlow zelf te wijzigen.

Verzonden door een TextFlow-object wanneer nieuwe DisplayObjects aan een container worden toegevoegd of bijgewerkt als gevolg van een samenstelling.