Aktivitetsstøtte

org.eclipse.help.base.activitySupport

3.1

Produkt-plugin bruger dette udvidelsespunkt til at konfigurere hjælpens funktionsmåde, når aktiviteter benyttes. Følgende aspekter kan konfigureres:

Dette udvidelsespunkt er med på forsøgsbasis og vil sandsynligvis blive ændret i fremtidige releases, efterhånden som aktivitetsunderstøttelsen udvikles.

<!ELEMENT extension (support+)>

<!ATTLIST-udvidelse

point CDATA #REQUIRED

id    CDATA #IMPLIED

navn  CDATA #IMPLIED>


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

<!ATTLIST support

productId CDATA #REQUIRED>


<!ELEMENT showAllMessage (#PCDATA)>

en almindelig tekstmeddelelse, der vises i dialogboksen, når aktivitetsfiltret er deaktiveret. Meddelelsen skal advare om, at uden filtret er der mulighed for, at visse dokumenter kan henvise til elementer i brugergrænsefladen, som ikke er synlige.



<!ELEMENT localScopeCheckbox (#PCDATA)>

en etiket for afkrydsningsfeltet på den lokale indstillingsside for søgeomfang. Hvis feltet er afkrydset, inkluderes søgeforekomster i dokumenter, der hører under deaktiverede aktiviteter, i søgeresultaterne.



<!ELEMENT documentMessage EMPTY>

<!ATTLIST documentMessage

class    CDATA #IMPLIED

pluginId CDATA #REQUIRED>

et HTML-stykke, som indsættes øverst i det hjælpeemne, der hører under den deaktiverede aktivitet. Meddelelsen skal underrette brugeren om, at emnet kan indeholde referencer til de brugergrænsefladeelementer, der ikke er synlige. Da meddelelsesteksten findes i en XML-fil, skal der anvendes "escape" på HTML-koder ved brug af XML-standardenheder til specielle tegn.

Meddelelsen kan indeholde et hyperlink, der fører brugeren til den aktivitetseditor, der sørger for ændring af tilstanden for aktivitetsaktivering. Attributten class skal bruges i dette tilfælde.



Det følgende er et eksempel på brug af udvidelsespunktet til aktivitetsunderstøttelse:

 

<udvidelsespunkt=

"org.eclipse.help.base.activitySupport"

>

<support productId=

"com.example.xyzProduct"

>

<showAllMessage>

Denne handling viser alle emner i indholdsfortegnelsen.

</showAllMessage>

<documentMessage class=

"com.example.xyz.OpenRolePreference"

>

Dette emne hører til en rolle, der er deaktiveret i øjeblikket. &lt;p&gt; Du aktiverer rollen ved at åbne &lt;a href="ACTIVITY_EDITOR"&gt;Role Preference Page.&lt;/a&gt;

</documentMessage>

</support>

</extension>

Attributten class for elementet documentMessage skal implementere grænsefladen org.eclipse.help.ILiveHelpAction.

Eclipse SDK leverer den standardaktivitetsunderstøttelse, som benytter termen 'mulighed' (capability) og åbner indstillingssiden Muligheder fra hyperlinket i deaktiverede emner. Når du tilsidesætter, skal du sikre dig, at ændringer og terminologi matcher platformens brugergrænseflade.