Guida di riferimento di ActionScript® 3.0 per la piattaforma Adobe® Flash®
Home  |  Nascondi elenco pacchetti e classi |  Pacchetti  |  Classi  |  Novità  |  Indice  |  Appendici  |  Perché in inglese?
Filtri: Recupero dati dal server...
Recupero dati dal server...
flashx.textLayout.events 

FlowOperationEvent  - AS3

Pacchettoflashx.textLayout.events
Classepublic class FlowOperationEvent
EreditarietàFlowOperationEvent Inheritance Event Inheritance Object

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Un'istanza TextFlow invia questo evento subito prima dell'inizio di un'operazione e di nuovo dopo che l'operazione viene completata. Anche se l'oggetto evento inviato in entrambi i casi è un'istanza di FlowOperationEvent, gli eventi inviati prima e dopo un'operazione differiscono in modo significativo.

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.

Vedere gli esempi

Elementi API correlati



Proprietà pubbliche
 ProprietàDefinito da
 Inheritedbubbles : Boolean
[sola lettura] Indica se un evento è un evento di bubbling.
Event
 Inheritedcancelable : Boolean
[sola lettura] Indica se il comportamento associato all'evento può essere impedito.
Event
 Inheritedconstructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
 InheritedcurrentTarget : 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
 InheritedeventPhase : 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
 Inheritedtarget : Object
[sola lettura] Il target dell'evento.
Event
 Inheritedtype : String
[sola lettura] Il tipo di evento.
Event
Metodi pubblici
 MetodoDefinito 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
 Inherited
Duplica un'istanza di una sottoclasse Event.
Event
 Inherited
formatToString(className:String, ... arguments):String
Una funzione dell'utilità per l'implementazione del metodo toString() in classi Event ActionScript 3.0 personalizzate.
Event
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Verifica se sull'evento è stato chiamato il metodo preventDefault().
Event
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Annulla il comportamento predefinito di un evento se tale comportamento può essere annullato.
Event
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Impedisce l'elaborazione di tutti i listener di eventi nel nodo corrente e in tutti i nodi successivi del flusso di eventi.
Event
 Inherited
Impedisce l'elaborazione di tutti i listener di eventi nei nodi del flusso di eventi successivi a quello corrente.
Event
 Inherited
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.
Object
 Inherited
Restituisce una stringa che contiene tutte le proprietà dell'oggetto Event.
Event
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Costanti pubbliche
 CostanteDefinito 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
Descrizione delle proprietà

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):void

level

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):void

operation

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):void

Elementi API correlati

Descrizione della funzione di costruzione

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.

Parametri
type: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) — Indica se un evento è un evento di bubbling. Questo evento non si propaga.
 
cancelable:Boolean (default = false) — Indica se il comportamento associato all'evento può essere impedito. Questo evento può essere annullato chiamando il metodo Event.preventDefault() nella funzione del gestore di eventi.
 
operation:FlowOperation (default = null) — FlowOperation che sta per iniziare o è appena terminata.
 
level:int (default = 0) — Qualsiasi errore generato durante l'operazione.
 
error:Error (default = null)
Descrizione delle costanti

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.

FlowOperationEvent_example.as

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().");
            }
        }
    }
}




[ X ]Perché in inglese?
Il contenuto della Guida di riferimento di ActionScript 3.0 appare in inglese

Non tutte le parti della Guida di riferimento di ActionScript 3.0 sono tradotte in tutte le lingue. Quando un elemento del linguaggio non è tradotto, viene riportato in inglese. Ad esempio, la classe ga.controls.HelpBox non è tradotta in nessuna lingua. Pertanto, nella versione italiana della guida di riferimento, la descrizione della classe ga.controls.HelpBox è riportata in inglese.