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: AIR 30.0 und früher, Flash Player 30.0 und früher, Flash Lite 4
Flex 4.6 und früher, Flash Pro CS6 und früher
Filter ausblenden
flashx.textLayout.events 

StatusChangeEvent  - AS3

Paketflashx.textLayout.events
Klassepublic class StatusChangeEvent
VererbungStatusChangeEvent Inheritance Event Inheritance Object

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

Eine TextFlow-Instanz löst dieses Ereignis aus, wenn sich der Status eines FlowElement ändert. Dieses Ereignis kann verwendet werden, um zu ermitteln, wann ein Inline-Grafikelement vollständig geladen ist. Sie können Ihre Ereignisprozedur verwenden, um den Textfluss, basierend auf der Anwesenheit eines neu geladenen Inline-Grafikelements, erneut zusammensetzen zu lassen.

Beispiele anzeigen



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedbubbles : Boolean
[schreibgeschützt] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.
Event
 Inheritedcancelable : Boolean
[schreibgeschützt] Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.
Event
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedcurrentTarget : Object
[schreibgeschützt] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
Event
  element : FlowElement
Die FlowElement-Instanz, deren Status geändert wurde.
StatusChangeEvent
  errorEvent : ErrorEvent
Das ErrorEvent-Objekt, das als Ergebnis der Statusänderung ausgelöst wurde.
StatusChangeEvent
 InheritedeventPhase : uint
[schreibgeschützt] Die aktuelle Phase im Ereignisablauf.
Event
  status : String
Der neue Status des FlowElement.
StatusChangeEvent
 Inheritedtarget : Object
[schreibgeschützt] Das Ereignis-Ziel.
Event
 Inheritedtype : String
[schreibgeschützt] Der Ereignistyp.
Event
Öffentliche Methoden
 MethodeDefiniert von
  
StatusChangeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, element:FlowElement = null, status:String = null, errorEvent:ErrorEvent = null)
Erstellt ein Ereignisobjekt, das Informationen über Statusänderungen enthält.
StatusChangeEvent
 Inherited
Dupliziert eine Instanz einer Event-Unterklasse.
Event
 Inherited
formatToString(className:String, ... arguments):String
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen.
Event
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde.
Event
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann.
Event
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt eine Zeichenfolge zurück, die alle Eigenschaften des Ereignisobjekts enthält.
Event
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert von
  INLINE_GRAPHIC_STATUS_CHANGE : String = "inlineGraphicStatusChange"
[statisch] Definiert den Wert der type-Eigenschaft eines inlineGraphicStatusChanged-Ereignisobjekts.
StatusChangeEvent
Eigenschaftendetails

element

Eigenschaft
element:FlowElement

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

Die FlowElement-Instanz, deren Status geändert wurde.



Implementierung
    public function get element():FlowElement
    public function set element(value:FlowElement):void

Verwandte API-Elemente

errorEvent

Eigenschaft 
errorEvent:ErrorEvent

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

Das ErrorEvent-Objekt, das als Ergebnis der Statusänderung ausgelöst wurde.



Implementierung
    public function get errorEvent():ErrorEvent
    public function set errorEvent(value:ErrorEvent):void

Verwandte API-Elemente

status

Eigenschaft 
status:String

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

Der neue Status des FlowElement. Die möglichen Werte dieser Eigenschaft werden von der InlineGraphicElementStatus-Klasse definiert. Fünf statische Konstanten sind in der InlineGraphicElementStatus-Klasse verfügbar:

  • ERROR : String = "error". Beim Laden einer referenzierten Grafik ist ein Fehler aufgetreten.
  • LOADING : String = "loading". Der Ladevorgang wurde für ein Grafikelement ausgelöst (aber nicht abgeschlossen), das eine URL ist.
  • LOAD_PENDING : String = "loadPending". Das Grafikelement ist eine URL, die nicht geladen wurde.
  • READY : String = "ready". Die Grafik wurde vollständig geladen und die Größe richtig festgelegt.
  • SIZE_PENDING : String = "sizePending". Das Laden des Grafikelements mit einer automatischen oder prozentualen Breite/Höhe wurde abgeschlossen, aber es wurde nicht wieder zusammengestellt.



Implementierung
    public function get status():String
    public function set status(value:String):void

Verwandte API-Elemente

Konstruktordetails

StatusChangeEvent

()Konstruktor
public function StatusChangeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, element:FlowElement = null, status:String = null, errorEvent:ErrorEvent = null)

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

Erstellt ein Ereignisobjekt, das Informationen über Statusänderungen enthält.

Parameter
type:String — Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ von StatusChangeEvent: StatusChangeEvent.INLINE_GRAPHIC_STATUS_CHANGE;
 
bubbles:Boolean (default = false) — Gibt an, ob ein Ereignis propagiert werden kann. Dieses Ereignis propagiert nicht.
 
cancelable:Boolean (default = false) — Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann. Dieses Ereignis kann nicht abgebrochen werden.
 
element:FlowElement (default = null) — Die FlowElement-Instanz, deren Status geändert wurde.
 
status:String (default = null) — Der neue Status der FlowElement-Instanz.
 
errorEvent:ErrorEvent (default = null) — Das ErrorEvent-Objekt (sofern vorhanden), das mit dem Status verknüpft ist.
Konstantendetails

INLINE_GRAPHIC_STATUS_CHANGE

Konstante
public static const INLINE_GRAPHIC_STATUS_CHANGE:String = "inlineGraphicStatusChange"

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

Definiert den Wert der type-Eigenschaft eines inlineGraphicStatusChanged-Ereignisobjekts.

StatusChangeEvent_example.as

In diesem Beispiel wird beschrieben, wie eine Ereignisprozedur erstellt wird, die auf ein erfolgreiches Laden eines InlineGraphicElement-Objekts wartet. Die zwei entscheidenden Schritte sind, die addEventListener()-Methode für den Textfluss aufzurufen und eine Ereignisprozedur-Funktion zu erstellen.

Rufen Sie die addEventListener()-Methode auf der TextFlow-Instanz auf. Sie können den einfachen String "inlineGraphicsStatusChanged" verwenden, aber es ist sicherer, die statische Konstante StatusChangeEvent.INLINE_GRAPHIC_STATUS_CHANGE zu verwenden.

Die Ereignisprozedurfunktion in diesem Beispiel heißt statusChangeHandler(). Die Ereignisprozedur überprüft zunächst, ob die Grafik geladen ist. Wenn die Grafik geladen ist, passt die Ereignisprozedur die Höhe der Grafik an die des Texts an. Abschließend ruft die Ereignisprozedur die updateAllcontrollers()-Methode im Textfluss auf, um den Text und die Inline-Grafik erneut zusammenzustellen und anzuzeigen.

package flashx.textLayout.events.examples 
{
    import flash.display.Sprite;
    
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.InlineGraphicElement;
    import flashx.textLayout.elements.InlineGraphicElementStatus;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.events.StatusChangeEvent;

    public class StatusChangeEvent_example extends Sprite
    {
        private var _textFlow:TextFlow;
        private var _inlineGraphic:InlineGraphicElement;
        private var graphicHeight:Number;
        
        public function StatusChangeEvent_example()
        {
            _textFlow = new TextFlow();
            _textFlow.fontSize = 48;
            graphicHeight = 48
            var p:ParagraphElement = new ParagraphElement();
            _textFlow.addChild(p);
            
            var span:SpanElement = new SpanElement();
            span.text = "Text ";
            p.addChild(span);
            
            _inlineGraphic = new InlineGraphicElement();
            _inlineGraphic.source = "../../images/textLayout_TextFlow.gif";
            p.addChild(_inlineGraphic);
            
            var span2:SpanElement = new SpanElement();
            span2.text = " Flow";
            p.addChild(span2);
            
            _textFlow.addEventListener(StatusChangeEvent.INLINE_GRAPHIC_STATUS_CHANGE,statusChangeHandler);
            _textFlow.flowComposer.addController(new ContainerController(this,400,200));
            _textFlow.flowComposer.updateAllControllers();
        }    
        

        private function statusChangeHandler(e:StatusChangeEvent):void
        {
            // if the graphic has loaded update the display
            // set the loaded graphic's height to match text height
            if (e.status == InlineGraphicElementStatus.READY || e.status == InlineGraphicElementStatus.SIZE_PENDING)
            {
                _inlineGraphic.height = graphicHeight;
                _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.