Příklad: Zápis fragmentu němčiny u modulu plug-in XYZ

Průvodci a editory v prostředí PDE, které mohou manipulovat s moduly plug-in a fragmenty, jsou téměř shodné.  Je však třeba si dávat pozor na některé důležité rozdíly.

Začneme vytvořením nového projektu fragmentu.  

Na první stránce Průvodce novým projektem fragmentu zadejte název projektu "com.ukázka.němčina".  Potvrďte výchozí hodnoty a klepněte na tlačítko Další.

Stránka Obsah fragmentu má na rozdíl od průvodce vytvořením modulu plug-in další tři pole: ID hostitelského modulu plug-in, ID nadřazeného modulu plug-in a Pravidlo porovnávání verzí.

Protože zapisujete fragment pro konkrétní modul plug-in, můžete klepnout na tlačítko Procházet a vybrat položku "com.ukázka.xyz" v dialogovém okně pro výběr modulu plug-in. Pomocí dialogového okna je možné také vybrat libovolný externí modul plug-in.

Příklad fragmentu - Ukázková stránka s obsahem fragmentu

Po vytvoření projektu se otevře editor manifestu fragmentu.

Příklad fragmentu - Přehled manifestu

Na rozdíl od modulu plug-in fragmenty nemají třídu modulu plug-in, protože sledují životní cyklus svého hostitelského modulu plug-in.

Přidáme podobnou akční sadu jako v ukázce modulu plug-in, ale tentokrát v němčině.

  1. Přejděte na stránku Rozšíření v editoru manifestu fragmentu. Klepnutím na tlačítko Přidat spusťte Průvodce rozšířením.
  2. Vyberte položku "org.eclipse.ui.actionSets" ze seznamu bodů rozšíření. Stiskněte Dokončit.
  3. Vyberte nově nastavenou akční sadu. Z rozevírací nabídky vyberte položky Nová->Akční sada.
  4. V části Podrobnosti prvků rozšíření změňte vlastnost štítek na "Deutsche Aktionsmenge".
  5. V části Všechna rozšíření klepněte pravým tlačítkem myši na novou akční sadu a z lokální nabídky vyberte položky Nová->Nabídka.
  6. Změňte vlastnost štítek nabídky na "Beispiel Menu" a vlastnost id na "beispielMenu".
  7. Vyberte znovu prvek nabídky a z rozevírací nabídky vyberte položky Nový->Oddělovač. Změňte jeho název na "beispielGruppe" a uložte jej.
  8. Vytvořte nový prvek "akce" (podobně jako v kroku 6). Nastavte vlastnost štítek na "Beispiel Aktion". Nastavte položku menubarPath na "beispielMenu/beispielGruppe".
  9. Klepněte na hypertextový odkaz vlastnosti třída a vygenerujte novou třídu pro akci. Jako zdrojovou složku použijte složku com.ukázka.němčina/src a název balíčku ponechejte nezadaný (bude použit výchozí balíček). Změňte název třídy na "DeutscheBeispielAktion". Stiskněte Dokončit.
  10. Po otevření editoru jazyka Java s novou třídou vyhledejte metodu "run" a přidejte následující položky:

    System.out.println("Hallo, PDE welt!");

  11. Uložte a zavřete editor jazyka Java a editor manifestu fragmentu.

Při spuštění fragmentu pomocí tlačítka na panelu nástrojů "Spustit" by měla být akční sada "Deutsche Aktionsmenge" přístupná pro instanci běhové platformy.  (Seznam akčních sad zobrazíte klepnutím na položky Okno->Přizpůsobit perspektivu...->Jiné). Po aktivaci akční sady by se měla na panelu nabídek zobrazit nabídka "Beispiel Menu". Po výběru položky nabídky by se v konzole mělo zobrazit "Hallo, PDE welt!". Běhová platforma nezobrazila fragment němčiny přímo. Namísto toho registr modulu plug-in rozlišil reference fragmentu tak, že se akční sada fragmentu zobrazila v platformě jako kdyby pocházela přímo z modulu plug-in XYZ.