ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flashx.textLayout.events 

SelectionEvent  - AS3

Paketflashx.textLayout.events
Klassepublic class SelectionEvent
VererbungSelectionEvent Inheritance Event Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Eine TextFlow-Instanz löst ein SelectionEvent-Objekt aus, wenn ein EditManager oder SelectionManager einen Textbereich ändert oder auswählt. Beispiel: Dieses Ereignis wird nicht nur ausgelöst, wenn ein Textbereich ausgewählt wird, sondern auch, wenn sich die Auswahl ändert, weil der Benutzer an einer anderen Stelle in den Textfluss geklickt hat. Weiterhin wird dieses Ereignis ausgelöst, wenn ein EditManager den Text oder die Textformatierung innerhalb eines Textabschnitts verändert.

Beispiele anzeigen



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedbubbles : Boolean
[schreibgeschützt] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.
Event
 Inheritedcancelable : Boolean
[schreibgeschützt] Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.
Event
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedcurrentTarget : Object
[schreibgeschützt] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
Event
 InheritedeventPhase : uint
[schreibgeschützt] Die aktuelle Phase im Ereignisablauf.
Event
  selectionState : SelectionState
Ein Objekt des Typs SelectionState, das den mit diesem SelectionEvent verknüpften ausgewählten Bereich darstellt.
SelectionEvent
 Inheritedtarget : Object
[schreibgeschützt] Das Ereignis-Ziel.
Event
 Inheritedtype : String
[schreibgeschützt] Der Ereignistyp.
Event
Öffentliche Methoden
 MethodeDefiniert 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
 Inherited
Dupliziert eine Instanz einer Event-Unterklasse.
Event
 Inherited
formatToString(className:String, ... arguments):String
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen.
Event
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde.
Event
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann.
Event
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt eine Zeichenfolge zurück, die alle Eigenschaften des Ereignisobjekts enthält.
Event
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert von
  SELECTION_CHANGE : String = "selectionChange"
[statisch] Die SelectionEvent.SELECTION_CHANGE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein selection-Ereignis.
SelectionEvent
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):void

Verwandte 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.

Parameter
type: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) — Gibt an, ob ein Ereignis propagiert werden kann. Dieses Ereignis propagiert nicht.
 
cancelable:Boolean (default = false) — Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.
 
selectionState:SelectionState (default = null) — Ein Objekt vom Typ ElementRange, das den Bereich des ausgewählten Textes beschreibt.
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.

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);
        }
       
    }        
}




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.