getContentWindow (Informazioni di riferimento sulle API client)

Restituisce la finestra del contenuto che rappresenta un IFRAME o una risorsa Web.

Annotazioni

Questo metodo è supportato solo nell'interfaccia unificata.

Tipi di controllo supportati

iframe, risorsa Web

Sintassi

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

Parametri

Nome	TIPO	Obbligatorio	Description
successCallback	Funzione	NO	Funzione da chiamare quando l'operazione viene eseguita correttamente. Un'istanza della finestra di contenuto che rappresenta l'IFRAME o la risorsa Web viene passata alla funzione.
errorCallback	Funzione	NO	Funzione da chiamare quando l'operazione ha esito negativo.

Valore restituito

In caso di esito positivo, restituisce una promessa che contiene un'istanza della finestra del contenuto che rappresenta un IFRAME o una risorsa Web.

Example

Nell'esempio seguente viene illustrato come usare questo metodo con una risorsa Web HTML (new_myWebResource.htm).

Aggiungere prima di tutto il codice seguente nella risorsa Web HTML:

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

Aggiungere quindi il codice seguente nel modulo Gestore eventi OnLoad:

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

Se necessario, è necessario aggiungere codice di inizializzazione simile a un gestore eventi TabStateChange . Qualsiasi codice di inizializzazione deve essere idempotente se viene riutilizzato. Per motivi di prestazioni, il modulo potrebbe distruggere e reinizializzare il controllo durante lo spostamento tramite tabulazione.