org.eclipse.ui.decorators

Ihr Plug-in kann Dekorationen verwenden, um die Images für Ressourcen und andere Objekte in Workbench-Sichten durch Anmerkungen zu ergänzen.  Dekorationen sind nützlich, wenn das Plug-in Funktionskomponenten für vorhandene Ressourcentypen hinzufügt.  Viele der standardmäßigen Workbench-Sichten unterstützen die Anzeige von Dekorationen.  

PDE ergänzt z. B. Dekorationen, mit denen eine Unterscheidung nach Binär- und Quellenprojekten getroffen werden kann.

Sicht 'Pakete' mit PDE-Dekorationen

Das Projekt com.example.sourceProject  ist das einzige Quellenprojekt, das im Navigator angezeigt wird.  Beachten Sie hierbei, dass alle anderen binären Projekte die binären Dekorationen oben links im Java-Projektsymbol anzeigen.  Diese Dekoration wird durch PDE mit Hilfe des Erweiterungspunktes org.eclipse.ui.decorators ergänzt.

<extension
   point="org.eclipse.ui.decorators">
      <decorator
            objectClass="org.eclipse.core.resources.IResource"
            adaptable="true"
            label="%decorator.label"
            state="false"
            class="org.eclipse.pde.internal.ui.wizards.imports.BinaryProjectDecorator"
            id="org.eclipse.pde.ui.binaryProjectDecorator">
         <description>
            %decorator.desc
         </description>
      </decorator>
</extension>

Das Attribut class sollte eine Klasse benennen, die zur Implementierung von ILabelDecorator dient.  Diese Klasse ermöglicht Ihnen die Dekoration des Images und des Textes der Originalbenennung mit eigenen Anmerkungen.  Die Attribute label und description bestimmen den Text, der zur Benennung und Beschreibung der Dekoration im Benutzervorgabendialog verwendet wird.  In objectClass wird die Klasse der Objekte definiert, auf die die Dekoration angewendet werden soll.  Die Markierung adaptable gibt an, ob Objekte, die an die Klasse angepasst werden, auch mit Dekorationen versehen werden sollen.  Die Markierung state legt fest, ob die Dekoration standardmäßig angezeigt wird.

Dekorationen werden vom Benutzer über die Benutzervorgabenseite Dekorationen für Bezeichnungen der Workbench gesteuert.  Einzelne Dekorationen können ein- und ausgeschaltet werden.  Trotzdem sollte beim Entwurf von Dekorationen darauf geachtet werden, dass diese sich nicht mit Dekorationen der SDK-Plattform überschneiden oder mit diesen in Konflikt stehen.  Wenn Ihre Dekorationen Informationen umfassen, deren Ermittlung kostenintensiv ist oder zu unerwünschten Nebeneffekten führen kann, ist es möglicherweise sinnvoll, eigene Benutzervorgaben zu definieren, mit deren Hilfe der Benutzer aktivierte Dekorationen weiter anpassen kann.  Diese Vorgehensweise wird vom CVS-Client angewendet.

Benutzervorgabenseite für CVS-Dekorationen

 

Copyright IBM Corporation und Andere 2000, 2002. Alle Rechte vorbehalten.