getContentWindow (довідник із API клієнта)

Повертає вікно вмісту, яке представляє елемент IFRAME або веб-ресурс.

Нотатка

Цей метод підтримується лише в єдиному інтерфейсі.

Підтримувані типи елементів керування

iframe, веб-ресурс

Синтаксис

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

Параметри

Ім'я	Тип	Необхідний	Опис
successCallback	Function	Ні	Функція, яка викликається під час успішної операції. До функції передається екземпляр вікна вмісту, що позначає IFRAME або веб-ресурс.
errorCallback	Function	Ні	Функція для виклику, коли операція не вдається.

Повернуте значення

Після успішного виконання повертає обіцянку, яка містить екземпляр вікна вмісту, який представляє IFRAME або веб-ресурс.

Приклад

У наведеному нижче прикладі показано, як використовувати цей метод із веб-ресурсом HTML (new_myWebResource.htm).

Спочатку додайте такий код у веб-ресурс HTML:

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

Потім додайте такий код у формі Обробник подій 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();
            }
        )
    }
}

Аналогічний код ініціалізації слід додати до обробника подій TabStateChange , якщо така ініціалізація необхідна. Будь-який код ініціалізації має бути idempotent, якщо він використовується повторно. З міркувань продуктивності форма може знищити та повторно оформити елемент керування під час навігації вкладками.