| Pacchetto | flashx.textLayout.events |
| Classe | public class SelectionEvent |
| Ereditarietà | SelectionEvent  Event Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5 |
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
 | bubbles : Boolean [sola lettura]
Indica se un evento è un evento di bubbling. | Event | |
| cancelable : Boolean [sola lettura]
Indica se il comportamento associato all'evento può essere impedito. | Event | |
| constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| currentTarget : Object [sola lettura]
L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. | Event | |
| eventPhase : uint [sola lettura]
La fase attuale del flusso di eventi. | Event | |
| selectionState : SelectionState
Un oggetto di tipo SelectionState che rappresenta l'intervallo selezionato associato a questo SelectionEvent. | SelectionEvent | ||
| target : Object [sola lettura]
Il target dell'evento. | Event | |
| type : String [sola lettura]
Il tipo di evento. | Event | |
| Metodo | Definito da | ||
|---|---|---|---|
SelectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, selectionState:SelectionState = null)
Crea un oggetto evento contenente informazioni relative a un oggetto FlowOperation. | SelectionEvent | ||
|
Duplica un'istanza di una sottoclasse Event. | Event | |
|
Una funzione dell'utilità per l'implementazione del metodo toString() in classi Event ActionScript 3.0 personalizzate. | Event | |
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Verifica se sull'evento è stato chiamato il metodo preventDefault(). | Event | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
|
Annulla il comportamento predefinito di un evento se tale comportamento può essere annullato. | Event | |
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
Impedisce l'elaborazione di tutti i listener di eventi nel nodo corrente e in tutti i nodi successivi del flusso di eventi. | Event | |
|
Impedisce l'elaborazione di tutti i listener di eventi nei nodi del flusso di eventi successivi a quello corrente. | Event | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce una stringa che contiene tutte le proprietà dell'oggetto Event. | Event | |
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
| Costante | Definito da | ||
|---|---|---|---|
| SELECTION_CHANGE : String = "selectionChange" [statico]
La costante SelectionEvent.SELECTION_CHANGE definisce il valore della proprietà type dell'oggetto evento per un evento di selezione. | SelectionEvent | ||
selectionState | proprietà |
selectionState:SelectionState| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5 |
Un oggetto di tipo SelectionState che rappresenta l'intervallo selezionato associato a questo SelectionEvent.
Potete utilizzare questa proprietà insieme alla classe ElementRange per creare un'istanza ElementRange che rappresenta l'intervallo di testo selezionato. Potete utilizzare la seguente riga di codice per creare un'istanza della classe ElementRange che rappresenta l'intervallo di testo selezionato (la variabile ev rappresenta l'oggetto evento e l'operatore condizionale viene utilizzato per evitare un valore null per la proprietà selectionState):
// Find selected element range
var range:ElementRange = ev.selectionState ?
ElementRange.createElementRange(ev.selectionState.textFlow,
ev.selectionState.absoluteStart, ev.selectionState.absoluteEnd) : null;Implementazione
public function get selectionState():SelectionState public function set selectionState(value:SelectionState):voidElementi API correlati
SelectionEvent | () | Funzione di costruzione |
public function SelectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, selectionState:SelectionState = null)| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5 |
Crea un oggetto evento contenente informazioni relative a un oggetto FlowOperation.
Parametritype:String — Il tipo di evento. I listener di eventi possono accedere a queste informazioni tramite la proprietà ereditata type. Esiste un solo tipo di evento SelectionEvent: SelectionEvent.SELECTION_CHANGE;
| |
bubbles:Boolean (default = false) | |
cancelable:Boolean (default = false) | |
selectionState:SelectionState (default = null) |
SELECTION_CHANGE | Costante |
public static const SELECTION_CHANGE:String = "selectionChange"| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5 |
La costante SelectionEvent.SELECTION_CHANGE definisce il valore della proprietà type dell'oggetto evento per un evento di selezione.
In questo esempio viene illustrato come rilevare le modifiche apportate alla selezione del testo in un flusso di testo. Le due fasi principali consistono nel chiamare il metodo addEventListener() sul flusso di testo e creare una funzione del gestore di eventi.
La chiamata a addEventListener() viene effettuata all'istanza TextFlow. Potete utilizzare la semplice stringa "selectionChange", ma è più sicuro utilizzare la costante statica SelectionEvent.SELECTION_CHANGE.
La funzione del gestore di eventi in questo esempio è denominata selectionHandler(). Il metodo selectionHandler() utilizza la funzione trace() per produrre istruzioni trace che indicano i punti iniziali e finali dell'intervallo di testo. Queste informazioni sono accessibili tramite la proprietà selectedElementRange dell'oggetto evento.
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, 02:44 PM Z