Comparteix via


getContentWindow (Referència de l'API del client)

Retorna la finestra de contingut que representa un IFRAME o un recurs web.

Nota

Aquest mètode només s'admet a la interfície unificada.

Tipus de control admesos

iframe, recurs web

Sintaxi

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

Paràmetres

Nom Tipus Necessari Descripció
successCallback Function No Funció per cridar quan l'operació s'executa correctament. Es passa a la funció una instància de finestra de contingut que representa l'IFRAME o el recurs web.
errorCallback Function No Una funció per cridar quan l'operació falla.

Valor de retorn

En cas d'èxit, retorna una promesa que conté una instància de finestra de contingut que representa un IFRAME o un recurs web.

Exemple

L'exemple següent mostra com podeu utilitzar aquest mètode amb un recurs web HTML (new_myWebResource.htm).

En primer lloc, afegiu el codi següent al vostre recurs web HTML:

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

A continuació, afegiu el codi següent al controlador d'incidències 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();
            }
        )
    }
}

S'hauria d'afegir un codi d'inicialització similar a un controlador d'incidències TabStateChange si aquesta inicialització és necessària. Qualsevol codi d'inicialització hauria de ser idempotent si es reutilitza. Per raons de rendiment, el formulari pot destruir i reinicialitzar el control durant la navegació per pestanyes.