다음을 통해 공유


getContentWindow(클라이언트 API 참조)

IFRAME 또는 웹 리소스를 나타내는 콘텐츠 창을 반환합니다.

비고

이 메서드는 통합 인터페이스에서만 지원됩니다.

지원되는 컨트롤 형식

iframe, 웹 리소스

Syntax

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 이벤트 처리기에 유사한 초기화 코드를 추가해야 합니다. 다시 사용할 경우 초기화 코드는 idempotent여야 합니다. 성능상의 이유로 폼은 탭 탐색 중에 컨트롤을 삭제하고 다시 초기화할 수 있습니다.