| Paket | flashx.textLayout.events |
| Klasse | public class SelectionEvent |
| Vererbung | SelectionEvent  Event Object |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Öffentliche Eigenschaften
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | bubbles : Boolean [schreibgeschützt]
Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt. | Event | |
| cancelable : Boolean [schreibgeschützt]
Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann. | Event | |
| constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| currentTarget : Object [schreibgeschützt]
Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. | Event | |
| eventPhase : uint [schreibgeschützt]
Die aktuelle Phase im Ereignisablauf. | Event | |
| prototype : Object [statisch]
Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts. | Object | |
| selectionState : SelectionState
Ein Objekt des Typs SelectionState, das den mit diesem SelectionEvent verknüpften ausgewählten Bereich darstellt. | SelectionEvent | ||
| target : Object [schreibgeschützt]
Das Ereignis-Ziel. | Event | |
| type : String [schreibgeschützt]
Der Typ des Ereignisses. | Event | |
Öffentliche Methoden
| Methode | Definiert von | ||
|---|---|---|---|
SelectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, selectionState:SelectionState = null)
Erstellt ein Ereignis-Objekt, das Informationen über einen flow-Vorgang enthält. | SelectionEvent | ||
|
Dupliziert eine Instanz einer Event-Unterklasse. | Event | |
|
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen. | Event | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde. | Event | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann. | Event | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | |
|
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt eine Zeichenfolge zurück, die alle Eigenschaften des Ereignisobjekts enthält. | Event | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
Öffentliche Konstanten
| Konstante | Definiert von | ||
|---|---|---|---|
| ACTIVATE : String = "activate" [statisch]
Die ACTIVATE-Konstante bestimmt den Wert der type-Eigenschaft eines activate-Ereignisobjekts. | Event | |
| ADDED : String = "added" [statisch]
Die Event.ADDED-Konstante definiert den Wert der type-Eigenschaft eines added-Ereignisobjekts. | Event | |
| ADDED_TO_STAGE : String = "addedToStage" [statisch]
Die Event.ADDED_TO_STAGE-Konstante definiert den Wert der type-Eigenschaft eines addedToStage-Ereignisobjekts. | Event | |
| CANCEL : String = "cancel" [statisch]
Die Event.CANCEL-Konstante definiert den Wert der type-Eigenschaft eines cancel-Ereignisobjekts. | Event | |
| CHANGE : String = "change" [statisch]
Die Event.CHANGE-Konstante definiert den Wert der type-Eigenschaft eines change-Ereignisobjekts. | Event | |
| CLEAR : String = "clear" [statisch]
Die Event.CLEAR-Konstante definiert den Wert der type-Eigenschaft eines clear-Ereignisobjekts. | Event | |
| CLOSE : String = "close" [statisch]
Die Event.CLOSE-Konstante definiert den Wert der type-Eigenschaft eines close-Ereignisobjekts. | Event | |
| CLOSING : String = "closing" [statisch]
Die Event.CLOSING-Konstante definiert den Wert der type-Eigenschaft eines closing-Ereignisobjekts. | Event | |
| COMPLETE : String = "complete" [statisch]
Die Event.COMPLETE-Konstante definiert den Wert der type-Eigenschaft eines complete-Ereignisobjekts. | Event | |
| CONNECT : String = "connect" [statisch]
Die Event.CONNECT-Konstante definiert den Wert der type-Eigenschaft eines connect-Ereignisobjekts. | Event | |
| CONTEXT3D_CREATE : String = "context3DCreate" [statisch]
Die Event.CONTEXT3D_CREATE-Konstante definiert den Wert der type-Eigenschaft eines context3Dcreate-Ereignisobjekts. | Event | |
| COPY : String = "copy" [statisch]
Definiert den Wert der type-Eigenschaft eines copy-Ereignisobjekts. | Event | |
| CUT : String = "cut" [statisch]
Definiert den Wert der type-Eigenschaft eines cut-Ereignisobjekts. | Event | |
| DEACTIVATE : String = "deactivate" [statisch]
Die Event.DEACTIVATE-Konstante definiert den Wert der type-Eigenschaft eines deactivate-Ereignisobjekts. | Event | |
| DISPLAYING : String = "displaying" [statisch]
Die Event.DISPLAYING-Konstante definiert den Wert der type-Eigenschaft eines displaying-Ereignisobjekts. | Event | |
| ENTER_FRAME : String = "enterFrame" [statisch]
Die Event.ENTER_FRAME-Konstante definiert den Wert der type-Eigenschaft eines enterFrame-Ereignisobjekts. | Event | |
| EXIT_FRAME : String = "exitFrame" [statisch]
Die Event.EXIT_FRAME-Konstante definiert den Wert der type-Eigenschaft eines exitFrame-Ereignisobjekts. | Event | |
| EXITING : String = "exiting" [statisch]
Die Event.EXITING-Konstante definiert den Wert der type-Eigenschaft eines exiting-Ereignisobjekts. | Event | |
| FRAME_CONSTRUCTED : String = "frameConstructed" [statisch]
Die Event.FRAME_CONSTRUCTED-Konstante definiert den Wert der type-Eigenschaft eines frameConstructed-Ereignisobjekts. | Event | |
| FULLSCREEN : String = "fullScreen" [statisch]
Die Event.FULL_SCREEN-Konstante definiert den Wert der type-Eigenschaft eines fullScreen-Ereignisobjekts. | Event | |
| HTML_BOUNDS_CHANGE : String = "htmlBoundsChange" [statisch]
Die Event.HTML_BOUNDS_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines htmlBoundsChange-Ereignisobjekts. | Event | |
| HTML_DOM_INITIALIZE : String = "htmlDOMInitialize" [statisch]
Die Event.HTML_DOM_INITIALIZE-Konstante definiert den Wert der type-Eigenschaft eines htmlDOMInitialize-Ereignisobjekts. | Event | |
| HTML_RENDER : String = "htmlRender" [statisch]
Die Event.HTML_RENDER-Konstante definiert den Wert der type-Eigenschaft eines htmlRender-Ereignisobjekts. | Event | |
| ID3 : String = "id3" [statisch]
Die Event.ID3-Konstante definiert den Wert der type-Eigenschaft eines id3-Ereignisobjekts. | Event | |
| INIT : String = "init" [statisch]
Die Event.INIT-Konstante definiert den Wert der type-Eigenschaft eines init-Ereignisobjekts. | Event | |
| LOCATION_CHANGE : String = "locationChange" [statisch]
Die Event.LOCATION_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines locationChange-Ereignisobjekts. | Event | |
| MOUSE_LEAVE : String = "mouseLeave" [statisch]
Die Event.MOUSE_LEAVE-Konstante definiert den Wert der type-Eigenschaft eines mouseLeave-Ereignisobjekts. | Event | |
| NETWORK_CHANGE : String = "networkChange" [statisch]
Die Event.NETWORK_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines networkChange-Ereignisobjekts. | Event | |
| OPEN : String = "open" [statisch]
Die Event.OPEN-Konstante definiert den Wert der type-Eigenschaft eines open-Ereignisobjekts. | Event | |
| PASTE : String = "paste" [statisch]
Die Event.PASTE-Konstante definiert den Wert der type-Eigenschaft eines paste-Ereignisobjekts. | Event | |
| PREPARING : String = "preparing" [statisch]
Die Event.PREPARING-Konstante definiert den Wert der type-Eigenschaft eines preparing-Ereignisobjekts. | Event | |
| REMOVED : String = "removed" [statisch]
Die Event.REMOVED-Konstante definiert den Wert der type-Eigenschaft eines removed-Ereignisobjekts. | Event | |
| REMOVED_FROM_STAGE : String = "removedFromStage" [statisch]
Die Event.REMOVED_FROM_STAGE-Konstante definiert den Wert der type-Eigenschaft eines removedFromStage-Ereignisobjekts. | Event | |
| RENDER : String = "render" [statisch]
Die Event.RENDER-Konstante definiert den Wert der type-Eigenschaft eines render-Ereignisobjekts. | Event | |
| RESIZE : String = "resize" [statisch]
Die Event.RESIZE-Konstante definiert den Wert der type-Eigenschaft eines resize-Ereignisobjekts. | Event | |
| SCROLL : String = "scroll" [statisch]
Die Event.SCROLL-Konstante definiert den Wert der type-Eigenschaft eines scroll-Ereignisobjekts. | Event | |
| SELECT : String = "select" [statisch]
Die Event.SELECT-Konstante definiert den Wert der type-Eigenschaft eines select-Ereignisobjekts. | Event | |
| SELECT_ALL : String = "selectAll" [statisch]
Die Event.SELECT_ALL-Konstante definiert den Wert der type-Eigenschaft eines selectALL-Ereignisobjekts. | Event | |
| SELECTION_CHANGE : String = "selectionChange" [statisch]
Die SelectionEvent.SELECTION_CHANGE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein selection-Ereignis. | SelectionEvent | ||
| SOUND_COMPLETE : String = "soundComplete" [statisch]
Die Event.SOUND_COMPLETE-Konstante definiert den Wert der type-Eigenschaft eines soundComplete-Ereignisobjekts. | Event | |
| STANDARD_ERROR_CLOSE : String = "standardErrorClose" [statisch]
Die Event.STANDARD_ERROR_CLOSE-Konstante definiert den Wert der type-Eigenschaft eines standardErrorClose-Ereignisobjekts. | Event | |
| STANDARD_INPUT_CLOSE : String = "standardInputClose" [statisch]
Die Event.STANDARD_INPUT_CLOSE-Konstante definiert den Wert der type-Eigenschaft eines standardInputClose-Ereignisobjekts. | Event | |
| STANDARD_OUTPUT_CLOSE : String = "standardOutputClose" [statisch]
Die Event.STANDARD_OUTPUT_CLOSE-Konstante definiert den Wert der type-Eigenschaft eines standardOutputClose-Ereignisobjekts. | Event | |
| TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [statisch]
Die Event.TAB_CHILDREN_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines tabChildrenChange-Ereignisobjekts. | Event | |
| TAB_ENABLED_CHANGE : String = "tabEnabledChange" [statisch]
Die Event.TAB_ENABLED_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines tabEnabledChange-Ereignisobjekts. | Event | |
| TAB_INDEX_CHANGE : String = "tabIndexChange" [statisch]
Die Event.TAB_INDEX_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines tabIndexChange-Ereignisobjekts. | Event | |
| TEXT_INTERACTION_MODE_CHANGE : String = "textInteractionModeChange" [statisch]
Die Event.TEXT_INTERACTION_MODE_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines Interaktionsmodusereignisobjekts. | Event | |
| UNLOAD : String = "unload" [statisch]
Die Event.UNLOAD-Konstante definiert den Wert der type-Eigenschaft eines unload-Ereignisobjekts. | Event | |
| USER_IDLE : String = "userIdle" [statisch]
Die Event.USER_IDLE-Konstante definiert den Wert der type-Eigenschaft eines userIdle-Ereignisobjekts. | Event | |
| USER_PRESENT : String = "userPresent" [statisch]
Die Event.USER_PRESENT-Konstante definiert den Wert der type-Eigenschaft eines userPresent-Ereignisobjekts. | Event | |
Eigenschaftendetails
selectionState | Eigenschaft |
selectionState:SelectionState| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Ein Objekt des Typs SelectionState, das den mit diesem SelectionEvent verknüpften ausgewählten Bereich darstellt.
Sie können diese Eigenschaft zusammen mit der ElementRange-Klasse verwenden, um eine ElementRange-Instanz zu erstellen, die den Bereich des ausgewählten Textes darstellt. Sie können die folgende Code-Zeile verwenden, um eine Instanz der ElementRange-Klasse zu erstellen, die den Bereich des ausgewählten Texts darstellt (die ev-Variable stellt das Ereignisobjekt dar und der Bedingungsoperator wird als Schutz gegen einen null-Wert für die selectionState-Eigenschaft verwendet):
// Find selected element range
var range:ElementRange = ev.selectionState ?
ElementRange.createElementRange(ev.selectionState.textFlow,
ev.selectionState.absoluteStart, ev.selectionState.absoluteEnd) : null;Implementierung
public function get selectionState():SelectionState public function set selectionState(value:SelectionState):voidVerwandte API-Elemente
Konstruktordetails
SelectionEvent | () | Konstruktor |
public function SelectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, selectionState:SelectionState = null)| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Erstellt ein Ereignis-Objekt, das Informationen über einen flow-Vorgang enthält.
Parametertype:String — Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ von SelectionEvent: SelectionEvent.SELECTION_CHANGE;
| |
bubbles:Boolean (default = false) | |
cancelable:Boolean (default = false) | |
selectionState:SelectionState (default = null) |
Konstantendetails
SELECTION_CHANGE | Konstante |
public static const SELECTION_CHANGE:String = "selectionChange"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die SelectionEvent.SELECTION_CHANGE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein selection-Ereignis.
Beispiele Verwendung dieses Beispiels
SelectionEvent_example.as
Dieses Beispiel zeigt, wie auf Änderungen an einer Textauswahl innerhalb des Textflusses gewartet wird. Die zwei entscheidenden Schritte sind, die addEventListener()-Methode für den Textfluss aufzurufen und eine Ereignisprozedur-Funktion zu erstellen.
Der Aufruf an addEventListener() wird an die TextFlow-Instanz gerichtet. Sie können den einfachen String"selectionChange" verwenden, aber es ist sicherer, die statische Konstante SelectionEvent.SELECTION_CHANGE zu verwenden.
Die Ereignisprozedurfunktion in diesem Beispiel hat den Namen selectionHandler(). Die selectionHandler()-Methode verwendet die trace()-Funktion, um trace-Anweisungen zu erstellen, die die Anfangs- und Endpunkte für einen Textbereich angeben. Diese Information ist über die selectedElementRange-Eigenschaft des Ereignisobjekts verfügbar.
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 Apr 11 2012, 04:58 AM -07:00