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: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flashx.textLayout.events 

DamageEvent  - AS3

Paketflashx.textLayout.events
Klassepublic class DamageEvent
VererbungDamageEvent Inheritance Event Inheritance Object

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

Eine TextFlow-Instanz löst dieses Ereignis jedes Mal aus, wenn sie als beschädigt markiert wird. Schäden können durch Änderungen am Modell oder am Layout verursacht werden.

Beispiele anzeigen

Verwandte API-Elemente



Ö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
  damageAbsoluteStart : int
[schreibgeschützt] Absoluter Beginn des Schadens
DamageEvent
  damageLength : int
[schreibgeschützt] Länge des Schadens
DamageEvent
 InheritedeventPhase : uint
[schreibgeschützt] Die aktuelle Phase im Ereignisablauf.
Event
 Inheritedtarget : Object
[schreibgeschützt] Das Ereignis-Ziel.
Event
  textFlow : flashx.textLayout.elements:TextFlow
[schreibgeschützt] TextFlow, zu dem der Schaden gehört
DamageEvent
 Inheritedtype : String
[schreibgeschützt] Der Ereignistyp.
Event
Öffentliche Methoden
 MethodeDefiniert von
  
DamageEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, textFlow:flashx.textLayout.elements:TextFlow = null, damageAbsoluteStart:int = 0, damageLength:int = 0)
Konstruktor
DamageEvent
 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
  DAMAGE : String = "damage"
[statisch] Ereignis-Typ für DamageEvent
DamageEvent
Eigenschaftendetails

damageAbsoluteStart

Eigenschaft
damageAbsoluteStart:int  [schreibgeschützt]

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

Absoluter Beginn des Schadens



Implementierung
    public function get damageAbsoluteStart():int

damageLength

Eigenschaft 
damageLength:int  [schreibgeschützt]

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

Länge des Schadens



Implementierung
    public function get damageLength():int

textFlow

Eigenschaft 
textFlow:flashx.textLayout.elements:TextFlow  [schreibgeschützt]

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

TextFlow, zu dem der Schaden gehört



Implementierung
    public function get textFlow():flashx.textLayout.elements:TextFlow
Konstruktordetails

DamageEvent

()Konstruktor
public function DamageEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, textFlow:flashx.textLayout.elements:TextFlow = null, damageAbsoluteStart:int = 0, damageLength:int = 0)

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

Konstruktor

Parameter
type:String — Textindexposition am Beginn des Schadens
 
bubbles:Boolean (default = false) — Länge des Textes, der beschädigt wurde
 
cancelable:Boolean (default = false)
 
textFlow:flashx.textLayout.elements:TextFlow (default = null)
 
damageAbsoluteStart:int (default = 0)
 
damageLength:int (default = 0)
Konstantendetails

DAMAGE

Konstante
public static const DAMAGE:String = "damage"

Ereignis-Typ für DamageEvent

DamageEvent_example.as

In diesem Beispiel wird beschrieben, wie mithilfe des DamageEvent Änderungen am TextFlow verfolgt und mit dem UpdateCompleteEvent die Bindung aktualisiert werden kann. In diesem Fall gibt es einen String, der eine Kopie des Texts im TextFlow enthält, der aktualisiert werden muss, wenn sich der TextFlow ändert. Die zwei entscheidenden Schritte sind das Aufrufen der addEventListener()-Methode und das Erstellen einer Ereignisprozedurfunktion.

Das Aufrufen der addEventListener()-Methode wird an der TextFlow-Instanz vorgenommen. Sie können einfache Strings wie "damage" und "updateComplete" verwenden, es ist jedoch sicherer, statische Konstanten wie DamageEvent.DAMAGE und UpdateCompleteEvent.UPDATE_COMPLETE zu verwenden.

package flashx.textLayout.events.examples {
    import flash.display.Sprite;
    
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.conversion.ConversionType;
    import flashx.textLayout.conversion.TextConverter;
    import flashx.textLayout.edit.EditManager;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.events.DamageEvent;
    import flashx.textLayout.events.UpdateCompleteEvent;
    
    public class DamageEvent_example extends Sprite
    {
        private var textFlow:TextFlow;
        private var text:String = "Text example";
        
        // In this example, the DamageEvent is used to mark when the text in the TextFlow has been changed,
        // so that a simple binding can be implemented that is optimized so that the binding is only updated
        // when the text is updated.
        public function DamageEvent_example()
        {
            textFlow = TextConverter.importToFlow(text, TextConverter.PLAIN_TEXT_FORMAT);
            textFlow.flowComposer.addController(new ContainerController(this, 200, 200));
            textFlow.interactionManager = new EditManager();
            textFlow.flowComposer.updateAllControllers();
                                    
            textFlow.addEventListener(DamageEvent.DAMAGE, damageHandler);
            textFlow.addEventListener(UpdateCompleteEvent.UPDATE_COMPLETE, updateHandler);
            
            // ... user clicks on the TextFlow and starts typing ...
        }
        
        private function updateHandler(event:UpdateCompleteEvent):void
        {
            if (text == null)
                text = TextConverter.export(textFlow, TextConverter.PLAIN_TEXT_FORMAT, ConversionType.STRING_TYPE) as String;
            trace(text);        // result: same as what's in the TextFlow
        }
        
        private function damageHandler(event:DamageEvent):void
        {
            text = null;
        }
    }
}




[ 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.