| Pacchetto | flashx.textLayout.events |
| Classe | public class FlowOperationEvent |
| Ereditarietà | FlowOperationEvent  Event Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5 |
Prima dell'esecuzione di un'operazione, un oggetto TextFlow invia un evento FlowOperationEvent con la relativa proprietà type impostata su FlowOperationEvent.FLOW_OPERATION_BEGIN. Potete determinare il tipo di operazione che sta per essere iniziata controllando la proprietà operation. Gli eventi di tipo FLOW_OPERATION_BEGIN sono annullabili. Questo significa che se decidete che l'operazione non deve continuare, potete chiamare Event.PreventDefault() per annullarla. Se annullate l'operazione, questa non viene eseguita e l'evento FLOW_OPERATION_END non viene inviato. Potete anche scegliere di richiamare EditManager per eseguire un'altra operazione prima che l'operazione nell'evento venga completata. In questo caso, le operazioni che eseguite nel gestore di eventi verranno annullate come un'unica operazione con l'operazione che ha attivato l'evento.
Se consentite all'operazione di continuare, al relativo completamento TextFlow invia un evento FlowOperationEvent con la relativa proprietà type impostata su FlowOperationEvent.FLOW_OPERATION_END. Questo evento viene inviato prima che Flash Player generi eventuali errori che potrebbero essersi verificati come risultato dell'operazione. In questo modo potrete elaborare l'errore prima che questo venga generato da Flash Player. Potete accedere all'errore tramite la proprietà error dell'evento. Se scegliete di gestire l'errore nel gestore di eventi, potete impedire a Flash Player di generare l'errore annullando l'evento FLOW_OPERATION_END mediante una chiamata a Event.preventDefault(). Potete anche scegliere di richiamare EditManager per eseguire ulteriori operazioni. In questo caso, le operazioni risultanti verranno annullate come un'unità con l'operazione che ha attivato l'evento.
Elementi API correlati
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 | |
| error : Error
L'errore generato, se presente, durante un'operazione. | FlowOperationEvent | ||
| eventPhase : uint [sola lettura]
La fase attuale del flusso di eventi. | Event | |
| level : int
Le operazioni possono essere unite in operazione composite tramite la nidificazione. | FlowOperationEvent | ||
| operation : FlowOperation
L'operazione che sta per iniziare o è appena terminata. | FlowOperationEvent | ||
| target : Object [sola lettura]
Il target dell'evento. | Event | |
| type : String [sola lettura]
Il tipo di evento. | Event | |
| Metodo | Definito da | ||
|---|---|---|---|
FlowOperationEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, operation:FlowOperation = null, level:int = 0, error:Error = null) Crea un oggetto evento contenente informazioni relative a un oggetto FlowOperation. | FlowOperationEvent | ||
|
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 | ||
|---|---|---|---|
| FLOW_OPERATION_BEGIN : String = "flowOperationBegin" [statico]
Definisce il valore della proprietà type di un oggetto evento flowOperationBegin. | FlowOperationEvent | ||
| FLOW_OPERATION_COMPLETE : String = "flowOperationComplete" [statico]
Definisce il valore della proprietà type di un oggetto evento flowOperationComplete. | FlowOperationEvent | ||
| FLOW_OPERATION_END : String = "flowOperationEnd" [statico]
Definisce il valore della proprietà type di un oggetto evento flowOperationEnd. | FlowOperationEvent | ||
error | proprietà |
error:Error| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5 |
L'errore generato, se presente, durante un'operazione. Se si verifica un errore durante un'operazione, viene associato un riferimento all'oggetto error all'evento FLOW_OPERATION_END. In questo modo avrete la possibilità di gestire l'errore prima che questo venga generato da Flash Player. Se annullate l'evento, l'errore non verrà generato da Flash Player.
Implementazione
public function get error():Error public function set error(value:Error):voidlevel | proprietà |
level:int| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5 |
Le operazioni possono essere unite in operazione composite tramite la nidificazione. Questo flag descrive il livello di nidificazione dell'operazione.
Implementazione
public function get level():int public function set level(value:int):voidoperation | proprietà |
operation:FlowOperation| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5 |
L'operazione che sta per iniziare o è appena terminata.
Implementazione
public function get operation():FlowOperation public function set operation(value:FlowOperation):voidElementi API correlati
FlowOperationEvent | () | Funzione di costruzione |
public function FlowOperationEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, operation:FlowOperation = null, level:int = 0, error:Error = 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. Sono disponibili due tipi: FlowOperationEvent.FLOW_OPERATION_BEGIN; FlowOperationEvent.FLOW_OPERATION_END.
| |
bubbles:Boolean (default = false) | |
cancelable:Boolean (default = false)Event.preventDefault() nella funzione del gestore di eventi.
| |
operation:FlowOperation (default = null) | |
level:int (default = 0) | |
error:Error (default = null) |
FLOW_OPERATION_BEGIN | Costante |
public static const FLOW_OPERATION_BEGIN:String = "flowOperationBegin"| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5 |
Definisce il valore della proprietà type di un oggetto evento flowOperationBegin inviato prima dell'esecuzione di un'operazione. L'annullamento di questo evento blocca l'operazione.
FLOW_OPERATION_COMPLETE | Costante |
public static const FLOW_OPERATION_COMPLETE:String = "flowOperationComplete"| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5 |
Definisce il valore della proprietà type di un oggetto evento flowOperationComplete. Inviato dopo avere completato tutte le operazioni, incluse quelle in attesa e composite, terminato la composizione e fatto scorrere la visualizzazione.
FLOW_OPERATION_END | Costante |
public static const FLOW_OPERATION_END:String = "flowOperationEnd"| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5 |
Definisce il valore della proprietà type di un oggetto evento flowOperationEnd inviato dopo il completamento di un'operazione. Gli eventuali errori vengono memorizzati in OperationEvent.error. Se è presente un errore, l'annullamento di questo evento blocca la generazione ripetuta dell'errore. In termini generici, tutti gli errori sono potenzialmente irreversibili.
La modifica di un'operazione a questo punto (dopo che è stata eseguita) potrebbe non riuscire.
Questo esempio illustra come creare un gestore di eventi che rileva l'inizio e la fine di un'operazione su 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 "flowOperationBegin" o "flowOperationEnd", ma è più sicuro utilizzare la costante statica FlowOperationEvent.FLOW_OPERATION_BEGIN o FlowOperationEvent.FLOW_OPERATION_END, rispettivamente.
Le funzioni del gestore di eventi in questo esempio sono denominate opBeginHandler() e opEndHandler(). Il metodo opBeginHandler() utilizza la funzione trace() per produrre un'istruzione trace che indica l'avvio di un'operazione di incolla. Il metodo opEndHandler() utilizza a sua volta la funzione trace(), ma produce un'istruzione trace solo in caso di errore.
package flashx.textLayout.events.examples
{
import flash.display.Sprite;
import flashx.textLayout.compose.StandardFlowComposer;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.conversion.TextConverter;
import flashx.textLayout.edit.EditManager;
import flashx.textLayout.elements.TextFlow;
import flashx.textLayout.events.FlowOperationEvent;
import flashx.textLayout.operations.FlowOperation;
import flashx.textLayout.operations.PasteOperation;
import flashx.undo.UndoManager;
public class FlowOperationEvent_example extends Sprite
{
private var inputContainer:Sprite;
private var inputTextFlow:TextFlow;
private var inputController:ContainerController;
private var inputEditManager:EditManager;
private var inputUndoManager:UndoManager;
public function FlowOperationEvent_example()
{
var replaceText:String = "paste text here";
inputTextFlow = new TextFlow();
inputContainer = new Sprite();
inputContainer.x = 30;
inputContainer.y = 100;
this.stage.addChild( inputContainer );
inputController = new ContainerController(inputContainer, 225, 20);
inputController.verticalScrollPolicy = flashx.textLayout.container.ScrollPolicy.OFF;
inputTextFlow = TextConverter.importToFlow(replaceText, TextConverter.PLAIN_TEXT_FORMAT);
inputTextFlow.flowComposer = new StandardFlowComposer();
inputTextFlow.flowComposer.addController(inputController);
inputUndoManager = new UndoManager();
inputEditManager = new EditManager(inputUndoManager);
inputTextFlow.interactionManager = inputEditManager;
inputTextFlow.addEventListener(FlowOperationEvent.FLOW_OPERATION_BEGIN, opBeginHandler);
inputTextFlow.addEventListener(FlowOperationEvent.FLOW_OPERATION_END, opEndHandler);
inputTextFlow.flowComposer.updateAllControllers();
}
private function opBeginHandler(evt:FlowOperationEvent):void {
var flowOp:FlowOperation = evt.operation;
if(flowOp is PasteOperation) {
trace("You can cancel or modify the paste operation in this event handler.");
}
}
private function opEndHandler(evt:FlowOperationEvent):void {
var flowOp:FlowOperation = evt.operation;
if(evt.error) {
trace("You can handle the error here and call preventDefault().");
}
}
}
}
Tue Jun 12 2018, 02:44 PM Z