Pakiet | flashx.textLayout.events |
Klasa | public class SelectionEvent |
Dziedziczenie | SelectionEvent ![]() ![]() |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
![]() | bubbles : Boolean [tylko do odczytu]
Określa, czy zdarzenie może przechodzić fazę propagacji. | Event | |
![]() | cancelable : Boolean [tylko do odczytu]
Wskazuje, czy można uniemożliwić operacje skojarzone ze zdarzeniem. | Event | |
![]() | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
![]() | currentTarget : Object [tylko do odczytu]
Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. | Event | |
![]() | eventPhase : uint [tylko do odczytu]
Bieżąca faza przepływu zdarzeń. | Event | |
selectionState : SelectionState
Obiekt typu SelectionState, który reprezentuje zaznaczony zakres skojarzony z tym zdarzeniem SelectionEvent. | SelectionEvent | ||
![]() | target : Object [tylko do odczytu]
Miejsce docelowe zdarzenia. | Event | |
![]() | type : String [tylko do odczytu]
Typ zdarzenia. | Event |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
SelectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, selectionState:SelectionState = null)
Tworzy obiekt zdarzenia, który zawiera informacje o operacji przepływu. | SelectionEvent | ||
![]() |
Powiela instancję podklasy Event. | Event | |
![]() |
Funkcja narzędziowa umożliwiająca implementację metody toString() w niestandardowych klasach Event w języku ActionScript 3.0. | Event | |
![]() |
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
![]() |
Sprawdza, czy w odniesieniu do tego zdarzenia wywołano metodę preventDefault(). | Event | |
![]() |
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
![]() |
Anuluje domyślne ustawienia zdarzenia, o ile zachowanie to może być anulowane. | Event | |
![]() |
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
![]() |
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
![]() |
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węźle bieżącym i węzłach następujących po nim. | Event | |
![]() |
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węzłach następujących po węźle bieżącym w przepływie zdarzeń. | Event | |
![]() |
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
![]() |
Zwraca ciąg znaków, który zawiera wszystkie właściwości obiektu Event. | Event | |
![]() |
Zwraca pierwotną wartość dla określonego obiektu. | Object |
Stała | Zdefiniowane przez | ||
---|---|---|---|
SELECTION_CHANGE : String = "selectionChange" [statyczny]
Stała SelectionEvent.SELECTION_CHANGE definiuje wartość właściwości type obiektu zdarzenia dla zdarzenia Selection. | SelectionEvent |
selectionState | właściwość |
selectionState:SelectionState
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Obiekt typu SelectionState, który reprezentuje zaznaczony zakres skojarzony z tym zdarzeniem SelectionEvent.
Z tej właściwości można korzystać wraz z klasą ElementRange w celu utworzenia instancji klasy ElementRange, która reprezentuje zakres zaznaczonego tekstu. Za pomocą poniższego wiersza kodu można utworzyć instancję klasy ElementRange, która reprezentuje zakres zaznaczonego tekstu (zmienna ev
reprezentuje obiekt zdarzenia, a operator warunkowy jest używany w celu zabezpieczenia przed wystąpieniem wartości null
dla właściwości selectionState
):
// Find selected element range var range:ElementRange = ev.selectionState ? ElementRange.createElementRange(ev.selectionState.textFlow, ev.selectionState.absoluteStart, ev.selectionState.absoluteEnd) : null;
Implementacja
public function get selectionState():SelectionState
public function set selectionState(value:SelectionState):void
Powiązane elementy interfejsu API
SelectionEvent | () | Konstruktor |
public function SelectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, selectionState:SelectionState = null)
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Tworzy obiekt zdarzenia, który zawiera informacje o operacji przepływu.
Parametrytype:String — Typ zdarzenia. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem dziedziczonej właściwości type . Istnieje tylko jeden typ zdarzenia SelectionEvent: SelectionEvent.SELECTION_CHANGE ;
| |
bubbles:Boolean (default = false ) — Określa, czy zdarzenie jest zdarzeniem propagującym. To zdarzenie nie propaguje.
| |
cancelable:Boolean (default = false ) — Wskazuje, czy można uniemożliwić operacje skojarzone ze zdarzeniem.
| |
selectionState:SelectionState (default = null ) — Obiekt typu ElementRange, który opisuje zaznaczony zakres tekstu.
|
SELECTION_CHANGE | Stała |
public static const SELECTION_CHANGE:String = "selectionChange"
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Stała SelectionEvent.SELECTION_CHANGE definiuje wartość właściwości type obiektu zdarzenia dla zdarzenia Selection.
Ten przykład przedstawia sposób wykrywania zmian w tekście zaznaczonym w przepływie. Dwa główne kroki są przeznaczone do wywołania metody addEventListener()
w przepływie tekstu oraz do utworzenia funkcji procedury obsługi zdarzenia.
Wywołanie metody addEventListener()
jest realizowane w instancji klasy TextFlow. Można użyć prostego ciągu "selectionChange"
, ale bezpieczniejsze jest użycie statycznej stałej SelectionEvent.SELECTION_CHANGE
.
Funkcja procedury obsługi zdarzeń w tym przykładzie ma nazwę selectionHandler()
. Metoda selectionHandler()
wykorzystuje funkcję trace()
w celu generowania instrukcji trace, które wskazują punkty rozpoczęcia i zakończenia zakresu tekstu. Informacje są dostępne za pośrednictwem właściwości selectedElementRange
obiektu zdarzenia.
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, 12:06 PM Z