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

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

Notes

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.
// 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.

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).