| Package | flashx.textLayout.events |
| Classe | public class SelectionEvent |
| Héritage | SelectionEvent  Event Object |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
 | bubbles : Boolean [lecture seule]
Indique si un événement peut se propager vers le haut (bubbling). | Event | |
| cancelable : Boolean [lecture seule]
Indique si le comportement associé à l’événement peut être évité. | Event | |
| constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| currentTarget : Object [lecture seule]
L’objet qui traite activement l’objet Event avec un écouteur d’événements. | Event | |
| eventPhase : 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 | ||
| target : Object [lecture seule]
Cible de l’événement. | Event | |
| type : String [lecture seule]
Type d’événement. | Event | |
| Méthode | Dé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 | ||
|
Duplique une occurrence d’une sous-classe Event. | Event | |
|
Fonction d’un utilitaire permettant d’implémenter la méthode toString() dans des classes Event ActionScript 3.0 personnalisées. | Event | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Vérifie si la méthode preventDefault() a été appelée pour l’événement. | Event | |
|
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 | |
|
Annule le comportement par défaut d’un événement si cette opération est possible. | Event | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Bloque le traitement des écouteurs d’événement dans le nœud actuel et les suivants dans le flux d’événements. | Event | |
|
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 | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie une chaîne répertoriant toutes les propriétés de l’objet Event. | Event | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
| Constante | Dé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 | ||
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):voidEléments de l’API associés
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ètrestype: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) | |
cancelable:Boolean (default = false) | |
selectionState:SelectionState (default = null) |
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.
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);
}
}
}
Tue Jun 12 2018, 09:30 AM Z