getContentWindow (クライアント API 参照)

IFRAME または Web リソースを示す、コンテンツ ウィンドウを返します。

ヒント

このメソッドは、統一インターフェイスでのみサポートされます。

サポートされているコントロールの種類

iframe、Web リソース

構文

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

Parameters

件名 タイプ Required Description
successCallback Function いいえ オペレーションが正常に実行されたときにコールされる関数。 IFRAME または Web リソースを表すコンテンツ ウィンドウ インスタンスが関数に渡されます。
errorCallback Function いいえ 処理が失敗したときに呼び出す関数。

戻り値

成功時に、IFRAME または Web リソースを表すコンテンツ ウィンドウ インスタンスを含む promise を返します。

例

次の例は、HTML Web リソース (new_myWebResource.htm) でこのメソッドを使用する方法を示します。

まず、HTML Web リソースに次のコードを追加します。

// 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 event ハンドラーに追加する必要があります。 再利用する場合初期化コードは、べき等である必要があります。 パフォーマンス上の理由により、フォームはタブ ナビゲーション中にコントロールを破棄して再初期化する場合があります。

  • 最終更新: