TextFlow  - AS3

Das Configuration-Objekt für dieses TextFlow-Objekt. Das Configuration-Objekt legt die anfänglichen Zeichen- und Absatzformate, das anfängliche Containerformat sowie Attribute für das Hevorheben, für Hyperlinks, den Fokus und den Bildlauf fest.

Wenn Sie kein Configuration-Objekt festlegen, verwendet Text Layout Framework ein standardmäßiges Configuration-Objekt, auf das die defaultConfiguration-Eigenschaft verweist.

Verwandte API-Elemente

Standardkonfiguration für alle neuen TextFlow-Objekte, wenn keine Konfiguration festgelegt wurde.

Verwandte API-Elemente

Verwaltet die Container für dieses Element.

Die TextLines, die aus dem Element erstellt werden, erscheinen als untergeordnete Elemente des Containers. Der flowComposer verwaltet die Container und fügt ihnen während der Textbearbeitung Zeilen hinzu bzw. entfernt sie daraus. Außerdem verwaltet der flowComposer einige kritische Attribute, z. B. die Breite und Höhe beim Zusammenstellen, die Aktivierung oder Deaktivierung des Bildlaufs usw.

Der Container und flowComposer stehen in einem engen Zusammenhang. Wenn Sie flowComposer zurücksetzen, wird der Container auf den Container des neuen flowComposer zurückgesetzt. Dementsprechend wird flowComposer beim Zurücksetzen des Containers auf den neuen flowComposer des Container szurückgesetzt.

Verwandte API-Elemente

Eine Rückruf-Funktion zum Auflösen von Elementstilen. Sie können dadurch eine Formatierung mithilfe von CSS oder benannten Stilen bereitstellen.

Verwandte API-Elemente

Die Erstellungsnummer für dieses TextFlow-Objekt. Die Rückgängig- und Wiederholvorgänge überprüfen mithilfe der Erstellungsnummer, ob es zulässig ist, einen Vorgang rückgängig zu machen oder zu wiederholen. Die Erstellungsnummern müssen übereinstimmen.

Jede Modelländerung erhöht generation, sodass Sie an einer Änderung der Erstellungsnummer erkennen, dass das TextFlow-Modell geändert wurde.

Das TextLayoutFormat-Objekt für dieses TextFlow-Objekt. Dadurch werden verschiedene Optimierungen zur Wiederverwendung von Host-Formaten ermöglicht. Beispiel;

        textFlowA.hostFormat = textFlowB.hostFormat
        

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

Verwandte API-Elemente

Der diesem TextFlow-Objekt zugeordnete InteractionManager.

Steuert die gesamte Auswahl und Bearbeitung des Texts. Wenn der TextFlow nicht auswählbar ist, hat der interactionManager den Wert „null“. Weisen Sie einen interactionManager zu, der sowohl ein ISelectionManager als auch ein IEditManager ist, damit der TextFlow bearbeitbar wird. Weisen Sie einen interactionManager zu, der nur ein ISelectionManager ist, damit ein TextFlow schreibgeschützt und auswählbar wird.

Verwandte API-Elemente

Konstruktor - erstellt eine neue TextFlow-Instanz.

Wenn Sie einen config-Parameter bereitstellen, werden die Inhalte des Configuration-Objekts kopiert und Sie können keine Änderungen durchführen. Sie können jedoch über die configuration-Eigenschaft auf Konfigurationseinstellungen zugreifen. Wenn der config-Parameter „null“ ist, können Sie über die defaultConfiguration-Eigenschaft auf die Standardkonfigurationseinstellungen zugreifen.

Das Configuration-Objekt stellt einen Mechanismus zum Festlegen von konfigurierbaren Standardattributen für einen TextFlow bereit. Obwohl Sie keine Änderungen am Configuration-Objekt durchführen können, ist es möglich, Standardattribute durch Festlegen der Attribute des TextFlow und der untergeordnete Elemente festzulegen, falls erforderlich.

Verwandte API-Elemente

Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. Sie können Ereignis-Listener bei allen Knoten in der Anzeigeliste für eine bestimmte Art von Ereignis, Phase oder Priorität registrieren.

Nachdem Sie einen Ereignis-Listener erfolgreich registriert haben, können Sie seine Priorität nicht durch weitere Aufrufe von addEventListener() ändern. Um die Priorität eines Listeners zu ändern, müssen Sie zunächst removeEventListener() aufrufen. Anschließend können Sie den Listener mit der neuen Prioritätsstufe erneut aufrufen.

Nach der Registrierung des Listeners haben nachfolgende Aufrufe von addEventListener() mit einem anderen type- oder useCapture-Wert eine separate Listener-Registrierung zur Folge. Wenn Sie beispielsweise zuerst einen Listener registrieren, für den useCapture auf true gesetzt ist, wird dieser nur während der Erfassungsphase aktiv sein. Wenn Sie addEventListener() für dasselbe Listener-Objekt erneut aufrufen, diesmal aber useCapture auf false gesetzt ist, werden zwei separate Listener angelegt: einer, der während der Erfassungsphase aktiv ist und ein zweiter, der während der Ziel- und Bubbling-Phase aktiv ist.

Sie können einen Ereignis-Listener nicht nur für die Ziel- oder Bubbling-Phase registrieren. Die beiden Phasen hängen während der Registrierung immer zusammen, da Bubbling nur für übergeordnete Elemente des Zielknotens gilt.

Wenn Sie einen Ereignis-Listener nicht mehr benötigen, entfernen sie ihn, indem Sie EventDispatcher.removeEventListener() aufrufen, andernfalls könnte es zu Speicherproblemen kommen. Objekte mit registrierten Ereignis-Listenern werden nicht automatisch aus dem Speicher entfernt, da der Garbagekollektor (Speichermanagement) keine Objekte entfernt, die noch Verweise enthalten.

Beim Kopieren einer EventDispatcher-Instanz werden zugewiesene Ereignis-Listener nicht kopiert. (Wenn ein neu angelegter Knoten einen Ereignis-Listener benötigt, müssen Sie den Listener nach dem Erstellen des Knotens zuweisen.) Wenn Sie jedoch eine EventDispatcher-Instanz verschieben, werden zugewiesene Ereignis-Listener ebenfalls verschoben.

Wenn der Ereignis-Listener bei einem Knoten registriert ist und dieser Knoten ein Ereignis durchgeführt, so wird der Ereignis-Listener nicht während der aktuellen Phase ausgelöst, kann aber in einer späteren Phase im Ereignisablauf gesendet werden, etwa in der Bubbling-Phase.

Wird ein Ereignis-Listener von einem Knoten entfernt, während mit dem Knoten ein Ereignis durchgeführt wird, so wird er von den aktuellen Aktionen immer noch ausgelöst. Nachdem er entfernt worden ist, wird der Ereignis-Listener nicht wieder aufgerufen (es sei denn er wird für spätere Verarbeitungsvorgänge erneut aufgerufen).

Parameter

Sendet ein Ereignis in den Ereignisablauf. Das Ereignisziel ist das EventDispatcher-Objekt, für das die Methode dispatchEvent() aufgerufen wird.

Parameter

Gibt ein Element zurück, dessen id-Eigenschaft mit dem idName-Parameter übereinstimmt. Ermöglicht die Anwendung eines Stils anhand der id.

Beispiel: In der folgenden Zeile wird der Stil für die Farbe auf 0xFF0000 (rot) für das Element mit der id „span1“ festgelegt.

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

Hinweis: Im folgenden Code geschieht Folgendes: p.addChild(s) entfernt s vom ursprünglichen übergeordneten Element und fügt es zu p, dem neuen übergeordneten Element, hinzu.

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

Parameter

Verwandte API-Elemente

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

            
            

Gibt alle Elemente zurück, für die styleName als styleNameValue festgelegt wurde.

Parameter

Verwandte API-Elemente

Gibt alle Elemente zurück, die für typeName den Wert typeNameValue aufweisen.

Parameter

Verwandte API-Elemente

Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. Dadurch können Sie bestimmen, wo ein EventDispatcher-Objekt die Verarbeitung eines Ereignistyps in der Ereignisablaufhierarchie geändert hat. Um festzustellen, ob ein bestimmter Ereignistyp einen Ereignis-Listener auslöst, verwenden Sie IEventDispatcher.willTrigger().

Der Unterschied zwischen hasEventListener() und willTrigger() besteht darin, dass hasEventListener() nur das Objekt untersucht, zu dem es gehört, während willTrigger() den gesamten Ereignisablauf auf das im Parameter type angegebene Ereignis untersucht.

Parameter

Macht alle Formatierungsinformationen für den TextFlow ungültig, wodurch eine Neuberechnung erzwungen wird. Rufen Sie diese Methode auf, wenn Stile geändert wurden.

Verwandte API-Elemente

Entfernt einen Listener aus dem EventDispatcher-Objekt. Wenn kein entsprechender Listener mit dem EventDispatcher-Objekt registriert ist, hat ein Aufruf dieser Methode keine Auswirkungen.

Parameter

Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. Diese Methode liefert den Wert true, wenn während irgendeiner Phase des Ereignisablaufs ein Ereignis-Listener aufgerufen wird, wenn ein Ereignis des angegebenen Typs für dieses EventDispatcher-Objekt oder eines seiner nachfolgenden Elemente ausgelöst wird.

Der Unterschied zwischen hasEventListener() und willTrigger() besteht darin, dass hasEventListener() nur das Objekt untersucht, zu dem es gehört, während willTrigger() den gesamten Ereignisablauf auf das im Parameter type angegebene Ereignis untersucht.

Parameter

Ausgelöst, wenn auf eine Verknüpfung geklickt wurde.

Ausgelöst nach jeder Neuerstellung.

Wird jedes Mal durch ein TextFlow-Objekt ausgelöst, wenn dieses beschädigt wurde. Sie können mit diesem Ereignis herausfinden, ob sich der TextFlow geändert hat, aber nicht auf den TextFlow selbst zugreifen, wenn dieses Ereignis ausgesendet wurde. Dieses Ereignis wird gesendet, wenn TextFlow-Änderungen teilweise durchgeführt wurden, sodass es in einem inkonsistenten Status vorhanden sein kann: einige Änderungen wurden bereits vorgenommen, andere Änderungen sind noch ausstehend. Rufen Sie die erforderlichen Informationen vom Ereignis ab, und nehmen Sie die erforderlichen Änderungen vor, nachdem die Anwendung wieder die Steuerung erhält.

Das Ändern eines Vorgangs an dieser Stelle (nachdem er ausgeführt wurde) schlägt möglicherweise fehl.

Ausgelöst, wenn die Größe eines InlineGraphicElement entsprechend der Breiten- und Höheneinstellung als Auto- oder Prozentangabe angepasst wird und das Laden der Grafik beendet wurde.

Ausgelöst, wenn die Maustaste über einer Verknüpfung gedrückt wird.

Ausgelöst, wenn die Maus über eine Verknüpfung bewegt wird.

Ausgelöst, wenn die Maus über einer Verknüpfung losgelassen wird.

Ausgelöst, wenn die Maus von einer Verknüpfung weg bewegt wird.

Ausgelöst, wenn die Maus zuerst auf einer Verknüpfung ist.

Ausgelöst durch ein TextFlow-Objekt, nachdem für Text innerhalb eines Containers ein Bildlauf durchgeführt wurde.

Ausgelöst, sobald die Auswahl geändert wurde. Wird hauptsächlich zum Aktualisieren der von der Auswahl abhängigen Benutzeroberfläche verwendet. Kann auch zum Ändern der Auswahl, jedoch nicht zum Ändern von TextFlow selbst verwendet werden.

Wird jedes Mal durch ein TextFlow-Objekt ausgelöst, wenn einem Container neue DisplayObjects hinzugefügt wurden oder dieser aufgrund einer Zusammenstellung aktualisiert wurde.