Κοινοποίηση μέσω


getContentWindow (αναφορά API προγράμματος-πελάτη)

Επιστρέφει το παράθυρο περιεχομένου που αντιπροσωπεύει ένα IFRAME ή έναν πόρο web.

Σημείωμα

Αυτή η μέθοδος υποστηρίζεται μόνο στην Ενοποιημένη διασύνδεση.

Υποστηριζόμενοι τύποι στοιχείων ελέγχου

iframe, πόρος web

Σύνταξη

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

Παράμετροι

Όνομα Δακτυλογραφώ Απαραίτητο Περιγραφή
successCallback Function όχι Μια συνάρτηση για κλήση όταν η λειτουργία εκτελεστεί με επιτυχία. Μια παρουσία παραθύρου περιεχομένου που αντιπροσωπεύει το IFRAME ή τον πόρο web μεταβιβάζεται στη συνάρτηση.
errorCallback Function όχι Μια λειτουργία για κλήση όταν αποτύχει η λειτουργία.

Τιμή επιστροφής

Με επιτυχία, επιστρέφει μια υπόσχεση που περιέχει μια παρουσία παραθύρου περιεχομένου που αντιπροσωπεύει ένα IFRAME ή έναν πόρο web.

Παράδειγμα

Το παρακάτω παράδειγμα δείχνει πώς μπορείτε να χρησιμοποιήσετε αυτή τη μέθοδο με έναν πόρο Web HTML (new_myWebResource.htm).

Προσθέστε πρώτα τον παρακάτω κώδικα στον πόρο web 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 εάν αυτή η προετοιμασία είναι απαραίτητη. Οποιοσδήποτε κώδικας αρχικοποίησης θα πρέπει να είναι ταυτοδύναμος εάν επαναχρησιμοποιείται. Για λόγους απόδοσης, η φόρμα μπορεί να καταστρέψει και να επανεκκινήσει το στοιχείο ελέγχου κατά την περιήγηση με καρτέλες.