（仅限 BlazeDS）
包mx.messaging.events
类public class MessageFaultEvent
继承MessageFaultEvent Inheritance Event Inheritance Object

MessageFaultEvent 类用于在消息传送系统中传送错误消息。


公共属性
 属性定义方
 Inheritedbubbles : Boolean
[只读 (read-only)] 指示事件是否为冒泡事件。
Event
 Inheritedcancelable : Boolean
[只读 (read-only)] 指示是否可以阻止与事件相关联的行为。
Event
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 InheritedcurrentTarget : Object
[只读 (read-only)] 当前正在使用某个事件侦听器处理 Event 对象的对象。
Event
 InheritedeventPhase : uint
[只读 (read-only)] 事件流中的当前阶段。
Event
  faultCode : String
[只读 (read-only)] 提供对特定于目标的失败代码的访问权限。
MessageFaultEvent
  faultDetail : String
[只读 (read-only)] 提供有关此失败特定于目标的详细信息。
MessageFaultEvent
  faultString : String
[只读 (read-only)] 提供对此失败特定于目标的原因的访问权限。
MessageFaultEvent
  message : ErrorMessage
此事件的 ErrorMessage。
MessageFaultEvent
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
  rootCause : Object
[只读 (read-only)] 提供对此失败的根本原因的访问权限（如果存在）。
MessageFaultEvent
 Inheritedtarget : Object
[只读 (read-only)] 事件目标。
Event
 Inheritedtype : String
[只读 (read-only)] 事件的类型。
Event
公共方法
 方法定义方
  
MessageFaultEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, message:ErrorMessage = null)
构造一个错误消息事件的实例，以提供指定消息和错误信息。
MessageFaultEvent
  
clone():Event
克隆 MessageFaultEvent。
MessageFaultEvent
  
createEvent(msg:ErrorMessage):MessageFaultEvent
[静态] 用于创建不起泡且不可取消的新 MessageFaultEvent 的实用程序方法。
MessageFaultEvent
 Inherited
formatToString(className:String, ... arguments):String
用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。
Event
 Inherited
hasOwnProperty(name:String):Boolean
指示对象是否已经定义了指定的属性。
Object
 Inherited
isDefaultPrevented():Boolean
检查是否已对事件调用 preventDefault() 方法。
Event
 Inherited
isPrototypeOf(theClass:Object):Boolean
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
preventDefault():void
如果可以取消事件的默认行为，则取消该行为。
Event
 Inherited
propertyIsEnumerable(name:String):Boolean
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
设置循环操作动态属性的可用性。
Object
 Inherited
stopImmediatePropagation():void
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。
Event
 Inherited
stopPropagation():void
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。
Event
  
toString():String
返回 MessageFaultEvent 的字符串表示形式。
MessageFaultEvent
 Inherited
valueOf():Object
返回指定对象的原始值。
Object
公共常量
 常量定义方
 InheritedACTIVATE : String = "activate"
[静态] ACTIVATE 常量定义 activate 事件对象的 type 属性的值。
Event
 InheritedADDED : String = "added"
[静态] Event.ADDED 常量定义 added 事件对象的 type 属性值。
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[静态] Event.ADDED_TO_STAGE 常量定义 addedToStage 事件对象的 type 属性值。
Event
 InheritedCANCEL : String = "cancel"
[静态] Event.CANCEL 常量定义 cancel 事件对象的 type 属性的值。
Event
 InheritedCHANGE : String = "change"
[静态] Event.CHANGE 常量定义 change 事件对象的 type 属性值。
Event
 InheritedCLEAR : String = "clear"
[静态] Event.CLEAR 常量定义 clear 事件对象的 type 属性的值。
Event
 InheritedCLOSE : String = "close"
[静态] Event.CLOSE 常量定义 close 事件对象的 type 属性的值。
Event
 InheritedAIR-only CLOSING : String = "closing"
[静态] Event.CLOSING 常量定义 closing 事件对象的 type 属性值。
Event
 InheritedCOMPLETE : String = "complete"
[静态] Event.COMPLETE 常量定义 complete 事件对象的 type 属性值。
Event
 InheritedCONNECT : String = "connect"
[静态] Event.CONNECT 常量定义 connect 事件对象的 type 属性值。
Event
 InheritedCOPY : String = "copy"
[静态] 定义 copy 事件对象的 type 属性值。
Event
 InheritedCUT : String = "cut"
[静态] 定义 cut 事件对象的 type 属性值。
Event
 InheritedDEACTIVATE : String = "deactivate"
[静态] Event.DEACTIVATE 常量定义 deactivate 事件对象的 type 属性值。
Event
 InheritedDISPLAYING : String = "displaying"
[静态] Event.DISPLAYING 常量定义 displaying 事件对象的 type 属性值。
Event
 InheritedENTER_FRAME : String = "enterFrame"
[静态] Event.ENTER_FRAME 常量定义 enterFrame 事件对象的 type 属性值。
Event
 InheritedEXIT_FRAME : String = "exitFrame"
[静态] Event.EXIT_FRAME 常量定义 exitFrame 事件对象的 type 属性的值。
Event
 InheritedAIR-only EXITING : String = "exiting"
[静态] Event.EXITING 常量定义 exiting 事件对象的 type 属性值。
Event
  FAULT : String = "fault"
[静态] FAULT 事件类型；当消息发生错误时调度。
MessageFaultEvent
 InheritedFRAME_CONSTRUCTED : String = "frameConstructed"
[静态] Event.FRAME_CONSTRUCTED 常量定义 frameConstructed 事件对象的 type 属性的值。
Event
 InheritedFULLSCREEN : String = "fullScreen"
[静态] Event.FULL_SCREEN 常量定义 fullScreen 事件对象的 type 属性值。
Event
 InheritedAIR-only HTML_BOUNDS_CHANGE : String = "htmlBoundsChange"
[静态] Event.HTML_BOUNDS_CHANGE 常量定义 htmlBoundsChange 事件对象的 type 属性值。
Event
 InheritedAIR-only HTML_DOM_INITIALIZE : String = "htmlDOMInitialize"
[静态] Event.HTML_DOM_INITIALIZE 常量定义 htmlDOMInitialize 事件对象的 type 属性值。
Event
 InheritedAIR-only HTML_RENDER : String = "htmlRender"
[静态] Event.HTML_RENDER 常量定义 htmlRender 事件对象的 type 属性值。
Event
 InheritedID3 : String = "id3"
[静态] Event.ID3 常量定义 id3 事件对象的 type 属性值。
Event
 InheritedINIT : String = "init"
[静态] Event.INIT 常量定义 init 事件对象的 type 属性值。
Event
 InheritedAIR-only LOCATION_CHANGE : String = "locationChange"
[静态] Event.LOCATION_CHANGE 常量定义 locationChange 事件对象的 type 属性值。
Event
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[静态] Event.MOUSE_LEAVE 常量定义 mouseLeave 事件对象的 type 属性值。
Event
 InheritedAIR-only NETWORK_CHANGE : String = "networkChange"
[静态] Event.NETWORK_CHANGE 常量定义 networkChange 事件对象的 type 属性值。
Event
 InheritedOPEN : String = "open"
[静态] Event.OPEN 常量用于定义 open 事件对象的 type 属性值。
Event
 InheritedPASTE : String = "paste"
[静态] Event.PASTE 常量定义 paste 事件对象的 type 属性的值。
Event
 InheritedREMOVED : String = "removed"
[静态] Event.REMOVED 常量定义 removed 事件对象的 type 属性值。
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[静态] Event.REMOVED_FROM_STAGE 常量定义 removedFromStage 事件对象的 type 属性值。
Event
 InheritedRENDER : String = "render"
[静态] Event.RENDER 常量定义 render 事件对象的 type 属性的值。
Event
 InheritedRESIZE : String = "resize"
[静态] Event.RESIZE 常量定义 resize 事件对象的 type 属性的值。
Event
 InheritedSCROLL : String = "scroll"
[静态] Event.SCROLL 常量定义 scroll 事件对象的 type 属性值。
Event
 InheritedSELECT : String = "select"
[静态] Event.SELECT 常量定义 select 事件对象的 type 属性的值。
Event
 InheritedSELECT_ALL : String = "selectAll"
[静态] Event.SELECT_ALL 常量定义 selectAll 事件对象的 type 属性的值。
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[静态] Event.SOUND_COMPLETE 常量定义 soundComplete 事件对象的 type 属性值。
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[静态] Event.TAB_CHILDREN_CHANGE 常量定义 tabChildrenChange 事件对象的 type 属性值。
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[静态] Event.TAB_ENABLED_CHANGE 常量定义 tabEnabledChange 事件对象的 type 属性值。
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[静态] Event.TAB_INDEX_CHANGE 常量定义 tabIndexChange 事件对象的 type 属性值。
Event
 InheritedUNLOAD : String = "unload"
[静态] Event.UNLOAD 常量定义 unload 事件对象的 type 属性值。
Event
 InheritedAIR-only USER_IDLE : String = "userIdle"
[静态] Event.USER_IDLE 常量定义 userIdle 事件对象的 type 属性值。
Event
 InheritedAIR-only USER_PRESENT : String = "userPresent"
[静态] Event.USER_PRESENT 常量定义 userPresent 事件对象的 type 属性值。
Event
属性详细信息
faultCode属性
faultCode:String  [只读 (read-only)]

提供对特定于目标的失败代码的访问权限。有关更具体的详细信息，请参阅 faultString 和 faultDetails 属性。

远程目标可提供错误代码的格式，但通常为：host.operation.error，例如，"Server.Connect.Failed"



实现
    public function get faultCode():String

另请参见

faultString
faultDetail
faultDetail属性 
faultDetail:String  [只读 (read-only)]

提供有关此失败特定于目标的详细信息。

错误详细信息通常是对远程目标引发的异常的堆栈跟踪。



实现
    public function get faultDetail():String

另请参见

faultString
faultCode
faultString属性 
faultString:String  [只读 (read-only)]

提供对此失败特定于目标的原因的访问权限。



实现
    public function get faultString():String

另请参见

faultCode
faultDetail
message属性 
public var message:ErrorMessage

此事件的 ErrorMessage。

rootCause属性 
rootCause:Object  [只读 (read-only)]

提供对此失败的根本原因的访问权限（如果存在）。如果是目标引发的自定义异常，则根本原因不过是由 ErrorMessage 传输引起的顶级失败。



实现
    public function get rootCause():Object

另请参见

MessageFaultEvent.rootCause
构造函数详细信息
MessageFaultEvent()构造函数
public function MessageFaultEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, message:ErrorMessage = null)

构造一个错误消息事件的实例，以提供指定消息和错误信息。

参数
type:String — MessageAckEvent 的类型。
 
bubbles:Boolean (default = false) — 指定该事件是否可以在显示列表层次结构得到冒泡处理。
 
cancelable:Boolean (default = false) — 指示是否可以阻止与事件相关联的行为。
 
message:ErrorMessage (default = null) — 与错误相关联的 ErrorMessage。
方法详细信息
clone()方法
override public function clone():Event

克隆 MessageFaultEvent。

返回
Event — 此 MessageFaultEvent 的副本。
createEvent()方法 
public static function createEvent(msg:ErrorMessage):MessageFaultEvent

用于创建不起泡且不可取消的新 MessageFaultEvent 的实用程序方法。

参数

msg:ErrorMessage — 与错误相关联的 ErrorMessage。

返回
MessageFaultEvent — 新 MessageFaultEvent。
toString()方法 
override public function toString():String

返回 MessageFaultEvent 的字符串表示形式。

返回
String — MessageFaultEvent 的字符串表示形式。
常量详细信息
FAULT常量
public static const FAULT:String = "fault"

FAULT 事件类型；当消息发生错误时调度。

此常数的值为 "fault"。

事件对象的属性有下列值：

属性值
bubbles false
cancelable false
currentTarget 用于定义处理该事件的事件侦听器的 Object。例如，如果您使用 myButton.addEventListener() 注册某个事件侦听器，则 myButton 为 currentTarget 的值。
faultCode 提供有关此失败的特定于目标的详细信息。
faultDetail 提供对此失败特定于目标的原因的访问权限。
faultString 如果通道本身未引发失败，则提供对此失败根本原因的访问权限。
message 此事件的 ErrorMessage。
rootCause 提供对此失败的根本原因的访问权限（如果存在）。
target 调度该事件的 Object；它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。




© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Sun Dec 14 2008, 10:39 PM -08:00