getContentWindow (חומר עזר עבור API של לקוח)

מחזירה את חלון התוכן המייצג IFRAME או משאב אינטרנט.

הערה

שיטה זו נתמכת בממשק מאוחד בלבד.

סוגי פקדים נתמכים

iframe, משאב אינטרנט

תחביר

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

פרמטרים

שם	סוג	נדרש	תיאור
successCallback	Function	לא	פונקציה להתקשרות כאשר הפעולה מבוצעת בהצלחה. מופע חלון תוכן המייצג את IFRAME או משאב האינטרנט מועבר לפונקציה.
errorCallback	Function	לא	פונקציה שיש לקרוא לה כאשר הפעולה נכשלת.

ערך החזרה

בעת הצלחה, החזרת הבטחה המכילה מופע של חלון תוכן המייצג 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:

// 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 אם נעשה בו שימוש חוזר. מסיבות של ביצועים, הטופס עשוי להרוס את הפקד ולאתחל אותו מחדש במהלך ניווט בכרטיסיות.