| Pakiet | flashx.textLayout.events |
| Klasa | public class SelectionEvent |
| Dziedziczenie | SelectionEvent Event Object |
| 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):voidPowią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
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne