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 

SelectionEvent  - AS3

Packageflashx.textLayout.events
Classepublic class SelectionEvent
HéritageSelectionEvent 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 un objet SelectionEvent lorqu’un objet EditManager ou SelectionManager change ou sélectionne une plage de texte. Par exemple, cet événement est distribué non seulement lorsque vous sélectionnez une plage de texte, mais également lorsque la sélection change parce que l’utilisateur clique ailleurs dans l’enchaînement de texte. De plus, cet événement est également distribué lorsqu’un objet EditManager modifie le texte ou la mise en forme du texte dans une plage de texte.

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
 InheritedeventPhase : uint
[lecture seule] Phase actuelle du flux d’événements.
Event
  selectionState : SelectionState
Objet de type SelectionState qui représente la plage sélectionnée qui est associée à cet événement SelectionEvent.
SelectionEvent
 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
  
SelectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, selectionState:SelectionState = null)
Crée un objet d’événement contenant des informations sur l’enchaînement.
SelectionEvent
 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
  SELECTION_CHANGE : String = "selectionChange"
[statique] La constante SelectionEvent.SELECTION_CHANGE définit la valeur de la propriété type de l’objet d’événement d’un événement de sélection.
SelectionEvent
Détails de la propriété

selectionState

propriété
selectionState:SelectionState

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

Objet de type SelectionState qui représente la plage sélectionnée qui est associée à cet événement SelectionEvent.

Vous pouvez utiliser cette propriété, de même que la classe ElementRange, pour créer une occurrence ElementRange qui représente la plage du texte sélectionné. Vous pouvez utiliser la ligne de code suivante pour créer une occurrence de la classe ElementRange qui représente la plage du texte sélectionné (la variable ev représente l’objet d’événement et l’opérateur conditionnel est utilisé pour éviter toute valeur null à la propriété selectionState) :

         // Find selected element range
         var range:ElementRange = ev.selectionState ?  
             ElementRange.createElementRange(ev.selectionState.textFlow,
             ev.selectionState.absoluteStart, ev.selectionState.absoluteEnd) : null;



Implémentation
    public function get selectionState():SelectionState
    public function set selectionState(value:SelectionState):void

Eléments de l’API associés

Détails du constructeur

SelectionEvent

()Constructeur
public function SelectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, selectionState:SelectionState = 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 l’enchaînement.

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 : SelectionEvent.SELECTION_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é.
 
selectionState:SelectionState (default = null) — Objet de type ElementRange qui décrit la plage de texte sélectionnée.
Détails de la constante

SELECTION_CHANGE

Constante
public static const SELECTION_CHANGE:String = "selectionChange"

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

La constante SelectionEvent.SELECTION_CHANGE définit la valeur de la propriété type de l’objet d’événement d’un événement de sélection.

SelectionEvent_example.as

Cet exemple montre comment écouter les changements apportés à la sélection de texte dans un fux de texte. 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.

L’appel de la méthode addEventListener() s’effectue sur l’occurrence TextFlow. Vous pouvez utiliser la chaîne simple selectionChange, mais il est plus sûr d’utiliser la constante statique SelectionEvent.SELECTION_CHANGE.

La fonction de gestionnaire d’événement dans cet exemple s’appelle selectionHandler(). La méthode selectionHandler() utilise la fonction trace() pour générer des instructions trace qui indiquent les points de début et de fin de la plage de texte. Ces informations sont accessibles via l’objet d’événement de la propriété selectedElementRange.

package flashx.textLayout.events.examples {
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.edit.ElementRange;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.edit.SelectionManager;
    import flashx.textLayout.edit.SelectionState;
    import flashx.textLayout.events.SelectionEvent;

    public class SelectionEvent_example extends Sprite
    {
        private var tf:TextFlow;
        private var sm:SelectionManager;
        
        public function SelectionEvent_example()
        {
            //define TextFlow and manager objects
            tf = new TextFlow();
            sm = new SelectionManager();
            tf.interactionManager = sm;
            
            //define elements to contain text
            var p:ParagraphElement = new ParagraphElement();
            var s:SpanElement = new SpanElement();
            s.text ="This is sample text for the SelectionEvent example.";
                  
            //add the elements to the TextFlow
            p.addChild(s);  // add span as child of paragraph
            tf.addChild(p);  // add paragraph to text flow   
                    
            //compose TextFlow to display
            tf.flowComposer.addController(new ContainerController(this,600,400));
            tf.flowComposer.updateAllControllers();
            
            //add event handler to listen for SelectionEvent
            tf.addEventListener(SelectionEvent.SELECTION_CHANGE, selectionHandler);
    
        }
        private function selectionHandler(ev:SelectionEvent):void{
            trace("Selection event detected.");
            
            // Find selected element range
            var range:ElementRange = ev.selectionState ?  
                ElementRange.createElementRange(ev.selectionState.textFlow,
                ev.selectionState.absoluteStart, ev.selectionState.absoluteEnd) : null;

            trace("Starting index of selection range: " + range.absoluteStart);
            trace("Ending index of selection range: " + range.absoluteEnd);
        }
       
    }        
}




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