Pakket | flashx.textLayout.events |
Klasse | public class SelectionEvent |
Overerving | SelectionEvent Event Object |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5 |
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
bubbles : Boolean [alleen-lezen]
Geeft aan of een gebeurtenis een terugkoppelgebeurtenis is. | Event | ||
cancelable : Boolean [alleen-lezen]
Geeft aan of het gedrag dat aan deze gebeurtenis is gekoppeld, kan worden voorkomen. | Event | ||
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
currentTarget : Object [alleen-lezen]
Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. | Event | ||
eventPhase : uint [alleen-lezen]
De huidige fase in de gebeurtenisstroom. | Event | ||
selectionState : SelectionState
Een object van het type SelectionState dat het geselecteerde bereik vertegenwoordigt dat aan deze SelectionEvent is gekoppeld. | SelectionEvent | ||
target : Object [alleen-lezen]
Doel van gebeurtenis. | Event | ||
type : String [alleen-lezen]
Het type gebeurtenis. | Event |
Methode | Gedefinieerd door | ||
---|---|---|---|
SelectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, selectionState:SelectionState = null)
Maakt een gebeurtenisobject dat informatie bevat over een flowbewerking. | SelectionEvent | ||
Dupliceert een instantie van een subklasse Event. | Event | ||
Een hulpprogrammafunctie voor de implementatie van de methode toString() in aangepaste ActionScript 3.0-Event-klassen. | Event | ||
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
Controleert of de methode preventDefault() is aangeroepen voor de gebeurtenis. | Event | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
Annuleert het standaardgedrag van een gebeurtenis wanneer dat gedrag kan worden geannuleerd. | Event | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | ||
Voorkomt het verwerken van gebeurtenislisteners in het huidige knooppunt en volgende knooppunten in de gebeurtenisstroom. | Event | ||
Voorkomt het verwerken van gebeurtenislisteners in knooppunten die volgen op het huidige knooppunt in de gebeurtenisstroom. | Event | ||
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | ||
Retourneert een tekenreeks die alle eigenschappen van het Event-object bevat. | Event | ||
Retourneert de primitieve waarde van het opgegeven object. | Object |
Constante | Gedefinieerd door | ||
---|---|---|---|
SELECTION_CHANGE : String = "selectionChange" [statisch]
De SelectionEvent.SELECTION_CHANGE-constante definieert de waarde van het type eigenschap van het gebeurtenisobject voor een selectiegebeurtenis. | SelectionEvent |
selectionState | eigenschap |
selectionState:SelectionState
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5 |
Een object van het type SelectionState dat het geselecteerde bereik vertegenwoordigt dat aan deze SelectionEvent is gekoppeld.
U kunt deze eigenschap samen met de klasse ElementRange gebruiken voor het maken van een ElementRange-instantie die het bereik van de geselecteerde tekst representeert. U kunt de volgende coderegel gebruiken voor het maken van een instantie van de klasse ElementRange die het bereik van de geselecteerde tekst representeert (de variabele ev
representeert het gebeurtenisobject en de voorwaardelijke operator wordt gebruikt om een null
-waarde voor de eigenschap selectionState
te voorkomen):
// Find selected element range var range:ElementRange = ev.selectionState ? ElementRange.createElementRange(ev.selectionState.textFlow, ev.selectionState.absoluteStart, ev.selectionState.absoluteEnd) : null;
Implementatie
public function get selectionState():SelectionState
public function set selectionState(value:SelectionState):void
Verwante API-elementen
SelectionEvent | () | Constructor |
public function SelectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, selectionState:SelectionState = null)
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5 |
Maakt een gebeurtenisobject dat informatie bevat over een flowbewerking.
Parameterstype:String — Het type gebeurtenis. Gebeurtenislisteners hebben toegang tot deze informatie via de overerfde eigenschap type . Er slechts één type SelectionEvent: SelectionEvent.SELECTION_CHANGE ;
| |
bubbles:Boolean (default = false ) — Geeft aan of een gebeurtenis een terugkoppelgebeurtenis is. Bij deze gebeurtenis is dat niet het geval.
| |
cancelable:Boolean (default = false ) — Geeft aan of het gedrag dat aan deze gebeurtenis is gekoppeld, kan worden voorkomen.
| |
selectionState:SelectionState (default = null ) — Een object van het type ElementRange, waarmee het geselecteerde tekstbereik wordt omschreven.
|
SELECTION_CHANGE | Constante |
public static const SELECTION_CHANGE:String = "selectionChange"
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5 |
De SelectionEvent.SELECTION_CHANGE-constante definieert de waarde van het type eigenschap van het gebeurtenisobject voor een selectiegebeurtenis.
Dit voorbeeld illustreert hoe u kunt controleren op wijzigingen in de selectie van tekst in een tekstflow. De twee belangrijkste stappen zijn het aanroepen van de methode addEventListener()
voor de tekstflow en het maken van een gebeurtenishandlerfunctie.
De aanroep naar addEventListener()
wordt uitgevoerd naar de TextFlow-instantie. U kunt de eenvoudige tekenreeks "selectionChange"
gebruiken, maar het is veiliger om de statische constante SelectionEvent.SELECTION_CHANGE
te gebruiken.
De gebeurtenishandlerfunctie in dit voorbeeld heet selectionHandler()
. De methode selectionHandler()
gebruikt de functie trace()
voor het genereren van traceerinstructies die de begin- en eindpunten van het tekstbereik aangeven. Deze informatie is toegankelijk via de eigenschap selectedElementRange
van het gebeurtenisobject.
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); } } }
Wed Jun 13 2018, 11:42 AM Z