Wnoszenie części HelloWorld - wprowadzenie

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("WITAMY W ŚRODOWISKU 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.