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

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

Types de contrôles pris en charge

iframe, ressource web

Syntaxe

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

Paramètres

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.
// No usage of Xrm or formContext should happen until this method is called.
function setClientApiContext(xrm, formContext) {
    // Optionally set Xrm and formContext as global variables on the page.
    window.Xrm = xrm;
    window._formContext = formContext;
     
    // Add script logic here that uses xrm or the formContext.
}

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.setClientApiContext(Xrm, formContext);
            }
        )
    }
}

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 entre les onglets.