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

Επιστρέφει μια αναφορά στη φόρμα ή σε ένα στοιχείο στη φόρμα, ανάλογα με το σημείο όπου κλήθηκε η μέθοδος.

Σύνταξη

ExecutionContextObj.getFormContext()

Επιστρεφόμενη αξία

Τύπος: Αντικείμενο

Περιγραφή: Επιστρέφει μια αναφορά στη φόρμα ή σε ένα στοιχείο στη φόρμα, όπως πλέγμα με δυνατότητα επεξεργασίας, ανάλογα με το σημείο όπου κλήθηκε η μέθοδος. Αυτή η μέθοδος σάς επιτρέπει να δημιουργείτε συνήθεις χειρισμούς συμβάντων που μπορούν να λειτουργήσουν είτε σε μια φόρμα είτε σε ένα στοιχείο στη φόρμα, ανάλογα με το σημείο κλήσης της.

Παράδειγμα

Το παρακάτω δείγμα κώδικα παρουσιάζει πώς μπορείτε να δημιουργήσετε μια μέθοδο που ορίζει ειδοποίηση σε μια στήλη φόρμας ή ένα κελί πλέγματος με δυνατότητα επεξεργασίας, ανάλογα με το σημείο όπου καταχωρίσατε τη δέσμη ενεργειών (συμβάν Column OnChange ή συμβάν OnChange με δυνατότητα επεξεργασίας πλέγματος):

function commonEventHandler(executionContext) {
    var formContext = executionContext.getFormContext();    
    var telephoneAttr = formContext.data.entity.attributes.get('telephone1');
    var isNumberWithCountryCode = telephoneAttr.getValue().substring(0,1) === '+';

    // telephoneField will be a form control if invoked from a form OnChange event;
    // telephoneField will be a editable grid GridCell object if invoked from editable grid OnChange event.
    var telephoneField = telephoneAttr.controls.get(0);

    if (!isNumberWithCountryCode) {
        telephoneField.setNotification('Please include the country code beginning with '+'.', 'countryCodeNotification');
    }
    else {
        telephoneField.clearNotification('countryCodeNotification');
    }
}

Σχετικά άρθρα

Περιβάλλον εκτέλεσης
Περιβάλλον φόρμας