Partilhar via


getContentWindow (referência da API do cliente)

Retorna a janela de conteúdo que representa um IFRAME ou recurso da Web.

Observação

Este método é suportado apenas na Interface Unificada.

Tipos de controlo suportados

iframe, recurso da web

Sintaxe

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

Parâmetros

Nome Tipo Obrigatório Description
successCallback Função Não Uma função para chamar quando a operação é executada com êxito. Uma instância de janela de conteúdo que representa o IFRAME ou recurso da Web é passada para a função.
errorCallback Função Não Uma função para chamar quando a operação falhar.

Valor de retorno

Quando for bem-sucedido, retorna uma promessa que contém uma instância de janela de conteúdo que representa um IFRAME ou recurso da Web.

Example

O exemplo a seguir mostra como você pode usar esse método com um recurso da Web HTML (new_myWebResource.htm).

Primeiro, adicione o seguinte código em seu recurso da Web HTML:

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

Em seguida, adicione o seguinte código no manipulador de eventos 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();
            }
        )
    }
}

Código de inicialização semelhante deve ser adicionado a um manipulador de eventos TabStateChange se essa inicialização for necessária. Qualquer código de inicialização deve ser idempotente se for reutilizado. Por motivos de desempenho, o formulário pode destruir e reinicializar o controle durante a navegação na guia.