Compartilhar via


getContentWindow (referência da API do cliente)

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

Observação

Esse método só tem suporte na Interface Unificada.

Tipos de controle com suporte

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 a ser chamada quando a operação é executada com êxito. Uma instância de janela de conteúdo que representa o IFRAME ou o recurso da Web é passada para a função.
errorCallback Função Não Uma função a ser chamada quando a operação falhar.

Valor de retorno

Com êxito, retorna uma promessa que contém uma instância de janela de conteúdo que representa um recurso IFRAME ou 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 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 do formulário:

// 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 de tabulação.