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...
flashx.textLayout.events 

StatusChangeEvent  - AS3

Packageflashx.textLayout.events
Classepublic class StatusChangeEvent
HéritageStatusChangeEvent Inheritance Event Inheritance Object

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

Une occurrence TextFlow distribue cet événement lorsque l’état d’un objet FlowElement change. Cet événement peut être utilisé pour détecter la fin du chargement d’un graphique intégré. Vous pouvez utiliser votre gestionnaire d’événement pour recomposer le flux de texte en prenant en compte la présence de l’élément de graphique intégré récemment chargé.

Consulter les exemples



Propriétés publiques
 PropriétéDéfini par
 Inheritedbubbles : Boolean
[lecture seule] Indique si un événement peut se propager vers le haut (bubbling).
Event
 Inheritedcancelable : Boolean
[lecture seule] Indique si le comportement associé à l’événement peut être évité.
Event
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
 InheritedcurrentTarget : Object
[lecture seule] L’objet qui traite activement l’objet Event avec un écouteur d’événements.
Event
  element : FlowElement
Occurrence FlowElement qui a rencontré un changement de statut.
StatusChangeEvent
  errorEvent : ErrorEvent
Objet ErrorEvent qui a été distribué à la suite du changement d’état.
StatusChangeEvent
 InheritedeventPhase : uint
[lecture seule] Phase actuelle du flux d’événements.
Event
  status : String
Nouveau statut de l’occurrence FlowElement.
StatusChangeEvent
 Inheritedtarget : Object
[lecture seule] Cible de l’événement.
Event
 Inheritedtype : String
[lecture seule] Type d’événement.
Event
Méthodes publiques
 MéthodeDéfini par
  
StatusChangeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, element:FlowElement = null, status:String = null, errorEvent:ErrorEvent = null)
Crée un objet d’événement contenant des informations sur le changement de statut.
StatusChangeEvent
 Inherited
Duplique une occurrence d’une sous-classe Event.
Event
 Inherited
formatToString(className:String, ... arguments):String
Fonction d’un utilitaire permettant d’implémenter la méthode toString() dans des classes Event ActionScript 3.0 personnalisées.
Event
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
Vérifie si la méthode preventDefault() a été appelée pour l’événement.
Event
 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
Annule le comportement par défaut d’un événement si cette opération est possible.
Event
 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
Bloque le traitement des écouteurs d’événement dans le nœud actuel et les suivants dans le flux d’événements.
Event
 Inherited
Bloque le traitement des écouteurs d’événement dans les nœuds qui suivent le nœud actuel dans le flux d’événements.
Event
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
Renvoie une chaîne répertoriant toutes les propriétés de l’objet Event.
Event
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
Constantes publiques
 ConstanteDéfini par
  INLINE_GRAPHIC_STATUS_CHANGE : String = "inlineGraphicStatusChange"
[statique] Définit la valeur de la propriété type d’un objet d’événement inlineGraphicStatusChanged.
StatusChangeEvent
Détails de la propriété

element

propriété
element:FlowElement

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

Occurrence FlowElement qui a rencontré un changement de statut.



Implémentation
    public function get element():FlowElement
    public function set element(value:FlowElement):void

Eléments de l’API associés

errorEvent

propriété 
errorEvent:ErrorEvent

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

Objet ErrorEvent qui a été distribué à la suite du changement d’état.



Implémentation
    public function get errorEvent():ErrorEvent
    public function set errorEvent(value:ErrorEvent):void

Eléments de l’API associés

status

propriété 
status:String

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

Nouveau statut de l’occurrence FlowElement. Les valeurs possibles de cette propriété sont définies par la classe InlineGraphicElementStatus. La classe InlineGraphicElementStatus comporte cinq constantes statiques :

  • ERROR : String = "error". Une erreur s’est produite pendant le chargement d’un graphique référencé.
  • LOADING : String = "loading". La charge a été lancée (mais pas terminée) sur un élément graphique qui est une URL.
  • LOAD_PENDING : String = "loadPending". L’élément graphique est une URL qui n’a pas été chargée.
  • READY : String = "ready". Le graphique est entièrement chargé et correctement dimensionné.
  • SIZE_PENDING : String = "sizePending". L’élément graphique avec des valeurs de largeur/hauteur automatique ou en pourcentage a terminé son chargement mais n’a pas été recomposé.



Implémentation
    public function get status():String
    public function set status(value:String):void

Eléments de l’API associés

Détails du constructeur

StatusChangeEvent

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

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

Crée un objet d’événement contenant des informations sur le changement de statut.

Paramètres
type:String — Type de l’événement. Les écouteurs d’événement peuvent accéder à cette information par le biais de la propriété type héritée. Il n’existe qu’un seul type d’événement StatusChangeEvent : StatusChangeEvent.INLINE_GRAPHIC_STATUS_CHANGE ;
 
bubbles:Boolean (default = false) — Indique si un événement peut se propager vers le haut (bubbling). Ce n’est pas le cas de cet événement.
 
cancelable:Boolean (default = false) — Indique si le comportement associé à l’événement peut être évité. Cet événement ne peut pas être annulé.
 
element:FlowElement (default = null) — Occurrence FlowElement qui a rencontré un changement de statut.
 
status:String (default = null) — Nouveau statut de l’occurrence FlowElement.
 
errorEvent:ErrorEvent (default = null) — Objet ErrorEvent, le cas échéant, associé au statut.
Détails de la constante

INLINE_GRAPHIC_STATUS_CHANGE

Constante
public static const INLINE_GRAPHIC_STATUS_CHANGE:String = "inlineGraphicStatusChange"

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

Définit la valeur de la propriété type d’un objet d’événement inlineGraphicStatusChanged.

StatusChangeEvent_example.as

L’exemple suivant indique comment créer un gestionnaire d’événement qui écoute le chargement d’un objet InlineGraphicElement. Les deux principales étapes consistent à appeler la méthode addEventListener() sur le flux de texte et à créer une fonction de gestionnaire d’événement.

Appelez la méthode méthode addEventListener() de l’occurrence TextFlow. Vous pouvez utiliser la chaîne simple "inlineGraphicsStatusChanged", mais il est plus sûr d’utiliser la constante statique StatusChangeEvent.INLINE_GRAPHIC_STATUS_CHANGE

La fonction de gestionnaire d’événement dans cet exemple s’appelle statusChangeHandler(). Le gestionnaire d’événements vérifie d’abord si le graphique est chargé. Si le graphique est chargé, le gestionnaire d’événement ajuste la hauteur du graphique en fonction de celle du texte. Enfin, le gestionnaire d’événement appelle updateAllcontrollers() sur le texte pour recomposer et afficher le texte et le graphique intégré.

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