getContentWindow (客户端 API 参考)

返回表示 IFRAME 或 Web 资源的内容窗口。

注释

此方法仅在 统一接口上受支持。

支持的控件类型

iframe、Web 资源

Syntax

formContext.getControl(arg).getContentWindow().then(successCallback, errorCallback);

参数

Name 类型 必选 Description
successCallback 功能 成功执行作时要调用的函数。 表示 IFRAME 或 Web 资源的内容窗口实例将传递给函数。
errorCallback 功能 作失败时要调用的函数。

返回值

成功后,返回一个承诺,其中包含表示 IFRAME 或 Web 资源的内容窗口实例。

Example

以下示例演示如何将此方法用于 HTML Web 资源(new_myWebResource.htm)。

首先,在 HTML Web 资源中添加以下代码:

// This script should be in the HTML web resource.
function doStuff() {
    // Add desired script logic that executes on form load.
}

接下来,在 OnLoad 事件处理程序中添加以下代码:

// This should be in a script loaded on the form. 
// form_onload is a handler for the form onload event.
function form_onload(executionContext) {
    var formContext = executionContext.getFormContext();
    var wrControl = formContext.getControl("WebResource_CustomName");
    if (wrControl) {
        wrControl.getContentWindow().then(
            function (contentWindow) {
                contentWindow.doStuff();
            }
        )
    }
}

如果需要此类初始化,应将类似的初始化代码添加到 TabStateChange 事件处理程序 。 如果重复使用初始化代码,则任何初始化代码都应是幂等的。 出于性能原因,窗体可能会在选项卡导航期间销毁并重新初始化控件。