getContentWindow (Client-API-Referenz)

Artikel
12/31/2024

Gibt das Inhaltsfenster zurück, das ein IFRAME oder eine Webressource darstellt.

Anmerkung

Diese Methode wird nur für die einheitliche Oberfläche unterstützt.

Unterstützte Steuerelementtypen

iframe, Webressource

Syntax

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

Parameter

Name	Type	Erforderlich	Beschreibung
`successCallback`	Function	Nein	Eine Funktion zum Aufrufen, wenn der Vorgang erfolgreich ausgeführt wird. Eine Inhaltsfensterinstanz, die den IFRAME oder die Webressource darstellt, wird an die Funktion übergeben.
`errorCallback`	Function	Nein	Eine Funktion zum Aufrufen, wenn der Vorgang fehlschlug.

Rückgabewert

Gibt bei Erfolg ein Versprechen zurück, die eine Inhaltsfensterinstanz enthält, die einen IFRAME oder eine Webressource darstellt.

Beispiel

Das folgende Beispiel zeigt, wie Sie diese Methode mit einer HTML-Webressource (new_myWebResource.htm) verwenden können.

Fügen Sie zunächst den folgenden Code in Ihre HTML-Webressource ein:

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

Fügen Sie als nächstes den folgenden Code in den OnLoad-Eventhandler des Formulars ein:

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

Einem TabStateChange-Ereignishandler sollte ein ähnlicher Initialisierungscode hinzugefügt werden, wenn eine solche Initialisierung erforderlich ist. Jeglicher Initialisierungscode sollte idempotent sein, wenn er wiederverwendet wird. Aus Performance-Gründen kann das Formular das Steuerelement bei Tabulator-Navigationen möglicherweise zerstören und neu initialisieren.

Freigeben über