Υποστήριξη δραστηριοτήτων

org.eclipse.help.base.activitySupport

3.1

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

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

<!ELEMENT extension (support+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT support (localScopeCheckbox , documentMessage , showAllMessage)>

<!ATTLIST support

productId CDATA #REQUIRED>


<!ELEMENT showAllMessage (#PCDATA)>

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



<!ELEMENT localScopeCheckbox (#PCDATA)>

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



<!ELEMENT documentMessage EMPTY>

<!ATTLIST documentMessage

class    CDATA #IMPLIED

pluginId CDATA #REQUIRED>

ένα τμήμα κώδικα HTML που θα εμφανιστεί στην αρχή του θέματος βοήθειας το οποίο ανήκει στην απενεργοποιημένη δραστηριότητα. Σκοπός του μηνύματος είναι να ενημερώσει τον χρήστη ότι το θέμα μπορεί να περιέχει παραπομπές στα στοιχεία του περιβάλλοντος χρήστη τα οποία δεν είναι ορατά. Καθώς το κείμενο του μηνύματος βρίσκεται μέσα σε αρχείο XML, πρέπει να χρησιμοποιηθούν χαρακτήρες διαφυγής στα προσδιοριστικά HTML, με την εφαρμογή τυπικών οντοτήτων XML για ειδικούς χαρακτήρες.

Το μήνυμα μπορεί να περιέχει μια υπερδιασύνδεση για τη μετάβαση του χρήστη στη λειτουργία επεξεργασίας δραστηριοτήτων, η οποία επιτρέπει την πραγματοποίηση αλλαγών στην κατάσταση ενεργοποίησης των δραστηριοτήτων. Στην περίπτωση αυτή πρέπει να χρησιμοποιείται το γνώρισμα class.



Παρακάτω δίνεται ένα παράδειγμα χρήσης του σημείου επέκτασης υποστήριξης δραστηριοτήτων:

 

<extension point=

"org.eclipse.help.base.activitySupport"

>

<support productId=

"com.example.xyzProduct"

>

<showAllMessage>

This actions will reveal all topics in the table of contents.

</showAllMessage>

<documentMessage class=

"com.example.xyz.OpenRolePreference"

>

This topic belongs to the role that is currently disabled. <p> To enable the role, open <a href="ACTIVITY_EDITOR">Role Preference Page.</a>

</documentMessage>

</support>

</extension>

Το γνώρισμα class του στοιχείου documentMessage πρέπει να υλοποιεί τη διεπαφή org.eclipse.help.ILiveHelpAction.

Το Eclipse SDK παρέχει την προεπιλεγμένη υποστήριξη δραστηριοτήτων που χρησιμοποιεί τον όρο "δυνατότητα" και ανοίγει τη σελίδα προτιμήσεων "Δυνατότητες" από την υπερδιασύνδεση με απενεργοποιημένα θέματα. Κατά την αντικατάσταση, βεβαιωθείτε ότι οι αλλαγές και η ορολογία συμφωνούν με αυτές του περιβάλλοντος χρήστη πλατφόρμας.