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...
flash.text.engine 

TextLineMirrorRegion  - AS3

Paketflash.text.engine
Klassepublic final class TextLineMirrorRegion
VererbungTextLineMirrorRegion Inheritance Object

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

Die TextLineMirrorRegion-Klasse repräsentiert einen Teil einer Textzeile, in dem Ereignisse für einen anderen Ereignisauslöser gespiegelt werden sollen.

Wenn eine Textzeile nach dem Abschluss der normalen Ereignisauslösung für die Textzeile gültig ist und die Ereignispropagierung nicht angehalten wurde, werden erneut Ereignisse für die Spiegelbereiche der Zeile ausgelöst.

Das Spiegeln von Mausereignissen ist ein Sonderfall. Da es sich bei Spiegelbereichen nicht wirklich um Anzeigeobjekte handelt, werden für mouseOver und mouseOut Ereignisse simuliert. Die rollOver und rollOut-Ereignisse werden nicht simuliert. Alle natürlich auftretenden mouseOver-, mouseOut-, rollOver- und rollOut-Ereignisse (gleichgültig, ob ihr Ziel die Textzeile oder ein untergeordnetes Element der Textzeile ist) werden ignoriert, d. h. sie werden nicht gespiegelt.

Sie können ein TextLineMirrorRegion-Objekt nicht direkt aus ActionScript-Code erstellen. Wenn Sie new TextLineMirrorRegion() aufrufen, wird ein Ausnahmefehler zurückgegeben. Es wird ein TextLineMirrorRegion-Objekt erstellt, das mit einer Textzeile verknüpft wird, wenn diese Textzeile aus einem ContentElement-Objekt mit einem Ereignisspiegel erstellt wird.

Die TextLineMirrorRegion-Klasse ist endgültig, d. h., aus ihr können keine Unterklassen abgeleitet werden.

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  bounds : Rectangle
[schreibgeschützt] Die Grenzen des Spiegelbereichs in Relation zur Textzeile.
TextLineMirrorRegion
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  element : ContentElement
[schreibgeschützt] Das ContentElement-Objekt, aus dem der Spiegelbereich abgeleitet wurde.
TextLineMirrorRegion
  mirror : EventDispatcher
[schreibgeschützt] Das EventDispatcher-Objekt, in das Ereignisse, die den Spiegelbereich betreffen, gespiegelt werden.
TextLineMirrorRegion
  nextRegion : flash.text.engine:TextLineMirrorRegion
[schreibgeschützt] Die nächste TextLineMirrorRegion im Satz, die vom Textelement abgeleitet wird, oder null, wenn der aktuelle Bereich der letzte Spiegelbereich im Satz ist.
TextLineMirrorRegion
  previousRegion : flash.text.engine:TextLineMirrorRegion
[schreibgeschützt] Die vorherige TextLineMirrorRegion im Satz, die vom Textelement abgeleitet wird, oder null, wenn der aktuelle Bereich der erste Spiegelbereich im Satz ist.
TextLineMirrorRegion
  textLine : flash.text.engine:TextLine
[schreibgeschützt] Die TextLine, die diesen Spiegelbereich enthält.
TextLineMirrorRegion
Öffentliche Methoden
 MethodeDefiniert von
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 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
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftendetails

bounds

Eigenschaft
bounds:Rectangle  [schreibgeschützt]

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

Die Grenzen des Spiegelbereichs in Relation zur Textzeile.



Implementierung
    public function get bounds():Rectangle

element

Eigenschaft 
element:ContentElement  [schreibgeschützt]

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

Das ContentElement-Objekt, aus dem der Spiegelbereich abgeleitet wurde.



Implementierung
    public function get element():ContentElement

Auslöser
IllegalOperationError — Die TextLine, zu der dieses Element gehört, ist nicht gültig.

mirror

Eigenschaft 
mirror:EventDispatcher  [schreibgeschützt]

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

Das EventDispatcher-Objekt, in das Ereignisse, die den Spiegelbereich betreffen, gespiegelt werden. Dazu gehören Mausereignisse, die speziell im Spiegelbereich auftreten, und alle anderen Ereignisse, deren Ziel die Textzeile ist.



Implementierung
    public function get mirror():EventDispatcher

nextRegion

Eigenschaft 
nextRegion:flash.text.engine:TextLineMirrorRegion  [schreibgeschützt]

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

Die nächste TextLineMirrorRegion im Satz, die vom Textelement abgeleitet wird, oder null, wenn der aktuelle Bereich der letzte Spiegelbereich im Satz ist. Kann auf der gleichen oder einer anderen Textzeile liegen.



Implementierung
    public function get nextRegion():flash.text.engine:TextLineMirrorRegion

previousRegion

Eigenschaft 
previousRegion:flash.text.engine:TextLineMirrorRegion  [schreibgeschützt]

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

Die vorherige TextLineMirrorRegion im Satz, die vom Textelement abgeleitet wird, oder null, wenn der aktuelle Bereich der erste Spiegelbereich im Satz ist. Kann auf der gleichen oder einer anderen Textzeile liegen.



Implementierung
    public function get previousRegion():flash.text.engine:TextLineMirrorRegion

textLine

Eigenschaft 
textLine:flash.text.engine:TextLine  [schreibgeschützt]

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

Die TextLine, die diesen Spiegelbereich enthält.



Implementierung
    public function get textLine():flash.text.engine:TextLine
TextLineMirrorRegionExample.as

In diesem Beispiel wird ein Textblock mit Spiegelbereichen angezeigt. Wenn Sie auf einen Spiegelbereich klicken, wird dieser rot.
package {

    import flash.display.Sprite;
    import flash.text.engine.TextBlock;
    import flash.text.engine.TextLine;
    import flash.text.engine.TextElement;
    import flash.text.engine.ElementFormat;
    import flash.text.engine.FontDescription;
    import flash.text.engine.ContentElement;
    import flash.text.engine.GroupElement;
    import flash.text.engine.TextLineMirrorRegion;
    import flash.events.MouseEvent;
    import flash.events.EventDispatcher;
    import flash.ui.Mouse;

    public class TextLineMirrorRegionExample extends Sprite {
        
        var myEvent:EventDispatcher = new EventDispatcher();
        var fontDescription:FontDescription = new FontDescription();
        var textBlock:TextBlock = new TextBlock();

        public function TextLineMirrorRegionExample():void {
            
            fontDescription.fontWeight = "bold";
            var blackFormat:ElementFormat = new ElementFormat();
            blackFormat.fontSize = 18;
            blackFormat.color = 0x000000;
            blackFormat.fontDescription = fontDescription;
            
            var textElement1 = new TextElement("Click on different parts of me to find the ", blackFormat);
            var textElement2 = new TextElement("mirror regions",blackFormat);
            var textElement3 = new TextElement(". If I am a mirror region, I'll ",blackFormat);
            var textElement4 = new TextElement("turn red",blackFormat);
            var textElement5 = new TextElement(".",blackFormat);
            
            myEvent.addEventListener("click", clickHandler);
            myEvent.addEventListener("mouseOut", mouseOutHandler);
            myEvent.addEventListener("mouseOver", mouseOverHandler);
            
            var groupVector:Vector.<ContentElement> = new Vector.<ContentElement>;
            groupVector.push(textElement1, textElement2, textElement3, textElement4, textElement5);
            var groupElement:GroupElement = new GroupElement(groupVector);
            
            textElement2.eventMirror=myEvent;
            textElement4.eventMirror=myEvent;
            
            textBlock.content = groupElement;
            createLines(textBlock);
        }
    
        private function clickHandler(event:MouseEvent):void
        {
            var redFormat:ElementFormat = new ElementFormat();
            redFormat.color = 0xCC0000;
            redFormat.fontSize = 18;
            redFormat.fontDescription = fontDescription;
            var line:TextLine = event.target as TextLine;
            var region:TextLineMirrorRegion = line.getMirrorRegion(myEvent);
            region.element.elementFormat = redFormat;
            createLines(textBlock);
        }
        
        private function mouseOverHandler(event:MouseEvent):void
        {
            Mouse.cursor = "button";
        }
        
        private function mouseOutHandler(event:MouseEvent):void
        {
            Mouse.cursor = "arrow";
        }
            
        private function createLines(textBlock:TextBlock):void 
        {
            var purgeLine:TextLine = textBlock.firstLine;
                
            while (purgeLine)
            {
                removeChild (purgeLine);
                purgeLine = purgeLine.nextLine;
            }
            var lineWidth:Number = 150;
            var xPos:Number = 15.0;
            var yPos:Number = 20.0;
            var textLine:TextLine = textBlock.createTextLine (null, lineWidth);
                
            while (textLine)
            {
                textLine.x = xPos;
                textLine.y = yPos;
                yPos += textLine.height + 2;
                addChild (textLine);
                textLine = textBlock.createTextLine (textLine, lineWidth);
            }
        }
    }
}




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