Paket | flashx.textLayout.events |
Klass | public class FlowOperationEvent |
Arv | FlowOperationEvent Event Object |
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5 |
Innan en åtgärd utförs skickar ett TextFlow-objekt en FlowOperationEvent med dess type
-egenskap inställd på FlowOperationEvent.FLOW_OPERATION_BEGIN.
Du kan ta reda på vilken typ av åtgärd som ska startas genom att kontrollera egenskapen operation
. Händelser av typen FLOW_OPERATION_BEGIN kan avbrytas, vilket betyder att om du bestämmer att åtgärden inte ska fortsätta kan du anropa Event.PreventDefault()
för att avbryta åtgärden. Om du avbryter åtgärden utförs den inte och händelsen FLOW_OPERATION_END skickas inte. Du kan också anropa tillbaka till EditManager och utföra en annan åtgärd innan den åtgärd som utlöste händelsen har slutförts. Om du gör detta kommer de åtgärder som du initierar i händelsehanteraren att ångras som en enda åtgärd med den åtgärd som utlöste händelsen.
Om du låter åtgärden fortsätta kommer TextFlow att skicka en FlowOperationEvent när åtgärden är slutförd med dess egenskap type
inställd på FlowOperationEvent.FLOW_OPERATION_END
. Denna händelse skickas innan Flash Player visar några fel som kan ha inträffat som ett resultat av åtgärden. Då kan du bearbeta felet innan det visas i Flash Player. Du kan hämta felet genom händelsens egenskap error
. Om du väljer att hantera felet i händelsehanteraren, kan du förhindra att Flash Player visar felet genom att avbryta händelsen FLOW_OPERATION_END genom att anropa Event.preventDefault()
. Du kan också välja att anropa tillbaka till EditManager för att utföra ytterligare åtgärder. Om du gör detta kommer de resulterande åtgärderna att ångras som en enhet med den åtgärd som utlöste händelsen.
Relaterade API-element
Egenskap | Definieras med | ||
---|---|---|---|
bubbles : Boolean [skrivskyddad]
indikerar om händelsen är en bubblande händelse. | Event | ||
cancelable : Boolean [skrivskyddad]
Indikerar om beteendet som är kopplat till händelsen kan förhindras. | Event | ||
constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | ||
currentTarget : Object [skrivskyddad]
Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. | Event | ||
error : Error
Det fel, om något, som uppstår under en åtgärd. | FlowOperationEvent | ||
eventPhase : uint [skrivskyddad]
Den nuvarande fasen i händelseflödet. | Event | ||
level : int
Åtgärder kan sammanfogas till sammansatta åtgärder via kapsling. | FlowOperationEvent | ||
operation : FlowOperation
Den åtgärd som ska börja eller precis har slutförts. | FlowOperationEvent | ||
target : Object [skrivskyddad]
Händelsens mål. | Event | ||
type : String [skrivskyddad]
Händelsens typ. | Event |
Metod | Definieras med | ||
---|---|---|---|
FlowOperationEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, operation:FlowOperation = null, level:int = 0, error:Error = null) Skapar ett händelseobjekt som innehåller information om en flödesåtgärd. | FlowOperationEvent | ||
Skapar ett duplikat av en instans av en Event-underklass. | Event | ||
Ett verktyg som används för att implementera metoden toString() i de anpassade klasserna ActionScript 3.0. | Event | ||
Anger om det finns en egenskap angiven för ett objekt. | Object | ||
Kontrollerar om preventDefault()-metoden har anropats för händelsen. | Event | ||
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | ||
Avbryter en händelses standardbeteende om det beteendet kan avbrytas. | Event | ||
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | ||
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | ||
Förhindrar behandling av händelsehanterare i den aktuella noden och alla noder som följer den aktuella noden i händelseflödet. | Event | ||
Förhindrar behandling av händelsehanterare i noder som följer den aktuella noden i händelseflödet. | Event | ||
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | ||
Returnerar en sträng som innehåller alla egenskaper i Event-objektet. | Event | ||
Returnerar det angivna objektets primitiva värde. | Object |
Konstant | Definieras med | ||
---|---|---|---|
FLOW_OPERATION_BEGIN : String = "flowOperationBegin" [statisk]
Definierar värdet på type-egenskapen i ett flowOperationBegin-händelseobjekt. | FlowOperationEvent | ||
FLOW_OPERATION_COMPLETE : String = "flowOperationComplete" [statisk]
Definierar värdet på type-egenskapen i ett flowOperationComplete-händelseobjekt. | FlowOperationEvent | ||
FLOW_OPERATION_END : String = "flowOperationEnd" [statisk]
Definierar värdet på type-egenskapen i ett flowOperationEnd-händelseobjekt. | FlowOperationEvent |
error | egenskap |
error:Error
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5 |
Det fel, om något, som uppstår under en åtgärd. Om ett fel inträffar under en åtgärd, bifogas en referens till felobjektet till händelsen FLOW_OPERATION_END. Då kan du bearbeta felet innan det uppstår i Flash Player. Om du avbryter händelsen uppstår felet inte.
Implementering
public function get error():Error
public function set error(value:Error):void
level | egenskap |
operation | egenskap |
operation:FlowOperation
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5 |
Den åtgärd som ska börja eller precis har slutförts.
Implementering
public function get operation():FlowOperation
public function set operation(value:FlowOperation):void
Relaterade API-element
FlowOperationEvent | () | Konstruktor |
public function FlowOperationEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, operation:FlowOperation = null, level:int = 0, error:Error = null)
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5 |
Skapar ett händelseobjekt som innehåller information om en flödesåtgärd.
Parametrartype:String — Händelsens typ. Händelseavlyssnare kan hämta informationen genom den ärvda egenskapen type . Det finns två typer: FlowOperationEvent.FLOW_OPERATION_BEGIN och FlowOperationEvent.FLOW_OPERATION_END .
| |
bubbles:Boolean (default = false ) — Anger om en händelse är en bubblingshändelse. Den här händelsen bubblar inte.
| |
cancelable:Boolean (default = false ) — Indikerar om beteendet som är kopplat till händelsen kan förhindras. Denna händelse kan avbrytas genom anrop av metoden Event.preventDefault() i händelsehanterarfunktionen.
| |
operation:FlowOperation (default = null ) — Den FlowOperation som ska börja eller precis har slutförts.
| |
level:int (default = 0 ) — Alla fel som genererats vid åtgärden.
| |
error:Error (default = null )
|
FLOW_OPERATION_BEGIN | Konstant |
public static const FLOW_OPERATION_BEGIN:String = "flowOperationBegin"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5 |
Definierar värdet på egenskapen type
för ett flowOperationBegin
-händelseobjekt. Skickas innan en åtgärd utförs. Om du avbryter händelsen blockeras åtgärden.
FLOW_OPERATION_COMPLETE | Konstant |
public static const FLOW_OPERATION_COMPLETE:String = "flowOperationComplete"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5 |
Definierar värdet på type
-egenskapen i ett flowOperationComplete
-händelseobjekt. Skickas när alla åtgärder, inklusive väntande och sammansatta åtgärder, har slutförts, när dispositionen är klar och visningen rullas.
FLOW_OPERATION_END | Konstant |
public static const FLOW_OPERATION_END:String = "flowOperationEnd"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5 |
Definierar värdet på type
-egenskapen för ett flowOperationEnd
-händelseobjekt. Skickas efter att en åtgärd slutförts. Alla fel lagras i OperationEvent.error
. Om det finns något fel kommer avbrottet av händelsen att blockera felet. Alla fel är egentligen allvarliga.
Om du ändrar en åtgärd nu (när den har utförts) kan ändringen misslyckas.
Det här exemplet visar hur du skapar en händelsehanterare som lyssnar efter början och slutet av en textflödesåtgärd. De två viktigaste stegen är att anropa metoden addEventListener()
i textflödet och att skapa en händelsehanterarfunktion.
Anropet till addEventListener()
görs på TextFlow-instansen. Du kan använda den enkla strängen "flowOperationBegin"
eller "flowOperationEnd"
, men det är säkrare att använda antingen den statiska konstanten FlowOperationEvent.FLOW_OPERATION_BEGIN
eller FlowOperationEvent.FLOW_OPERATION_END
.
Händelsehanterarfunktionerna i det här exemplet kallas opBeginHandler()
och opEndHandler()
. Metoden opBeginHandler()
använder trace()
-funktionen för att skapa en trace-programsats, som talar om att en klistra in-åtgärd har startats. Metoden opEndHandler()
använder också trace()
-funktionen, men skapar bara en trace-programsats om ett fel inträffar.
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, 01:40 PM Z