Παράδειγμα - Βοήθεια πεδίου

Εισαγωγή

Το παράδειγμα "Βοήθεια πεδίου" δείχνει πώς μπορείτε να χρησιμοποιήσετε την υποστήριξη που παρέχεται στο org.eclipse.jface.fieldassist έτσι ώστε να παρέχετε βοήθεια εργασίας σε πεδία κειμένου. Ένα παράθυρο διαλόγου παραδείγματος δείχνει πώς να ρυθμίσετε διακριτικά πεδίου για να δηλώσετε τα απαιτούμενα πεδία, τα πεδία με σφάλματα και προειδοποιήσεις, καθώς και τα πεδία που παρέχουν βοήθεια περιεχομένου. Το παράδειγμα περιλαμβάνει επίσης μια σελίδα προτιμήσεων που σας επιτρέπει να ρυθμίσετε τα διακριτικά και την υποστήριξη της βοήθειας περιεχομένου.

Εκτέλεση του παραδείγματος

Όταν η πρόσθετη λειτουργία έχει εγκατασταθεί, θα πρέπει να μπορείτε να δείτε μια ενέργεια FieldAssist στη γραμμή ενεργειών. Επιλέξτε το στοιχείο μενού "Άνοιγμα πλαισίου διαλόγου βοήθειας πεδίου..." Με τον τρόπο αυτό, εκκινείται το πλαίσιο διαλόγου βοήθειας πεδίου. Οι ρυθμίσεις του πλαισίου διαλόγου μπορούν να λάβουν χώρα μέσω της χρήσης των προτιμήσεων παραδείγματος.

Ρύθμιση των προτιμήσεων της βοήθειας πεδίου

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

Η σελίδα Προτιμήσεις αυτόματη συμπλήρωση περιεχομένου σας επιτρέπει να ρυθμίσετε τον τρόπο με τον οποίο εγκαθίσταται η αυτόματη συμπλήρωση περιεχομένου στο πεδίο κειμένου του πλαισίου διαλόγου. Οι περισσότερες από τις επιλογές που παρέχονται στο ΑΡΙ (ContentProposalAdapter) έχουν τη δυνατότητα ρύθμισης σε αυτή τη σελίδα. Σημειώστε ότι οι ρυθμίσεις της αυτόματης συμπλήρωσης περιεχομένου μπορεί να επιφέρουν αποτελέσματα που δεν είναι πάντα ευχάριστα στο χρήστη. Για παράδειγμα, η ρύθμιση της αυτόματης συμπλήρωσης περιεχομένου έτσι ώστε να ενεργοποιείται αυτόματα σε όλους τους χαρακτήρες χρησιμοποιώντας μεγάλη καθυστέρηση δεν είναι επιθυμητή. Η χρήση αθροιστικού φιλτραρίσματος προτάσεων όταν τα κλειδιά φιλτραρίσματος δεν μεταδίδονται και στο στοιχείο ελέγχου μπορεί να προκαλέσει σύγχυση. Ο σκοπός της έκθεσης του API στη σελίδα προτιμήσεων αποσκοπεί στο να επιτραπεί στον προγραμματιστή της βοήθειας πεδίου να πειραματιστεί με όλους τους πιθανούς συνδυασμούς. Δεν αναμένεται η έκθεση καμίας από τις προτιμήσεις αυτές στους τελικούς χρήστες, αλλά η χρήση τους από τους προγραμματιστές και η από μέρους τους επιλογή του καλύτερου συνδυασμού αυτών των τιμών για ένα ορισμένο στυλ αυτόματης συμπλήρωσης περιεχομένου.

Χρήση του πλαισίου διαλόγου

Το πλαίσιο διαλόγου παραδείγματος δείχνει διάφορα είδη πεδίων:

Πρωτογενής κώδικας παραδείγματος

Το πλαίσιο διαλόγου παραδείγματος δεν είναι ιδιαίτερα σύνθετο, δεν προορίζεται όμως για να δώσει παραδείγματα προγραμματισμού της βοήθειας πεδίου. Ακολουθούν ορισμένες σημειώσεις που αφορούν τον πρωτογενή κώδικα: