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