Ściągawki dzielą się na kategorie, które odzwierciedlają zwykle określony zakres problemów. Przykładowo wtyczka związana z językiem Java może definiować kategorię "Java", która jest odpowiednia dla ściągawek pomocnych podczas korzystania z narzędzi Java. Do kategorii zdefiniowanych przez jedną wtyczkę mogą odwoływać się inne wtyczki za pomocą atrybutu kategorii elementu ściągawki. Ściągawki, które nie są przypisane do żadnej kategorii, a także ściągawki z niepoprawnymi ścieżkami kategorii są umieszczane w kategorii "Inne".
Ściągawki mogą opcjonalnie określać podelement opisu, którego treść powinna zawierać zwięzły tekst z opisem danej ściągawki.
<!ELEMENT extension (category | cheatsheet | taskEditor | taskExplorer)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
Element kategorii w punkcie rozszerzenia cheatsheetContent powoduje utworzenie nowej kategorii w menu ściągawki. Menu ściągawki jest dostępne w menu pomocy środowiska roboczego. W razie podania nowej kategorii można skierować do niej ściągawki - będą one wtedy wyświetlane w tej kategorii w oknie dialogowym wyboru ściągawki.
<!ELEMENT cheatsheet (description?)>
<!ATTLIST cheatsheet
id CDATA #REQUIRED
name CDATA #REQUIRED
category CDATA #IMPLIED
contentFile CDATA #IMPLIED
listener CDATA #IMPLIED
composite (true | false) "false">
Element ściągawki jest umieszczany w punkcie rozszerzenia cheatsheetContent, jeśli istnieje ściągawka, którą można dodać do środowiska roboczego. Element ten musi określać identyfikator, możliwą do przetłumaczenia nazwę wyświetlaną w ramach opcji wyboru, identyfikator kategorii określający kategorię, do której ma być dołączona dana ściągawka, oraz plik treści. Plik treści ściągawki to plik XML, który opisuje kroki i akcje zawarte w ściągawce.
org.eclipse.ui.cheatsheets.CheatSheetListener
.<!ELEMENT description (#PCDATA)>
Krótki opis ściągawki.
<!ELEMENT taskEditor EMPTY>
<!ATTLIST taskEditor
id CDATA #REQUIRED
class CDATA #REQUIRED
icon CDATA #REQUIRED>
Ten punkt rozszerzenia ma charakter tymczasowy, ponieważ działa w oparciu o tymczasową klasę interfejsu API pod nazwą TaskEditor
.
Punkt rozszerzenia taskEditor
umożliwia wyświetlanie niestandardowego interfejsu użytkownika w panelu edytora ściągawki złożonej. Klasa zdefiniowana w tym punkcie rozszerzenia jest wykorzystywana w ramach każdej czynności w ściągawce złożonej, której rodzaj odpowiada identyfikatorowi tego rozszerzenia, do tworzenia obszaru edytora.
<!ELEMENT taskExplorer EMPTY>
<!ATTLIST taskExplorer
id CDATA #REQUIRED
class CDATA #IMPLIED
icon CDATA #IMPLIED
name CDATA #REQUIRED>
Ten punkt rozszerzenia ma charakter tymczasowy, ponieważ działa w oparciu o tymczasową klasę interfejsu API pod nazwą TaskExplorer
.
Umożliwia on wniesienie edytora czynności wykorzystywanego podczas otwierania ściągawki złożonej.
explorerId
ściągawki złożonej odpowiada temu identyfikatorowi, eksplorator jest wyświetlany w obszarze eksploratora czynności tej ściągawki.ITaskExplorer
. Klasa ta musi umożliwiać wyświetlanie czynności w ściągawce złożonej, a także musi umożliwiać użytkownikowi wybieranie czynności, które mają być wyświetlane w edytorze.
<extension point=
"org.eclipse.ui.cheatsheets.cheatSheetContent"
>
<category name=
"Przykładowa kategoria"
id=
"com.example.category"
>
</category>
<cheatsheet name=
"Przykładowa ściągawka"
category=
"com.example.category"
id=
"com.example.cheatSheet"
contentFile=
"ExampleCheatSheet.xml"
>
<description>
To jest opis mojej ściągawki.</description>
</cheatsheet>
</extension>
Copyright (c) 2004, 2006 IBM Corporation i inne podmioty.
Wszelkie prawa zastrzeżone. Program ten oraz towarzyszące mu materiały są udostępniane na warunkach licencji EPL (Eclipse Public License), wersja 1.0, dołączonej do nich i dostępnej pod adresem http://www.eclipse.org/legal/epl-v10.html.