Wnoszenie powitania jako części wprowadzenia

Wnoszenie prostej części wprowadzenia, opisane poniżej, przedstawia czynności, które należy wykonać, aby wnieść implementację części do środowiska roboczego, która będzie wyświetlana jako strona powitania. Aby to zrobić:

  1. Użyj punktu rozszerzenia org.eclipse.ui.intro, aby zarejestrować implementację części wprowadzenia i powiązać tę część wprowadzenia z produktem.
  2. Zaimplementuj interfejs org.eclipse.ui.intro.IIntroPart i użyj tej klasy jako atrybutu klasy w powyższym elemencie wnoszonym punktu rozszerzenia.
  3. Uruchom produkt oparty na środowisku Eclipse z poprawnym identyfikatorem produktu.

Oto niezbędna rejestracja punktu rozszerzenia org.eclipse.ui.intro:

   <extension point="org.eclipse.ui.intro"> 
      <intro
            class="org.eclipse.ui.intro.HelloWorldIntroPart"
            id="org.eclipse.ui.intro.examples.basic001_introId"
		icon="ikona.jpg"/>
<introProductBinding
            introId="org.eclipse.ui.intro.HelloWorld_introId"
            productId="org.eclipse.ui.intro.HelloWorld_product">
      </introProductBinding>
      </extension>

Część wprowadzenia (intro) jest rejestrowana w środowisku roboczym. Klasą, która implementuje tę część wprowadzenia, jest org.eclipse.ui.intro.HelloWorldIntroPart. W części wprowadzenia jest także rejestrowana ikona, która zostanie wyświetlona w prawym górnym narożniku okna części wprowadzenia. Element wnoszony introProductBinding informuje środowisko robocze, że utworzona część wprowadzenia jest powiązana z produktem o identyfikatorze org.eclipse.ui.intro.HelloWorld_product. Podczas uruchamiania środowisko robocze szuka pierwszego wprowadzenia powiązanego z bieżącym produktem i tworzy instancję klasy zarejestrowanej w tym elemencie wnoszonym wprowadzenia.

Kolejną czynnością jest zaimplementowanie interfejsu org.eclipse.ui.intro.IIntroPart. Poniżej przedstawiono przykładowy kod tworzący etykietę wyśrodkowaną względem nadrzędnego elementu złożonego. Ten kod może zostać użyty do utworzenia klasy IntroPart:

   public void createPartControl(Composite container) {
        Composite outerContainer = new Composite(container, SWT.NONE);
        GridLayout gridLayout = new GridLayout();
        outerContainer.setLayout(gridLayout);
        outerContainer.setBackground(outerContainer.getDisplay().getSystemColor(
             SWT.COLOR_TITLE_BACKGROUND_GRADIENT));
        label = new Label(outerContainer, SWT.CENTER);
        label.setText("WITAJ NA PLATFORMIE ECLIPSE");
        GridData gd = new GridData(GridData.GRAB_HORIZONTAL | GridData.GRAB_VERTICAL);
        gd.horizontalAlignment = GridData.CENTER;
		gd.verticalAlignment = GridData.CENTER;
        label.setLayoutData(gd);
        label.setBackground(outerContainer.getDisplay().getSystemColor(
             SWT.COLOR_TITLE_BACKGROUND_GRADIENT));
   }

Trzecią i ostatnią czynnością jest sprawdzenie, czy uruchamiany jest odpowiedni produkt. W przypadku self-hostingu należy utworzyć nową konfigurację startową wykonawczego środowiska roboczego, wybrać opcję Uruchom produkt, a następnie wybrać z listy rozwijanej pozycję org.eclipse.ui.intro.HelloWorld_product.
Po uruchomieniu powyższego przykładu HelloWorld będzie on wyglądał następująco:

Część wprowadzenia steruje całym obszarem okna. Można utworzyć bardziej złożoną część wprowadzenia współpracującą ze środowiskiem roboczym i stopniowo prezentującą funkcje produktu.