Поделиться через


getContentWindow (справочник по API клиента)

Возвращает окно содержимого, представляющее IFRAME или веб-ресурс.

Замечание

Этот метод поддерживается только в едином интерфейсе.

Поддерживаемые типы элементов управления

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

Синтаксис

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

Параметры

Имя Тип Обязательно Description
successCallback Функция нет Функция, вызываемая при успешном выполнении операции. Экземпляр окна содержимого, представляющий IFRAME или веб-ресурс, передается функции.
errorCallback Функция нет Функция, вызываемая при сбое операции.

Возвращаемое значение

При успешном выполнении возвращает обещание, содержащее экземпляр окна содержимого, представляющий IFRAME или веб-ресурс.

Example

В следующем примере показано, как использовать этот метод с веб-ресурсом 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 , если такая инициализация необходима. Любой код инициализации должен быть идемпотентным, если он используется повторно. По соображениям производительности форма может уничтожить и повторно инициализировать элемент управления во время навигации по вкладкам.