getContentWindow (مرجع واجهة برمجة تطبيقات العميل)

إرجاع نافذة المحتوى التي تمثل IFRAME أو مورد ويب.

Note

يتم اعتماد هذا الأسلوب فقط على الواجهة الموحدة.

أنواع عناصر التحكم المدعومة

iframe، مورد ويب

بناء الجملة

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

المعلمات

Name	نوع	مطلوبة	‏‏الوصف
successCallback	الوظيفة	لا	دالة لاستدعاء عند تنفيذ العملية بنجاح. يتم تمرير مثيل نافذة المحتوى الذي يمثل IFRAME أو مورد الويب إلى الدالة .
errorCallback	الوظيفة	لا	وظيفة للاتصال عند فشل العملية.

قيمة الإرجاع

عند النجاح، ترجع وعدا يحتوي على مثيل نافذة محتوى يمثل IFRAME أو مورد ويب.

مثال

يوضح المثال التالي كيف يمكنك استخدام هذا الأسلوب مع مورد ويب 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 event handler:

// 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 إذا كانت هذه التهيئة ضرورية. يجب أن تكون أي تعليمة برمجية للتهيئة مكررة إذا أعيد استخدامها. لأسباب تتعلق بالأداء، قد يقوم النموذج بتدمير عنصر التحكم وإعادة تهيئته أثناء التنقل بين علامات التبويب.