Paket | flashx.textLayout.events |
Klass | public class SelectionEvent |
Arv | SelectionEvent Event Object |
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5 |
Egenskap | Definieras med | ||
---|---|---|---|
bubbles : Boolean [skrivskyddad]
indikerar om händelsen är en bubblande händelse. | Event | ||
cancelable : Boolean [skrivskyddad]
Indikerar om beteendet som är kopplat till händelsen kan förhindras. | Event | ||
constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | ||
currentTarget : Object [skrivskyddad]
Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. | Event | ||
eventPhase : uint [skrivskyddad]
Den nuvarande fasen i händelseflödet. | Event | ||
selectionState : SelectionState
Ett objekt av typen SelectionState som representerar det markerade området som är kopplat till denna SelectionEvent. | SelectionEvent | ||
target : Object [skrivskyddad]
Händelsens mål. | Event | ||
type : String [skrivskyddad]
Händelsens typ. | Event |
Metod | Definieras med | ||
---|---|---|---|
SelectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, selectionState:SelectionState = null)
Skapar ett händelseobjekt som innehåller information om en flödesåtgärd. | SelectionEvent | ||
Skapar ett duplikat av en instans av en Event-underklass. | Event | ||
Ett verktyg som används för att implementera metoden toString() i de anpassade klasserna ActionScript 3.0. | Event | ||
Anger om det finns en egenskap angiven för ett objekt. | Object | ||
Kontrollerar om preventDefault()-metoden har anropats för händelsen. | Event | ||
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | ||
Avbryter en händelses standardbeteende om det beteendet kan avbrytas. | Event | ||
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | ||
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | ||
Förhindrar behandling av händelsehanterare i den aktuella noden och alla noder som följer den aktuella noden i händelseflödet. | Event | ||
Förhindrar behandling av händelsehanterare i noder som följer den aktuella noden i händelseflödet. | Event | ||
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | ||
Returnerar en sträng som innehåller alla egenskaper i Event-objektet. | Event | ||
Returnerar det angivna objektets primitiva värde. | Object |
Konstant | Definieras med | ||
---|---|---|---|
SELECTION_CHANGE : String = "selectionChange" [statisk]
Konstanten SelectionEvent.SELECTION_CHANGE definierar värdet på type-egenskapen för händelseobjektet för en markeringshändelse. | SelectionEvent |
selectionState | egenskap |
selectionState:SelectionState
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5 |
Ett objekt av typen SelectionState som representerar det markerade området som är kopplat till denna SelectionEvent.
Du kan använda den här egenskapen, tillsammans med klassen ElementRange, för att skapa ElementRange-instansen som representerar det markerade textintervallet. Du kan använda följande kodrad för att skapa en instans av klassen ElementRange som representerar intervallet av markerad text (variabeln ev
representerar händelseobjektet, och den villkorliga operatorn används som skydd mot ett null
-värde för egenskapen selectionState
):
// Find selected element range var range:ElementRange = ev.selectionState ? ElementRange.createElementRange(ev.selectionState.textFlow, ev.selectionState.absoluteStart, ev.selectionState.absoluteEnd) : null;
Implementering
public function get selectionState():SelectionState
public function set selectionState(value:SelectionState):void
Relaterade API-element
SelectionEvent | () | Konstruktor |
public function SelectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, selectionState:SelectionState = null)
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5 |
Skapar ett händelseobjekt som innehåller information om en flödesåtgärd.
Parametrartype:String — Händelsens typ. Händelseavlyssnare kan hämta informationen genom den ärvda egenskapen type . Det finns bara en typ av SelectionEvent: SelectionEvent.SELECTION_CHANGE ;
| |
bubbles:Boolean (default = false ) — Anger om en händelse är en bubblingshändelse. Den här händelsen bubblar inte.
| |
cancelable:Boolean (default = false ) — Indikerar om beteendet som är kopplat till händelsen kan förhindras.
| |
selectionState:SelectionState (default = null ) — Ett objekt av typen ElementRange som beskriver textintervallet som markerats.
|
SELECTION_CHANGE | Konstant |
public static const SELECTION_CHANGE:String = "selectionChange"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5 |
Konstanten SelectionEvent.SELECTION_CHANGE definierar värdet på type-egenskapen för händelseobjektet för en markeringshändelse.
I det här exemplet visas hur du lyssnar efter ändringar i markeringen av texten i textflödet. De två viktigaste stegen är att anropa metoden addEventListener()
i textflödet och att skapa en händelsehanterarfunktion.
Anropet till addEventListener()
görs på TextFlow-instansen. Du kan använda den enkla strängen "selectionChange"
, men det är säkrare att använda den statiska konstanten SelectionEvent.SELECTION_CHANGE
.
Händelsehanterarfunktionen i det här exemplet kallas selectionHandler()
. Metoden selectionHandler()
använder funktionen trace()
för att skapa programsatsen trace som indikerar start- och slutpunkten för textintervallet. Denna information kan hämtas genom händelseobjektets selectedElementRange
-egenskap.
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, 01:40 PM Z