Sdílet prostřednictvím


getContentWindow (referenční informace k rozhraní API klienta)

Vrátí okno obsahu, které představuje prvek IFRAME nebo webový prostředek.

Podporované typy ovládacích prvků

iframe, webový prostředek

Syntaxe

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

Parametry

Název Typ Povinné Description
successCallback Funkce Ne Funkce, která se má volat při úspěšném spuštění operace. Do funkce se předá instance okna obsahu představující prvek IFRAME nebo webový prostředek.
errorCallback Funkce Ne Funkce, která se má volat v případě selhání operace.

Návratová hodnota

Při úspěchu vrátí příslib, který obsahuje instanci okna obsahu představující prvek IFRAME nebo webový prostředek.

Example

Následující příklad ukazuje, jak můžete tuto metodu použít s webovým prostředkem HTML (new_myWebResource.htm).

Nejprve do webového prostředku HTML přidejte následující kód:

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

Dále přidejte následující kód do formuláře OnLoad obslužné rutiny události:

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

Podobný inicializační kód by měl být přidán do obslužné rutiny události TabStateChange , pokud je taková inicializace nutná. Jakýkoli inicializační kód by měl být idempotentní, pokud je znovu použit. Z důvodů výkonu může formulář zničit a znovu inicializovat ovládací prvek během navigace na kartě.