navigateToURL()

 

navigateToURL()

public function navigateToURL(request:URLRequest, window:String = null):void

在包含 Flash Player 容器的应用程序（通常是一个浏览器）中，打开或替换一个窗口。

注意：对于在浏览器中运行的本地 内容，只有在 SWF 文件和包含该文件的网页（如果有）位于受信任的本地安全沙箱时，才允许进行指定“javascript:”伪协议的 navigateToURL() 方法调用（通过作为第一个参数传递的 URLRequest 对象）。一些浏览器不支持通过 navigateToURL() 方法使用 javascript 协议。而应考虑使用 ExternalInterface API 的 call() 方法在包含该内容的 HTML 页中调用 JavaScript 方法。

有关详细信息，请参阅以下部分：

• Flash Player 安全性（在《ActionScript 3.0 编程》一书中）和有关 LiveDocs 的最新评论
• Flash Player 9 Security 白皮书

 

参数

	request:URLRequest — URLRequest 对象，指定要导航到哪个 URL。
	window:String (default = null) — 浏览器窗口或 HTML 帧，其中显示 request 参数指示的文档。可以输入某个特定窗口的名称，或使用以下值之一： "_self" 指定当前窗口中的当前帧。 "_blank" 指定一个新窗口。 "_parent" 指定当前帧的父级。 "_top" 指定当前窗口中的顶级帧。 如果没有为此参数指定值，将创建一个新的空窗口。在独立播放器中，可以指定新的 ("_blank") 窗口，也可以指定已命名的窗口。其它值不适用。 注意：如果在只能与本地文件系统内容交互的沙箱中运行的 SWF 文件中的代码调用 navigateToURL() 函数，并为 window 参数指定一个自定义窗口名称，该窗口名称将转换为一个随机名称。该名称的格式为 "_flashXXXXXXXX"，其中每个 X 均代表一个随机的十六进制数字。在同一会话中（直到您关闭包含浏览器窗口），如果您再次调用该函数并为 window 参数指定同一名称，将使用同一个随机字符串

package {
    import flash.display.Sprite;
    import flash.net.navigateToURL;
    import flash.net.URLRequest;
    import flash.net.URLVariables;

    public class NavigateToURLExample extends Sprite {

        public function NavigateToURLExample() {
            var url:String = "http://www.adobe.com";
            var variables:URLVariables = new URLVariables();
            variables.exampleSessionId = new Date().getTime();
            variables.exampleUserLabel = "Your Name";
            var request:URLRequest = new URLRequest(url);
            request.data = variables;
            try {            
                navigateToURL(request);
            }
            catch (e:Error) {
                // handle error here
            }
        }
    }
}