getContentWindow (kliendi API viide)

Tagastab sisuakna, mis tähistab IFRAME-i või veebiressurssi.

Märkus.

Seda meetodit toetatakse ainult ühtses liideses.

Toetatud juhtelemenditüübid

iframe, veebiressurss

Süntaks

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

Parameetrid

Nimi	Tüüp	Nõutav	Kirjeldus
successCallback	Function	Ei	Funktsioon, mis helistab, kui toiming on edukalt käivitatud. Funktsioonile edastatakse ifRAME-i või veebiressurssi tähistav sisuaknaeksemplar.
errorCallback	Function	Ei	Funktsioon, mida kutsuda, kui toiming nurjub.

Tagastatav väärtus

Edu korral tagastab lubaduse, mis sisaldab SISUAKNA eksemplari, mis tähistab IFRAME-i või veebiressurssi.

Näide

Järgmises näites kirjeldatakse, kuidas saate seda meetodit kasutada HTML-veebiressursiga (new_myWebResource.htm).

Esmalt lisage HTML-veebiressurssi järgmine kood:

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

Järgmiseks lisage vormiLeLoad sündmuseohjuri järgmine kood:

// 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();
            }
        )
    }
}

Sarnane lähtestamiskood tuleks lisada TabStateChange sündmuseohjurile, kui selline lähtestamine on vajalik. Kui lähtestamiskoodi uuesti kasutatakse, peaks see olema idempotentne. Jõudluse huvides võib vorm juhtelemendi tabeldusklahvi (Tab) navigeerimise ajal hävitada ja uuesti lähtestada.