用于 Adobe® Flash® Platform 的 ActionScript® 3.0 参考
主页  |  隐藏包列表和类列表 |   |   |  新增内容  |  索引  |  附录  |  为什么显示为英语?
过滤条件: AIR 30.0 和更早版本, Flash Player 30.0 和更早版本, Flash Lite 4
Flex 4.6 和更早版本, Flash Pro CS6 和更早版本
隐藏过滤条件
flash.events 

SecurityErrorEvent  - AS3

包 flash.events

接口
IEventDispatcher
 
AccelerometerEvent
ActivityEvent
AsyncErrorEvent
AudioOutputChangeEvent
AVDictionaryDataEvent
AVHTTPStatusEvent
AVPauseAtPeriodEndEvent
BrowserInvokeEvent    
ContextMenuEvent
DataEvent
DatagramSocketDataEvent    
DeviceRotationEvent    
DNSResolverEvent    
DRMAuthenticateEvent    
DRMAuthenticationCompleteEvent
DRMAuthenticationErrorEvent
DRMDeviceGroupErrorEvent
DRMDeviceGroupEvent
DRMErrorEvent
DRMLicenseRequestEvent
DRMMetadataEvent
DRMReturnVoucherCompleteEvent
DRMReturnVoucherErrorEvent
DRMStatusEvent
ErrorEvent
Event
EventDispatcher
EventPhase
FileListEvent    
FocusEvent
FullScreenEvent
GameInputEvent    
GeolocationEvent
GestureEvent
GesturePhase
HTMLUncaughtScriptExceptionEvent    
HTTPStatusEvent
IMEEvent
InvokeEvent    
IOErrorEvent
KeyboardEvent
LocationChangeEvent    
MediaEvent    
MouseEvent
NativeDragEvent    
NativeProcessExitEvent    
NativeWindowBoundsEvent    
NativeWindowDisplayStateEvent    
NetDataEvent
NetMonitorEvent
NetStatusEvent
OutputProgressEvent    
PermissionEvent
PressAndTapGestureEvent
ProgressEvent
RemoteNotificationEvent    
SampleDataEvent
ScreenMouseEvent    
SecurityErrorEvent
ServerSocketConnectEvent    
ShaderEvent
SoftKeyboardEvent
SoftKeyboardTrigger
SQLErrorEvent    
SQLEvent    
SQLUpdateEvent    
StageOrientationEvent    
StageVideoAvailabilityEvent
StageVideoEvent
StatusEvent
StorageVolumeChangeEvent    
SyncEvent
TextEvent
ThrottleEvent
ThrottleType
TimerEvent
TouchEvent
TouchEventIntent    
TransformGestureEvent
UncaughtErrorEvent
UncaughtErrorEvents
VideoEvent
VideoTextureEvent
VsyncStateChangeAvailabilityEvent    
flash.events
public class SecurityErrorEvent
继承SecurityErrorEvent Inheritance ErrorEvent Inheritance TextEvent Inheritance Event Inheritance Object

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9, Flash Lite 4

当出现安全错误时,对象将调度 SecurityErrorEvent 对象来报告此错误。通过该类所报告的安全错误一般是由异步操作(例如加载数据)产生的,这种情况下安全侵犯可能不会被立即列出。事件侦听器可以访问对象的 text 属性,以确定尝试过哪些操作以及涉及哪些 URL。如果没有事件侦听器,Flash Player 的调试版或 AIR Debug Launcher (ADL) 应用程序将自动显示包含 text 属性内容的错误消息。只有一种类型的安全错误事件:SecurityErrorEvent.SECURITY_ERROR

安全错误事件是针对任何目标对象进行调度的最终事件。这意味着对于遇到安全错误的目标对象,不能调度任何其他事件(包括一般错误事件)。

查看示例

相关 API 元素



公共属性
 属性由以下参数定义
 Inheritedbubbles : Boolean
[只读] 表示事件是否为冒泡事件。
Event
 Inheritedcancelable : Boolean
[只读] 表示是否可以阻止与事件相关联的行为。
Event
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 InheritedcurrentTarget : Object
[只读] 当前正在使用某个事件侦听器处理 Event 对象的对象。
Event
 InheritederrorID : int
[只读] 包含与特定错误相关联的引用数字。
ErrorEvent
 InheritedeventPhase : uint
[只读] 事件流中的当前阶段。
Event
 Inheritedtarget : Object
[只读] 事件目标。
Event
 Inheritedtext : String
在 textInput 事件中,由用户输入的字符或字符序列。
TextEvent
 Inheritedtype : String
[只读] 事件的类型。
Event
公共方法
 方法由以下参数定义
  
SecurityErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
创建一个 Event 对象,其中包含有关安全错误事件的信息。
SecurityErrorEvent
  
[覆盖] 创建 SecurityErrorEvent 对象的副本,并设置每个属性的值以匹配原始属性值。
SecurityErrorEvent
 Inherited
formatToString(className:String, ... arguments):String
用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。
Event
 Inherited
表示对象是否已经定义了指定的属性。
Object
 Inherited
检查是否已对事件调用 preventDefault() 方法。
Event
 Inherited
表示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
如果可以取消事件的默认行为,则取消该行为。
Event
 Inherited
表示指定的属性是否存在、是否可枚举。
Object
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。
Event
 Inherited
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。
Event
 Inherited
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。
Object
  
[覆盖] 返回一个字符串,其中包含 SecurityErrorEvent 对象的所有属性。
SecurityErrorEvent
 Inherited
返回指定对象的原始值。
Object
公共常量
 常量由以下参数定义
  SECURITY_ERROR : String = "securityError"
[静态] SecurityErrorEvent.SECURITY_ERROR 常量定义 securityError 事件对象的 type 属性值。
SecurityErrorEvent
构造函数详细信息

SecurityErrorEvent

()构造函数
public function SecurityErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9, Flash Lite 4

创建一个 Event 对象,其中包含有关安全错误事件的信息。将 Event 对象作为参数传递给事件侦听器。

参数
type:String — 事件的类型。事件侦听器可以通过继承的 type 属性访问此信息。只有一种类型的 error 事件:SecurityErrorEvent.SECURITY_ERROR
 
bubbles:Boolean (default = false) — 确定 Event 对象是否参与事件流的冒泡阶段。事件侦听器可以通过继承的 bubbles 属性访问此信息。
 
cancelable:Boolean (default = false) — 确定是否可以取消 Event 对象。事件侦听器可以通过继承的 cancelable 属性访问此信息。
 
text:String (default = "") — 要显示为错误消息的文本。事件侦听器可以通过 text 属性访问此信息。
 
id:int (default = 0) — 要与特定错误关联的引用数字。

相关 API 元素

方法详细信息

clone

()方法
override public function clone():Event

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9, Flash Lite 4

创建 SecurityErrorEvent 对象的副本,并设置每个属性的值以匹配原始属性值。

返回
Event — 其属性值与原始属性值匹配的新 securityErrorEvent 对象。

toString

()方法 
override public function toString():String

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9, Flash Lite 4

返回一个字符串,其中包含 SecurityErrorEvent 对象的所有属性。字符串的格式如下:

[securityErrorEvent type=value bubbles=value cancelable=value text=value errorID=value]errorId 仅在 Adobe AIR 中可用

返回
String — 一个字符串,其中包含 SecurityErrorEvent 对象的所有属性。
常量详细信息

SECURITY_ERROR

常量
public static const SECURITY_ERROR:String = "securityError"

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9, Flash Lite 4

SecurityErrorEvent.SECURITY_ERROR 常量定义 securityError 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target报告安全错误的网络对象。
text要显示为错误消息的文本。

相关 API 元素

SecurityErrorEventExample.as

以下示例使用 SecurityErrorEventExample 类来说明如何实例化侦听器方法 securityErrorHandler() 并将其设置为侦听将要调度的 securityError 事件。当 URLRequest 位置与调用 SWF 不完全属于同一个域,而且请求的域没有获得通过跨域策略文件进行跨域访问的授权时,会发生此事件。

要创建 SecurityErrorEvent,请将 http://www.[yourdomain].com 替换为一个未获得跨域访问授权的路径。

package {
    import flash.display.Sprite;
    import flash.net.URLLoader;
    import flash.net.URLRequest;
    import flash.events.SecurityErrorEvent;

    public class SecurityErrorEventExample extends Sprite {
        public function SecurityErrorEventExample() {
            var loader:URLLoader = new URLLoader();
            loader.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);

            var request:URLRequest = new URLRequest("http://www.[yourDomain].com");
            loader.load(request);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }
    }
}




[ X ]为什么显示为英语?
《ActionScript 3.0 参考》中的内容以英语显示

《ActionScript 3.0 参考》中的部分内容未翻译成所有语言。当某个语言元素未翻译时,将显示为英语。例如,ga.controls.HelpBox 类未翻译成任何语言。因此在简体中文版的参考中,ga.controls.HelpBox 类显示为英语。