getContentWindow (Referencia da API do cliente)

Devolve a xanela de contido que representa un IFRAME ou un recurso web.

Nota

Este método só se admite na interface unificada.

Tipos de control soportados

iframe, recurso web

Sintaxe

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

Parámetros

Nome	Tipo	Obrigatorio	Descripción
successCallback	Function	Non	Función para chamar cando a operación se executa con éxito. Unha instancia da xanela de contido que representa o IFRAME ou recurso web pasa á función.
errorCallback	Function	Non	Unha función a chamar cando a operación falla.

Devolver valor

En caso de éxito, devolve unha promesa que contén unha instancia da xanela de contido que representa un IFRAME ou un recurso web.

Exemplo

O seguinte exemplo móstrase como se pode usar este método cun recurso web HTML (new_myWebResource.htm).

En primeiro lugar, engade o seguinte código no teu recurso web HTML:

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

A continuación, engade o seguinte código no xestionador de eventos 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();
            }
        )
    }
}

Un código de inicialización similar debe engadirse a un xestor de eventos TabStateChange se tal inicialización é necesaria. Calquera código de inicialización debe ser idempotente se se reutiliza. Por razóns de rendemento, o formulario pode destruír e reinicializar o control durante a navegación por pestanas.