Package org.eclipse.ui.model
Class WorkbenchLabelProvider
java.lang.Object
org.eclipse.core.commands.common.EventManager
org.eclipse.jface.viewers.BaseLabelProvider
org.eclipse.jface.viewers.LabelProvider
org.eclipse.ui.model.WorkbenchLabelProvider
- All Implemented Interfaces:
DelegatingStyledCellLabelProvider.IStyledLabelProvider
,IBaseLabelProvider
,IColorProvider
,IFontProvider
,ILabelProvider
public class WorkbenchLabelProvider
extends LabelProvider
implements IColorProvider, IFontProvider, DelegatingStyledCellLabelProvider.IStyledLabelProvider
Provides basic labels for adaptable objects that have the
IWorkbenchAdapter
adapter associated with them. All dispensed
images are cached until the label provider is explicitly disposed. This class
provides a facility for subclasses to define annotations on the labels and
icons of adaptable objects.-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionprotected ImageDescriptor
decorateImage
(ImageDescriptor input, Object element) Returns an image descriptor that is based on the given descriptor, but decorated with additional information relating to the state of the provided object.protected String
decorateText
(String input, Object element) Returns a label that is based on the given label, but decorated with additional information relating to the state of the provided object.void
dispose()
TheBaseLabelProvider
implementation of thisIBaseLabelProvider
method clears its internal listener list.protected final IWorkbenchAdapter
getAdapter
(Object o) Returns the implementation of IWorkbenchAdapter for the given object.protected final IWorkbenchAdapter2
Returns the implementation of IWorkbenchAdapter2 for the given object.protected final IWorkbenchAdapter3
Returns the implementation of IWorkbenchAdapter3 for the given object.getBackground
(Object element) Provides a background color for the given element.static ILabelProvider
Returns a workbench label provider that is hooked up to the decorator mechanism.protected StyledString.Styler
getDecorationStyle
(Object element) Sets theStyledString.Styler
to be used for string decorations.Provides a font for the given element.getForeground
(Object element) Provides a foreground color for the given element.final Image
TheLabelProvider
implementation of thisILabelProvider
method returnsnull
.getStyledText
(Object element) The default implementation of this returns the styled text label for the given element.final String
TheLabelProvider
implementation of thisILabelProvider
method returns the element'stoString
string.Methods inherited from class org.eclipse.jface.viewers.LabelProvider
createImageProvider, createTextImageProvider, createTextProvider
Methods inherited from class org.eclipse.jface.viewers.BaseLabelProvider
addListener, fireLabelProviderChanged, isLabelProperty, removeListener
Methods inherited from class org.eclipse.core.commands.common.EventManager
addListenerObject, clearListeners, getListeners, isListenerAttached, removeListenerObject
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface org.eclipse.jface.viewers.IBaseLabelProvider
addListener, isLabelProperty, removeListener
-
Constructor Details
-
WorkbenchLabelProvider
public WorkbenchLabelProvider()Creates a new workbench label provider.
-
-
Method Details
-
getDecoratingWorkbenchLabelProvider
Returns a workbench label provider that is hooked up to the decorator mechanism.- Returns:
- a new
DecoratingLabelProvider
which wraps a newWorkbenchLabelProvider
-
decorateImage
Returns an image descriptor that is based on the given descriptor, but decorated with additional information relating to the state of the provided object. Subclasses may reimplement this method to decorate an object's image.- Parameters:
input
- The base image to decorate.element
- The element used to look up decorations.- Returns:
- the resuling ImageDescriptor.
- See Also:
-
decorateText
Returns a label that is based on the given label, but decorated with additional information relating to the state of the provided object. Subclasses may implement this method to decorate an object's label.- Parameters:
input
- The base text to decorate.element
- The element used to look up decorations.- Returns:
- the resulting text
-
dispose
public void dispose()Description copied from class:BaseLabelProvider
TheBaseLabelProvider
implementation of thisIBaseLabelProvider
method clears its internal listener list. Subclasses may extend but should call the super implementation.- Specified by:
dispose
in interfaceIBaseLabelProvider
- Overrides:
dispose
in classBaseLabelProvider
-
getAdapter
Returns the implementation of IWorkbenchAdapter for the given object.- Parameters:
o
- the object to look up.- Returns:
- IWorkbenchAdapter or
null
if the adapter is not defined or the object is not adaptable.
-
getAdapter2
Returns the implementation of IWorkbenchAdapter2 for the given object.- Parameters:
o
- the object to look up.- Returns:
- IWorkbenchAdapter2 or
null
if the adapter is not defined or the object is not adaptable.
-
getAdapter3
Returns the implementation of IWorkbenchAdapter3 for the given object.- Parameters:
o
- the object to look up.- Returns:
- IWorkbenchAdapter3 or
null
if the adapter is not defined or the object is not adaptable. - Since:
- 3.7
-
getImage
Description copied from class:LabelProvider
TheLabelProvider
implementation of thisILabelProvider
method returnsnull
. Subclasses may override.- Specified by:
getImage
in interfaceDelegatingStyledCellLabelProvider.IStyledLabelProvider
- Specified by:
getImage
in interfaceILabelProvider
- Overrides:
getImage
in classLabelProvider
- Parameters:
element
- the element for which to provide the label image- Returns:
- the image used to label the element, or
null
if there is no image for the given object
-
getStyledText
The default implementation of this returns the styled text label for the given element.- Specified by:
getStyledText
in interfaceDelegatingStyledCellLabelProvider.IStyledLabelProvider
- Parameters:
element
- the element to evaluate the styled string for- Returns:
- the styled string.
- Since:
- 3.7
-
getDecorationStyle
Sets theStyledString.Styler
to be used for string decorations. By default thedecoration style
. Clients can override.- Parameters:
element
- the element that has been decorated- Returns:
- return the decoration style
- Since:
- 3.7
-
getText
Description copied from class:LabelProvider
TheLabelProvider
implementation of thisILabelProvider
method returns the element'stoString
string. Subclasses may override.- Specified by:
getText
in interfaceILabelProvider
- Overrides:
getText
in classLabelProvider
- Parameters:
element
- the element for which to provide the label text- Returns:
- the text string used to label the element, or
null
if there is no text label for the given object
-
getForeground
Description copied from interface:IColorProvider
Provides a foreground color for the given element.- Specified by:
getForeground
in interfaceIColorProvider
- Parameters:
element
- the element- Returns:
- the foreground color for the element, or
null
to use the default foreground color
-
getBackground
Description copied from interface:IColorProvider
Provides a background color for the given element.- Specified by:
getBackground
in interfaceIColorProvider
- Parameters:
element
- the element- Returns:
- the background color for the element, or
null
to use the default background color
-
getFont
Description copied from interface:IFontProvider
Provides a font for the given element.- Specified by:
getFont
in interfaceIFontProvider
- Parameters:
element
- the element- Returns:
- the font for the element, or
null
to use the default font
-