getContentWindow (odkaz na rozhranie API klienta)

Vráti okno obsahu, ktoré predstavuje iframe alebo webový prostriedok.

Poznámka

Táto metóda je podporovaná len v zjednotenom rozhraní.

Podporované typy ovládacích prvkov

iframe, webový zdroj

Syntax

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

Parametre

Meno	Typ	Požaduje sa	Popis
successCallback	Funkcia	No	Funkcia, ktorá volá po úspešnom vykonaní operácie. Inštancia okna obsahu predstavujúca zdroj IFRAME alebo webový prostriedok sa odovzdá funkcii.
errorCallback	Funkcia	No	Funkcia, ktorá sa volá v prípade zlyhania operácie.

Vrátená hodnota

Po úspešnom dokončení vráti sľub, ktorý obsahuje inštanciu okna obsahu predstavujúcu iframe alebo webový prostriedok.

Príklad

V nasledujúcom príklade je uvedené, ako môžete túto metódu použiť s webovým prostriedkom v jazyku HTML (new_myWebResource.htm).

Najprv do webového zdroja HTML pridajte nasledujúci kód:

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

Do obslužného programu udalostí OnLoad formulára pridajte nasledujúci kód:

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

Ak je takáto inicializácia potrebná, mali by sa pridať podobný kód inicializácie do obslužného programu udalostí TabStateChange . Pri opätovnom použitím inicializačného kódu by mal byť idempotentný. Z dôvodu výkonu môže formulár počas navigácie na karte zničiť a znova iicializovať ovládací prvok.