getContentWindow (kliento API nuoroda)

Pateikia turinio langą, kuris nurodo IFRAME arba žiniatinklio išteklių.

Pastaba.

Šis metodas palaikomas tik vieningojoje sąsajoje.

Palaikomi valdiklių tipai

iframe, žiniatinklio išteklius

Sintaksė

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

Parametrus

Vardas, pavadinimas	Rūšis	Privalomas	Aprašas
successCallback	Funkcija	Ne	Funkcija, iškviečiama sėkmingai įvykdžius operaciją. Funkcijai perduodamas turinio lango egzempliorius, nurodantis IFRAME arba žiniatinklio išteklių.
errorCallback	Funkcija	Ne	Funkcija, kurią reikia iškviesti, kai operacija nepavyksta.

Grąžinimo reikšmė

Sėkmingai pateikia pažadą, kuriame yra turinio lango egzempliorius, nurodantis IFRAME arba žiniatinklio išteklių.

Pavyzdžiui

Toliau pateiktame pavyzdyje parodyta, kaip galite naudoti šį metodą su HTML žiniatinklio ištekliais (new_myWebResource.htm).

Pirmiausia į html žiniatinklio išteklių įtraukite šį kodą:

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

Tada įtraukite šį kodą į formos OnLoad įvykio apdorojimo programą:

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

Panašų inicijavimo kodą reikia įtraukti į įvykio TabStateChange apdorojimo programą, jei toks inicijavimas yra būtinas. Bet koks inicijavimo kodas turėtų būti idempotent, jei jis naudojamas pakartotinai. Dėl našumo priežasčių forma gali sunaikinti ir iš naujo inicijuoti valdiklį naršant skirtukus.