Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
flash.text.engine 

TextLineMirrorRegion  - AS3

Packageflash.text.engine
Classepublic final class TextLineMirrorRegion
HéritageTextLineMirrorRegion Inheritance Object

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

La classe TextLineMirrorRegion représente une portion de ligne de texte dans laquelle des événements sont mis en miroir vers un autre diffuseur d’événements.

Après un déclenchement normal d’événements pour une ligne de texte, si la ligne est valide et si la propagation d’événements n’a pas été interrompue, les événements sont redistribués aux zones miroir de la ligne.

La mise en miroir des événements de souris est un cas à part. Etant donné que les zones miroir ne sont pas des objets d’affichage, les événements mouseOver et mouseOut sont simulés à leur place. Les événements rollOver et rollOut ne sont pas simulés. Tous les événements mouseOver, mouseOut, rollOver et rollOut qui se produisent naturellement (ciblés à la ligne de texte ou aux enfants de la ligne de texte) sont ignorés et ne sont donc pas mis en miroir.

Il est impossible de créer un objet TextLineMirrorRegion directement à partir du code ActionScript. Si vous appelez new TextLineMirrorRegion(), une exception est renvoyée. Un objet TextLineMirrorRegion est créé, puis associé à une ligne de texte lorsque cette dernière est créée à partir d’un objet ContentElement ayant défini un miroir d’événement.

La classe TextLineMirrorRegion ne gère pas les sous-classes.

Consulter les exemples

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
  bounds : Rectangle
[lecture seule] Limites de la zone miroir, par rapport à la ligne de texte.
TextLineMirrorRegion
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
  element : ContentElement
[lecture seule] Objet ContentElement à partir duquel la zone miroir est dérivée.
TextLineMirrorRegion
  mirror : EventDispatcher
[lecture seule] Objet EventDispatcher vers lequel les événements affectant la zone miroir sont mis en miroir.
TextLineMirrorRegion
  nextRegion : flash.text.engine:TextLineMirrorRegion
[lecture seule] TextLineMirrorRegion suivant dans l’ensemble dérivé de l’élément de texte, ou null si la zone actuelle est la dernière zone miroir de l’ensemble.
TextLineMirrorRegion
  previousRegion : flash.text.engine:TextLineMirrorRegion
[lecture seule] TextLineMirrorRegion précédent dans l’ensemble dérivé de l’élément de texte, ou null si la zone actuelle est la première zone miroir de l’ensemble.
TextLineMirrorRegion
  textLine : flash.text.engine:TextLine
[lecture seule] TextLine contenant cette zone miroir.
TextLineMirrorRegion
Méthodes publiques
 MéthodeDéfini par
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.
Object
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l’objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
Détails de la propriété

bounds

propriété
bounds:Rectangle  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

Limites de la zone miroir, par rapport à la ligne de texte.



Implémentation
    public function get bounds():Rectangle

element

propriété 
element:ContentElement  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

Objet ContentElement à partir duquel la zone miroir est dérivée.



Implémentation
    public function get element():ContentElement

Valeur émise
IllegalOperationError — Le TextLine auquel cet élément appartient n’est pas valide.

mirror

propriété 
mirror:EventDispatcher  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

Objet EventDispatcher vers lequel les événements affectant la zone miroir sont mis en miroir. Cela comprend les événements de souris qui surviennent spécifiquement dans la zone miroir, et tous les autres événements ayant pour cible la ligne de texte.



Implémentation
    public function get mirror():EventDispatcher

nextRegion

propriété 
nextRegion:flash.text.engine:TextLineMirrorRegion  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

TextLineMirrorRegion suivant dans l’ensemble dérivé de l’élément de texte, ou null si la zone actuelle est la dernière zone miroir de l’ensemble. Peut être sur la même ligne ou sur une autre ligne de texte.



Implémentation
    public function get nextRegion():flash.text.engine:TextLineMirrorRegion

previousRegion

propriété 
previousRegion:flash.text.engine:TextLineMirrorRegion  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

TextLineMirrorRegion précédent dans l’ensemble dérivé de l’élément de texte, ou null si la zone actuelle est la première zone miroir de l’ensemble. Peut être sur la même ligne ou sur une autre ligne de texte.



Implémentation
    public function get previousRegion():flash.text.engine:TextLineMirrorRegion

textLine

propriété 
textLine:flash.text.engine:TextLine  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

TextLine contenant cette zone miroir.



Implémentation
    public function get textLine():flash.text.engine:TextLine
TextLineMirrorRegionExample.as

Cet exemple affiche un bloc de texte avec zones miroir qui deviennent rouges lorsque vous cliquez sur leur entrée.
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 ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.