blob: 258d11d7a6aefacf4cb53d31cffc11c857d099ac [file] [log] [blame]
{ "type": "class",
"qname": "org.apache.royale.textLayout.events.FlowOperationEvent",
"baseClassname": "org.apache.royale.events.Event"
,
"description": "A TextFlow instance dispatches this event just before an operation commences and again just after an operation completes. Although the event object dispatched in both cases is an instance of FlowOperationEvent, the events dispatched before and after an operation differ in significant ways. <p>Before any operation is carried out, a TextFlow object dispatches a FlowOperationEvent with its <code>type</code> property set to <code>FlowOperationEvent.FLOW_OPERATION_BEGIN.</code> You can determine what type of operation is about to commence by checking the <code>operation</code> property. Events of type FLOW_OPERATION_BEGIN are cancellable, which means that if you decide that the operation should not proceed, you can call <code>Event.PreventDefault()</code> to cancel the operation. If you cancel the operation, the operation is not performed and the FLOW_OPERATION_END event is not dispatched. You may also choose to call back into the EditManager to do another operation before the operation that triggered the event is done. If you do this, the operations you initiate in your event handler will be undone as a single operation with the operation that triggered the event.</p> <p>If you allow the operation to proceed, TextFlow will dispatch a FlowOperationEvent upon completion of the operation with its <code>type</code> property set to <code>FlowOperationEvent.FLOW_OPERATION_END</code>. This event is dispatched before Flash Player throws any errors that may have occurred as a result of the operation. This gives you an opportunity to process the error before Flash Player throws the error. You can access the error through the event's <code>error</code> property. If you choose to handle the error in your event handler, you can prevent Flash Player from throwing the error by cancelling the FLOW_OPERATION_END event by calling <code>Event.preventDefault()</code>. You may also choose to call back into the EditManager to do some additional operations. If you do this, the operations that result will be undone as a unit with the operation that triggered the event. </p>",
"tags": [
{ "tagName": "see",
"values": ["org.apache.royale.textLayout.operations.FlowOperation"]},
{ "tagName": "playerversion",
"values": ["Flash 10", "AIR 1.5"]},
{ "tagName": "langversion",
"values": ["3.0"]} ],
"members": [
{ "type": "field",
"qname": "FLOW_OPERATION_BEGIN",
"return": "String",
"namespace": "public",
"bindable": [],
"details": ["static"],
"deprecated": {},
"description": "Defines the value of the <code>type</code> property of a <code>flowOperationBegin</code> event object. Dispatched before an operation is executed. Cancelling this event blocks the operation.",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 10", "AIR 1.5"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "field",
"qname": "FLOW_OPERATION_END",
"return": "String",
"namespace": "public",
"bindable": [],
"details": ["static"],
"deprecated": {},
"description": "Defines the value of the <code>type</code> property of a <code>flowOperationEnd</code> event object. Dispatched after an operation completes. Any errors are stored in <code>OperationEvent.error</code>. If there is an error, cancelling this event blocks the rethrow of the error. Generally speaking all errors are likely to be fatal. <p>Changing an operation at this time (after it has been executed) may fail.</p>",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 10", "AIR 1.5"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "field",
"qname": "FLOW_OPERATION_COMPLETE",
"return": "String",
"namespace": "public",
"bindable": [],
"details": ["static"],
"deprecated": {},
"description": "Defines the value of the <code>type</code> property of a <code>flowOperationComplete</code> event object. Dispatched after all operations including pending and composite operations are completed, composition is finished and the display is scrolled.",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 10", "AIR 1.5"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "accessor",
"access": "read-write",
"return": "org.apache.royale.textLayout.operations.FlowOperation",
"qname": "operation",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "The operation that is about to begin or has just ended.",
"tags": [
{ "tagName": "see",
"values": ["org.apache.royale.textLayout.operations.FlowOperation"]},
{ "tagName": "playerversion",
"values": ["Flash 10", "AIR 1.5"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "accessor",
"access": "read-write",
"return": "Error",
"qname": "error",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "The error thrown, if any, during an operation. If an error occurs during an operation, a reference to the error object is attached to the FLOW_OPERATION_END event. This give you the opportunity to deal with the error before Flash Player throws the error. If you cancel the event, Flash Player will not throw the error.",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 10", "AIR 1.5"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "accessor",
"access": "read-write",
"return": "int",
"qname": "level",
"namespace": "public",
"bindable": [],
"details": [],
"deprecated": {},
"description": "Operations may be merged into composite operations through nesting. This flag describes the nesting level of the operation.",
"tags": [
{ "tagName": "playerversion",
"values": ["Flash 10", "AIR 1.5"]},
{ "tagName": "langversion",
"values": ["3.0"]} ]},
{ "type": "method",
"qname": "org.apache.royale.textLayout.events.FlowOperationEvent",
"namespace": "",
"bindable": [],
"details": [],
"deprecated": {},
"description": "Creates an event object that contains information about a flow operation. inherited <code>type</code> property. There are two types: <code>FlowOperationEvent.FLOW_OPERATION_BEGIN</code>; <code>FlowOperationEvent.FLOW_OPERATION_END</code>. This event can be cancelled by calling the <code>Event.preventDefault()</code> method in your event handler function.",
"tags": [
{ "tagName": "param",
"values": ["type The type of the event. Event listeners can access this information through the", "bubbles Indicates whether an event is a bubbling event.This event does not bubble.", "cancelable Indicates whether the behavior associated with the event can be prevented.", "operation The FlowOperation that is about to commence or that has just ended.", "error Any Error generating during the operation."]},
{ "tagName": "playerversion",
"values": ["Flash 10", "AIR 1.5"]},
{ "tagName": "langversion",
"values": ["3.0"]} ],
"return": "",
"params": [{ "name": "type", "type": "String"},
{ "name": "bubbles", "type": "Boolean"},
{ "name": "cancelable", "type": "Boolean"},
{ "name": "operation", "type": "org.apache.royale.textLayout.operations.FlowOperation"},
{ "name": "level", "type": "int"},
{ "name": "error", "type": "Error"}]}
]
}