Paket | flashx.textLayout.events |
Sınıf | public class FlowOperationEvent |
Miras Alma | FlowOperationEvent Event Object |
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5 |
Herhangi bir işlem gerçekleştirilmeden önce, bir TextFlow nesnesi type
özelliği FlowOperationEvent.FLOW_OPERATION_BEGIN ayarına getirilmiş bir şekilde bir FlowOperationEvent gönderir.
operation
özelliğini denetleyerek hangi tür işlemin başlamak üzere olduğunu belirleyebilirsiniz. FLOW_OPERATION_BEGIN türündeki olaylar iptal edilebilir, başka bir deyişle, işlemin ilerleyip ilerlemeyeceğine karar verirseniz, işlemi iptal etmek için Event.PreventDefault()
öğesini çağırabilirsiniz. İşlemi iptal ederseniz, işlem gerçekleştirilmez ve FLOW_OPERATION_END olayı gönderilmez. Ayrıca, olayı tetikleyen işlemden önce başka bir işlem yapmak için EditManager öğesine geri çağrı yapmayı da seçebilirsiniz. Bunu yapmayı seçerseniz, olay işleyicinizde başlattığınız işlemler olayı tetikleyen işlemle beraber tek bir işlem olarak geri alınır.
İşlemin devam etmesine izin verirseniz, type
özelliği FlowOperationEvent.FLOW_OPERATION_END
olarak ayarlanmış şekilde, işlemin tamamlanmasının ardından TextFlow öğesi bir FlowOperationEvent gönderir. Flash Player, işlem sonucunda oluşabilecek herhangi bir hatayı atmadan önce bu olay gönderilir. Bu da, Flash Player hatayı atmadan önce sizin için hatayı işleme fırsatı sunar. Olayın error
özelliği yoluyla hataya erişebilirsiniz. Olay işleyicisinde hatayı işlemeyi seçerseniz, Event.preventDefault()
öğesini çağırarak FLOW_OPERATION_END olayını iptal edip Flash Player'ın hata atmasını önleyebilirsiniz. Ayrıca, bazı ek işlemler yapmak için EditManager öğesine geri çağrı yapmayı da seçebilirsiniz. Bunu yapmayı seçerseniz, ortaya çıkan işlemler olayı tetikleyen işlemle beraber bir birim olarak geri alınır.
İlgili API Öğeleri
Özellik | Tanımlayan: | ||
---|---|---|---|
bubbles : Boolean [salt okunur]
Bir olayın köpüren bir olay olup olmadığını belirtir. | Event | ||
cancelable : Boolean [salt okunur]
Olayla ilişkilendirilmiş davranışın önlenebilir olup olmadığını gösterir. | Event | ||
constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | ||
currentTarget : Object [salt okunur]
Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. | Event | ||
error : Error
Varsa, işlem sırasında atılan hata. | FlowOperationEvent | ||
eventPhase : uint [salt okunur]
Olay akışındaki geçerli aşama. | Event | ||
level : int
İşlemler yuvalama yoluyla bileşik işlemler olacak şekilde birleştirilebilir. | FlowOperationEvent | ||
operation : FlowOperation
Başlamak üzere olan veya henüz bitmiş olan işlem. | FlowOperationEvent | ||
target : Object [salt okunur]
Olay hedefi. | Event | ||
type : String [salt okunur]
Olay türü. | Event |
Yöntem | Tanımlayan: | ||
---|---|---|---|
FlowOperationEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, operation:FlowOperation = null, level:int = 0, error:Error = null) Akış işlemiyle ilgili bilgileri içeren bir olay nesnesi oluşturur. | FlowOperationEvent | ||
Event alt sınıfının bir örneğini çoğaltır. | Event | ||
Özel ActionScript 3.0 Event sınıfınızdaki toString() yöntemini uygulamak için bir yardımcı işlev. | Event | ||
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir. | Object | ||
Olayda preventDefault() öğesinin çağrılmış olup olmadığını kontrol eder. | Event | ||
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir. | Object | ||
Bir olayın varsayılan davranışını, bu yapılabiliyorsa iptal eder. | Event | ||
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir. | Object | ||
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar. | Object | ||
Olay akışında geçerli düğümdeki ve ondan sonra gelen düğümlerdeki olay dinleyicilerin işlenmesini engeller. | Event | ||
Olay akışında geçerli düğümden sonra gelen düğümlerdeki olay dinleyicilerin işlenmesini engeller. | Event | ||
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür. | Object | ||
Event nesnesinin tüm özelliklerini içeren bir dize döndürülür. | Event | ||
Belirtilen nesnenin temel değerini döndürür. | Object |
Sabit | Tanımlayan: | ||
---|---|---|---|
FLOW_OPERATION_BEGIN : String = "flowOperationBegin" [statik]
Bir flowOperationBegin olay nesnesinin type özelliğinin değerini tanımlar. | FlowOperationEvent | ||
FLOW_OPERATION_COMPLETE : String = "flowOperationComplete" [statik]
Bir flowOperationComplete olay nesnesinin type özelliğinin değerini tanımlar. | FlowOperationEvent | ||
FLOW_OPERATION_END : String = "flowOperationEnd" [statik]
Bir flowOperationEnd olay nesnesinin type özelliğinin değerini tanımlar. | FlowOperationEvent |
error | özellik |
error:Error
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5 |
Varsa, işlem sırasında atılan hata. Bir işlem sırasında hata oluşursa, hata nesnesine bir başvuru, FLOW_OPERATION_END olayına eklenir. Bu da, Flash Player hatayı atmadan önce sizin için hatayı işleme fırsatı sunar. Olayı iptal ederseniz, Flash Player hata atmaz.
Uygulama
public function get error():Error
public function set error(value:Error):void
level | özellik |
operation | özellik |
operation:FlowOperation
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5 |
Başlamak üzere olan veya henüz bitmiş olan işlem.
Uygulama
public function get operation():FlowOperation
public function set operation(value:FlowOperation):void
İlgili API Öğeleri
FlowOperationEvent | () | Yapıcı |
public function FlowOperationEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, operation:FlowOperation = null, level:int = 0, error:Error = null)
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5 |
Akış işlemiyle ilgili bilgileri içeren bir olay nesnesi oluşturur.
Parametrelertype:String — Olayın türü. Olay dinleyicileri bu bilgilere miras alınan type özelliği üzerinden erişebilir. İki tür vardır: FlowOperationEvent.FLOW_OPERATION_BEGIN ; FlowOperationEvent.FLOW_OPERATION_END .
| |
bubbles:Boolean (default = false ) — Bir olayın köpürme olayı olup olmadığını belirtir. Bu olay köpürmez.
| |
cancelable:Boolean (default = false ) — Olayla ilişkilendirilmiş davranışın önlenebilir olup olmadığını gösterir. Olay işleyicisi işlevinde Event.preventDefault() yöntemi çağrılarak bu olay iptal edilebilir.
| |
operation:FlowOperation (default = null ) — Başlamak üzere olan veya henüz bitmiş olan FlowOperation.
| |
level:int (default = 0 ) — İşlem sırasında oluşan herhangi bir Error.
| |
error:Error (default = null )
|
FLOW_OPERATION_BEGIN | Sabit |
public static const FLOW_OPERATION_BEGIN:String = "flowOperationBegin"
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5 |
Bir flowOperationBegin
olay nesnesinin type
özelliğinin değerini tanımlar. Bir işlem yürütülmeden önce gönderilir. Bu olay iptal edildiğinde işlem engellenir.
FLOW_OPERATION_COMPLETE | Sabit |
public static const FLOW_OPERATION_COMPLETE:String = "flowOperationComplete"
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5 |
Bir flowOperationComplete
olay nesnesinin type
özelliğinin değerini tanımlar. Bekleyen ve bileşik işlemler dahil tüm işlemler tamamlandıktan, oluşturma bittikten ve görüntü kaydırıldıktan sonra gönderilir.
FLOW_OPERATION_END | Sabit |
public static const FLOW_OPERATION_END:String = "flowOperationEnd"
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5 |
Bir flowOperationEnd
olay nesnesinin type
özelliğinin değerini tanımlar. Bir işlem tamamlandıktan sonra gönderilir. Tüm hatalar OperationEvent.error
içinde saklanır. Bir hata varsa, bu olay iptal edildiğinde hatanın yeniden atılması engellenir. Genel olarak konuşmak gerekirse, tüm hatalar hayati olabilir.
Bu noktada (çalıştırıldıktan sonra) bir işlemin değiştirilmesi başarısız olabilir.
Bu örnek bir metin akışı işleminin başlangıcı ve sonu için dinleyen bir olay işleyicisinin nasıl oluşturulacağını gösterir. İki temel adım, metin akışında addEventListener()
yönteminin çağrılması ve bir olay işleyicisi işlevi oluşturulmasıdır.
addEventListener()
öğesine yapılan çağrı, TextFlow örneğinde yapılır. Basit "flowOperationBegin"
veya "flowOperationEnd"
dizelerini kullanabilirsiniz ancak FlowOperationEvent.FLOW_OPERATION_BEGIN
statik sabitini veya aynı şekilde FlowOperationEvent.FLOW_OPERATION_END
sabitini kullanmak daha güvenlidir.
Bu örnekteki olay işleyicisi işlevleri opBeginHandler()
ve opEndHandler()
olarak adlandırılmıştır. opBeginHandler()
yöntemi, bir yapıştırma işleminin başladığını gösteren bir izleme ifadesi oluşturmak için trace()
işlevini kullanır. Ayrıca opEndHandler()
yöntemi de trace()
işlevini kullanır ancak yalnızca bir hata oluştuğunda bir izleme ifadesi üretir.
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:09 PM Z