getContentWindow (ügyfél API-referencia)

Egy IFRAME-t vagy webes erőforrást képviselő tartalomablakot ad vissza.

Megjegyzés:

Ez a módszer csak az egyesített felületen támogatott.

Támogatott vezérlőtípusok

iframe, webes erőforrás

Szemantika

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

Paraméterek

Név	Típus	Kötelező	Description
successCallback	Funkció	Nem	A művelet sikeres végrehajtásakor meghívandó függvény. A függvény egy tartalomablak-példányt ad át a függvénynek, amely az IFRAME-t vagy a webes erőforrást jelöli.
errorCallback	Funkció	Nem	A művelet sikertelensége esetén meghívandó függvény.

Visszaadott érték

Siker esetén egy ígéretet ad vissza, amely egy IFRAME-et vagy webes erőforrást képviselő tartalomablak-példányt tartalmaz.

Example

Az alábbi példa bemutatja, hogyan használható ez a módszer egy HTML-alapú webes erőforrással (new_myWebResource.htm).

Először adja hozzá a következő kódot a HTML-weberőforráshoz:

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

Ezután adja hozzá a következő kódot az OnLoad eseménykezelő űrlaphoz:

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

Hasonló inicializálási kódot kell hozzáadni egy TabStateChange eseménykezelőhöz , ha ilyen inicializálásra van szükség. Az inicializálási kódnak idempotensnek kell lennie, ha újra felhasználják. Teljesítménybeli okokból előfordulhat, hogy az űrlap elpusztítja és újrainicializálja a vezérlőt a tabulátorral való navigálás során.