Aktivitetsstøtte

org.eclipse.help.base.activitySupport

3.1

Dette utvidelsespunktet brukes av produktets plugin-moduler til å konfigurere hjelpefunksjonens virkemåte når det brukes aktiviteter. Det sørger for konfigurering av disse aspektene:

Dette utvidelsespunktet er eksperimentelt, og det blir sannsynligvis endret i fremtidige utgaver etter hvert som aktivitetsstøtten blir utviklet.

<!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)>

En melding i vanlig tekst som blir vist i dialogboksen når aktivitetsfiltrering er slått av. Hensikten med denne meldingen er å advare om at uten filteret kan noen dokumenter referere til brukergrensesnittelementer som ikke er synlige.



<!ELEMENT localScopeCheckbox (#PCDATA)>

En etikett for avmerkingsboksen på preferansesiden for det lokale søkeomfanget. Når avmerkingsboksen er valgt, vil søketreff i dokumenter som tilhører deaktiverte aktiviteter, bli inkludert i søkeresultatene.



<!ELEMENT documentMessage EMPTY>

<!ATTLIST documentMessage

class    CDATA #IMPLIED

pluginId CDATA #REQUIRED>

En HTML-snutt som blir satt inn øverst i hjelpeemnet som tilhører den deaktiverte aktiviteten. Hensikten med meldingen er å varsle brukeren om at emnet kan inneholde referanser til brukergrensesnittelementer som ikke er synlige. Siden meldingsteksten er i en XML-fil, må det brukes Escape-tegn i HTML-kodene som er standard XML-entiteter for spesialtegn.

Meldingen kan inneholde en hyperlink som tar brukeren til det aktivitetsredigeringsprogrammet som sørger for endring av aktivitetens aktiveringstilstand. Attributtet class må brukes i dette tilfellet.



Nedenfor finner du et eksempel på bruken av utvidelsespunktet for aktivitetsstøtte:

 

<extension point=

"org.eclipse.help.base.activitySupport"

>

<support productId=

"com.example.xyzProduct"

>

<showAllMessage>

Disse handlingene vil vise alle emnene i innholdsfortegnelsen.

</showAllMessage>

<documentMessage class=

"com.example.xyz.OpenRolePreference"

>

Dette emnet tilhører rollen som for tiden er deaktivert. &lt;p&gt; Du aktiverer rollen ved å åpne &lt;a href="ACTIVITY_EDITOR"&gt;preferansesiden Rolle.&lt;/a&gt;

</documentMessage>

</support>

</extension>

Attributtet class for elementet documentMessage må implementere grensesnittet org.eclipse.help.ILiveHelpAction.

Eclipse SDK har standard aktivitetsstøtte som bruker betegnelsen 'funksjonalitet' og åpner preferansesiden Funksjonalitet fra hyperlinken i deaktiverte emner. Ved overstyring må du forsikre deg om at endringene og terminologien samsvarer med det som brukes i plattformens brukergrensesnitt.