ActionScript® 3.0 — dokumentacja dla platformy Adobe® Flash®
Strona główna  |  Ukryj listę pakietów i klas |  Pakiety  |  Klasy  |  Nowości  |  Indeks  |  Dodatki  |  Dlaczego język angielski?
Filtry: Pobieranie danych z serwera...
Pobieranie danych z serwera...
flashx.textLayout.events 

StatusChangeEvent  - AS3

Pakietflashx.textLayout.events
Klasapublic class StatusChangeEvent
DziedziczenieStatusChangeEvent Inheritance Event Inheritance Object

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Instancja klasy TextFlow wywołuje to zdarzenie przy zmianie statusu obiektu FlowElement. To zdarzenie może służyć do sprawdzania, czy zakończyło się ładowanie wstawianego elementu graficznego. Za pomocą procedury obsługi zdarzeń można zmienić przepływ tekstu w zależności od tego, czy istnieje nowy wstawiany element graficzny.

Wyświetl przykłady



Właściwości publiczne
 WłaściwośćZdefiniowane przez
 Inheritedbubbles : Boolean
[tylko do odczytu] Określa, czy zdarzenie może przechodzić fazę propagacji.
Event
 Inheritedcancelable : Boolean
[tylko do odczytu] Wskazuje, czy można uniemożliwić operacje skojarzone ze zdarzeniem.
Event
 Inheritedconstructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.
Object
 InheritedcurrentTarget : Object
[tylko do odczytu] Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
Event
  element : FlowElement
Instancja klasy FlowElement, której status został zmieniony.
StatusChangeEvent
  errorEvent : ErrorEvent
Obiekt ErrorEvent, który został wywołany w wyniku zmiany statusu.
StatusChangeEvent
 InheritedeventPhase : uint
[tylko do odczytu] Bieżąca faza przepływu zdarzeń.
Event
  status : String
Nowy status obiektu FlowElement.
StatusChangeEvent
 Inheritedtarget : Object
[tylko do odczytu] Miejsce docelowe zdarzenia.
Event
 Inheritedtype : String
[tylko do odczytu] Typ zdarzenia.
Event
Metody publiczne
 MetodaZdefiniowane przez
  
StatusChangeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, element:FlowElement = null, status:String = null, errorEvent:ErrorEvent = null)
Tworzy obiekt zdarzenia, który zawiera informacje o zmianie statusu.
StatusChangeEvent
 Inherited
Powiela instancję podklasy Event.
Event
 Inherited
formatToString(className:String, ... arguments):String
Funkcja narzędziowa umożliwiająca implementację metody toString() w niestandardowych klasach Event w języku ActionScript 3.0.
Event
 Inherited
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.
Object
 Inherited
Sprawdza, czy w odniesieniu do tego zdarzenia wywołano metodę preventDefault().
Event
 Inherited
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.
Object
 Inherited
Anuluje domyślne ustawienia zdarzenia, o ile zachowanie to może być anulowane.
Event
 Inherited
Wskazuje, czy określona właściwość istnieje i jest przeliczalna.
Object
 Inherited
Ustawia dostępność właściwości dynamicznej używanej w pętlach.
Object
 Inherited
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węźle bieżącym i węzłach następujących po nim.
Event
 Inherited
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węzłach następujących po węźle bieżącym w przepływie zdarzeń.
Event
 Inherited
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.
Object
 Inherited
Zwraca ciąg znaków, który zawiera wszystkie właściwości obiektu Event.
Event
 Inherited
Zwraca pierwotną wartość dla określonego obiektu.
Object
Stałe publiczne
 StałaZdefiniowane przez
  INLINE_GRAPHIC_STATUS_CHANGE : String = "inlineGraphicStatusChange"
[statyczny] Definiuje wartość właściwości type obiektu zdarzenia inlineGraphicStatusChanged.
StatusChangeEvent
Szczegół właściwości

element

właściwość
element:FlowElement

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Wystąpienie klasy FlowElement, którego stan uległ zmianie.



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

Powiązane elementy interfejsu API

errorEvent

właściwość 
errorEvent:ErrorEvent

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Obiekt ErrorEvent, który został wywołany w wyniku zmiany stanu.



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

Powiązane elementy interfejsu API

status

właściwość 
status:String

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Nowy status obiektu FlowElement. Możliwe wartości tej właściwości są zdefiniowane w klasie InlineGraphicElementStatus. W klasie InlineGraphicElementStatus zdefiniowanych jest pięć statycznych stałych:

  • ERROR : String = "error". Wystąpił błąd podczas wczytywania grafiki, do której istnieje odniesienie.
  • LOADING : String = "loading". Operacja wczytywania została zainicjowana (ale niezakończona) na elemencie graficznym, który jest adresem URL.
  • LOAD_PENDING : String = "loadPending". Element graficzny jest adresem URL, który nie został wczytany.
  • READY : String = "ready". Grafika została poprawnie wczytana i ma odpowiednią wielkość.
  • SIZE_PENDING : String = "sizePending". Element graficzny z wysokością/szerokością automatyczną lub procentową został wczytany, ale jego układ nie został ponownie określony.



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

Powiązane elementy interfejsu API

Konstruktor Szczegół

StatusChangeEvent

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Tworzy obiekt zdarzenia, który zawiera informacje o zmianie stanu.

Parametry
type:String — Typ zdarzenia. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem dziedziczonej właściwości type. Istnieje tylko jeden typ zdarzenia StatusChangeEvent: StatusChangeEvent.INLINE_GRAPHIC_STATUS_CHANGE;
 
bubbles:Boolean (default = false) — Określa, czy zdarzenie jest zdarzeniem propagowanym. To zdarzenie nie jest propagowane.
 
cancelable:Boolean (default = false) — Wskazuje, czy można uniemożliwić operacje skojarzone ze zdarzeniem. Tego zdarzenia nie można anulować.
 
element:FlowElement (default = null) — Wystąpienie klasy FlowElement, którego stan uległ zmianie.
 
status:String (default = null) — Nowy status instancji klasy FlowElement.
 
errorEvent:ErrorEvent (default = null) — Obiekt ErrorEvent (jeśli istnieje) skojarzony z tym statusem.
Szczegół stałej

INLINE_GRAPHIC_STATUS_CHANGE

Stała
public static const INLINE_GRAPHIC_STATUS_CHANGE:String = "inlineGraphicStatusChange"

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5

Definiuje wartość właściwości type obiektu zdarzenia inlineGraphicStatusChanged.

StatusChangeEvent_example.as

Ten przykład ilustruje sposób tworzenia detektora zdarzeń do wykrywania pomyślnego załadowania obiektu InlineGraphicElement. Dwa główne etapy to wywołanie metody addEventListener() w przepływie tekstu oraz utworzenie funkcji procedury obsługi zdarzeń.

Wywołaj metodę addEventListener() dla instancji TextFlow. Można użyć prostego ciągu "inlineGraphicsStatusChanged", ale bezpieczniejsze jest użycie statycznej stałej StatusChangeEvent.INLINE_GRAPHIC_STATUS_CHANGE

Funkcja detektora zdarzeń w tym przykładzie ma nazwę statusChangeHandler(). Detektor zdarzeń sprawdza najpierw, czy została załadowana grafika. Jeśli grafika została załadowana, detektor zdarzeń dopasowuje jej wysokość, aby była zgodna z wysokością tekstu. Na koniec detektor zdarzeń wywołuje metodę updateAllcontrollers() dla przepływu tekstu, aby dokonać ponownej kompozycji i wyświetlić tekst oraz wstawiane grafiki.

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 ]Dlaczego język angielski?
Treść dokumentacji języka ActionScript 3.0 wyświetlana w języku angielskim

Niektóre części dokumentacji języka ActionScript 3.0 nie są przetłumaczone na poszczególne języki. Gdy element nie jest przetłumaczony na dany język, jest wyświetlany tekst angielski. Na przykład opis klasy ga.controls.HelpBox nie jest przetłumaczony na żaden dodatkowy język. Z tego powodu polska wersja dokumentacji zawiera opis klasy ga.controls.HelpBox w języku angielskim.