getContentWindow (référence de l’API client)

Article
12/31/2024

Retourne la fenêtre de contenu qui représente ou une ressource Web ou un IFRAME.

Note

Cette méthode est uniquement prise en charge sur Unified Interface.

Types de contrôles pris en charge

iframe, ressource web

Syntaxe

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

Paramètres

Nom	Type	Requise	Description
`successCallback`	Function	Non	Fonction à appeler lorsque l’opération est effectuée avec succès. Une instance de fenêtre de contenu représentant l’IFRAME ou la ressource Web est transmise à la fonction.
`errorCallback`	Function	Non	Fonction à appeler lorsque l’opération échoue.

Valeur renvoyée

En cas de succès, renvoie un promise contenant une instance de fenêtre de contenu représentant un IFRAME ou une ressource Web.

Exemple

L’exemple suivant montre comment utiliser cette méthode avec une ressource Web HTML (new_myWebResource.htm).

Tout d’abord, ajoutez le code suivant à votre ressource Web HTML :

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

Ensuite, ajoutez le code suivant dans le gestionnaire d’événements OnLoad du formulaire :

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

Un code d’initialisation similaire doit être ajouté à un gestionnaire d’événements TabStateChange si une telle initialisation est nécessaire. Tout code d’initialisation doit être idempotent s’il est réutilisé. Pour des raisons de performances, le formulaire peut détruire et réinitialiser le contrôle lors de la navigation dans les onglets.

Partage via