Strony właściwości

org.eclipse.ui.propertyPages

Ten punkt rozszerzenia umożliwia dodawanie stron właściwości związanych z obiektami danego typu. Zdefiniowane strony właściwości są wyświetlane w oknie dialogowym właściwości dotyczącym obiektów tego typu.

Strona właściwości to przyjazny dla użytkownika sposób interakcji z właściwościami wybranego obiektu. W odróżnieniu od widoku Właściwości, w którym dostępny obszar edycji właściwości obiektu jest ograniczony, na stronie właściwości można swobodnie definiować większe, bardziej złożone pola sterujące z etykietami, ikonami itp. Ponadto właściwości logicznie ze sobą powiązane mogą być zgrupowane na jednej stronie, a nie porozrzucane po całym arkuszu właściwości. Jednak w większości aplikacji bardziej odpowiednie będzie wyświetlanie niektórych właściwości obiektu na arkuszu właściwości, a innych właściwości - na stronach właściwości.

Strony właściwości są widoczne w oknie dialogowym, które jest zwykle wyświetlane po wybraniu opcji Właściwości z menu podręcznego obiektu. Poza klasą obiektu można opcjonalnie podać filtr nazwy, który umożliwi rejestrowanie stron właściwości tylko dla określonych typów obiektów.

Jeśli te mechanizmy filtrowania nie są wystarczające, na stronie właściwości można użyć elementu filter. W takim przypadku atrybuty obiektu docelowego są opisane zbiorem par klucz/wartość. Atrybuty dające się zastosować do wyboru zależą od typu i wykraczają poza domenę środowiska roboczego, dlatego filtrowanie na tym poziomie jest delegowane ze środowiska roboczego do faktycznego wyboru.

<!ELEMENT extension (page*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT page (filter* , keywordReference*)>

<!ATTLIST page

id          CDATA #REQUIRED

name        CDATA #REQUIRED

icon        CDATA #IMPLIED

objectClass CDATA #REQUIRED

class       CDATA #REQUIRED

nameFilter  CDATA #IMPLIED

adaptable   (true | false)

category    CDATA #IMPLIED>


<!ELEMENT filter EMPTY>

<!ATTLIST filter

name  CDATA #REQUIRED

value CDATA #REQUIRED>

Ten element służy do wartościowania stanu atrybutu każdego obiektu w bieżącym wyborze. Zgodność występuje tylko w przypadku, gdy każdy obiekt w wyborze ma określony stan atrybutu. Każdy obiekt w wyborze musi implementować interfejs org.eclipse.ui.IActionFilter lub przystosowywać się do niego.



<!ELEMENT keywordReference EMPTY>

<!ATTLIST keywordReference

id CDATA #IMPLIED>

Odwołanie strony właściwości do słowa kluczowego. Patrz opis punktu rozszerzenia słów kluczowych.



Poniżej przedstawiono przykład definicji strony właściwości:

   

<extension point=

"org.eclipse.ui.propertyPages"

>

<page id=

"com.xyz.projectPage"

name=

"Właściwości Java XYZ"

objectClass=

"org.eclipse.core.resources.IFile"

class=

"com.xyz.ppages.JavaPropertyPage"

nameFilter=

"*.java"

>

<filter name=

"readOnly"

value=

"true"

/>

</page>

</extension>

Atrybut class musi określać pełną nazwę klasy implementującej interfejs org.eclipse.ui.IWorkbenchPropertyPage.

W przypadku niektórych obiektów dostępnych w środowisku roboczym mogą już istnieć zarejestrowane strony właściwości. Moduły dodatkowe mogą dodawać kolejne strony właściwości dla tych obiektów. Strony właściwości nie są ograniczone tylko do zasobów środowiska roboczego. Wszystkie obiekty wyświetlane w środowisku roboczym (nawet obiekty specyficzne dla domeny, które są tworzone przez moduły dodatkowe) mogą mieć strony właściwości, a inne moduły dodatkowe mogą rejestrować nowe strony właściwości tych obiektów.