| /******************************************************************************* |
| * Copyright (c) 2000, 2006 IBM Corporation and others. |
| * All rights reserved. This program and the accompanying materials |
| * are made available under the terms of the Eclipse Public License v1.0 |
| * which accompanies this distribution, and is available at |
| * http://www.eclipse.org/legal/epl-v10.html |
| * |
| * Contributors: |
| * IBM Corporation - initial API and implementation |
| *******************************************************************************/ |
| package org.eclipse.ecf.internal.ui.wizards; |
| |
| import org.eclipse.core.runtime.Assert; |
| import org.eclipse.core.runtime.IAdaptable; |
| import org.eclipse.core.runtime.Platform; |
| import org.eclipse.core.runtime.PlatformObject; |
| import org.eclipse.jface.resource.ImageDescriptor; |
| import org.eclipse.jface.viewers.DecoratingLabelProvider; |
| import org.eclipse.jface.viewers.IColorProvider; |
| import org.eclipse.jface.viewers.IFontProvider; |
| import org.eclipse.jface.viewers.ILabelProvider; |
| import org.eclipse.jface.viewers.LabelProvider; |
| import org.eclipse.jface.viewers.LabelProviderChangedEvent; |
| import org.eclipse.swt.graphics.Color; |
| import org.eclipse.swt.graphics.Font; |
| import org.eclipse.swt.graphics.FontData; |
| import org.eclipse.swt.graphics.Image; |
| import org.eclipse.swt.graphics.RGB; |
| import org.eclipse.swt.widgets.Display; |
| import org.eclipse.ui.IEditorRegistry; |
| import org.eclipse.ui.IPropertyListener; |
| import org.eclipse.ui.PlatformUI; |
| import org.eclipse.ui.model.IWorkbenchAdapter; |
| import org.eclipse.ui.model.IWorkbenchAdapter2; |
| |
| /** |
| * Provides basic labels for adaptable objects that have the |
| * <code>IWorkbenchAdapter</code> adapter associated with them. All dispensed |
| * images are cached until the label provider is explicitly rootDisposed. This |
| * class provides a facility for subclasses to define annotations on the labels |
| * and icons of adaptable objects. |
| */ |
| public class WorkbenchLabelProvider extends LabelProvider implements |
| IColorProvider, IFontProvider { |
| |
| /** |
| * Returns a workbench label provider that is hooked up to the decorator |
| * mechanism. |
| * |
| * @return a new <code>DecoratingLabelProvider</code> which wraps a <code> |
| * new <code>WorkbenchLabelProvider</code> |
| */ |
| public static ILabelProvider getDecoratingWorkbenchLabelProvider() { |
| return new DecoratingLabelProvider(new WorkbenchLabelProvider(), |
| PlatformUI.getWorkbench().getDecoratorManager() |
| .getLabelDecorator()); |
| } |
| |
| /** |
| * Listener that tracks changes to the editor registry and does a full |
| * update when it changes, since many workbench adapters derive their icon |
| * from the file associations in the registry. |
| */ |
| private IPropertyListener editorRegistryListener = new IPropertyListener() { |
| public void propertyChanged(Object source, int propId) { |
| if (propId == IEditorRegistry.PROP_CONTENTS) { |
| fireLabelProviderChanged(new LabelProviderChangedEvent( |
| WorkbenchLabelProvider.this)); |
| } |
| } |
| }; |
| |
| /** |
| * Creates a new workbench label provider. |
| */ |
| public WorkbenchLabelProvider() { |
| PlatformUI.getWorkbench().getEditorRegistry().addPropertyListener( |
| editorRegistryListener); |
| } |
| |
| /** |
| * 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. |
| * |
| * @param input |
| * The base image to decorate. |
| * @param element |
| * The element used to look up decorations. |
| * @return the resuling ImageDescriptor. |
| * @see org.eclipse.jface.resource.CompositeImageDescriptor |
| */ |
| protected ImageDescriptor decorateImage(ImageDescriptor input, |
| Object element) { |
| return input; |
| } |
| |
| /** |
| * 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. |
| * |
| * @param input |
| * The base text to decorate. |
| * @param element |
| * The element used to look up decorations. |
| * @return the resulting text |
| */ |
| protected String decorateText(String input, Object element) { |
| return input; |
| } |
| |
| /* |
| * (non-Javadoc) Method declared on ILabelProvider |
| */ |
| public void dispose() { |
| PlatformUI.getWorkbench().getEditorRegistry().removePropertyListener( |
| editorRegistryListener); |
| super.dispose(); |
| } |
| |
| protected static final Object getAdapterUtil(Object sourceObject, |
| Class adapterType) { |
| Assert.isNotNull(adapterType); |
| if (sourceObject == null) |
| return null; |
| if (adapterType.isInstance(sourceObject)) |
| return sourceObject; |
| |
| if (sourceObject instanceof IAdaptable) { |
| IAdaptable adaptable = (IAdaptable) sourceObject; |
| |
| Object result = adaptable.getAdapter(adapterType); |
| if (result != null) { |
| // Sanity-check |
| Assert.isTrue(adapterType.isInstance(result)); |
| return result; |
| } |
| } |
| |
| if (!(sourceObject instanceof PlatformObject)) { |
| Object result = Platform.getAdapterManager().getAdapter( |
| sourceObject, adapterType); |
| if (result != null) |
| return result; |
| } |
| return null; |
| } |
| |
| /** |
| * Returns the implementation of IWorkbenchAdapter for the given object. |
| * |
| * @param o |
| * the object to look up. |
| * @return IWorkbenchAdapter or<code>null</code> if the adapter is not |
| * defined or the object is not adaptable. |
| */ |
| protected final IWorkbenchAdapter getAdapter(Object o) { |
| return (IWorkbenchAdapter) getAdapterUtil(o, IWorkbenchAdapter.class); |
| } |
| |
| /** |
| * Returns the implementation of IWorkbenchAdapter2 for the given object. |
| * |
| * @param o |
| * the object to look up. |
| * @return IWorkbenchAdapter2 or<code>null</code> if the adapter is not |
| * defined or the object is not adaptable. |
| */ |
| protected final IWorkbenchAdapter2 getAdapter2(Object o) { |
| return (IWorkbenchAdapter2) getAdapterUtil(o, IWorkbenchAdapter2.class); |
| } |
| |
| /* |
| * (non-Javadoc) Method declared on ILabelProvider |
| */ |
| public final Image getImage(Object element) { |
| // obtain the base image by querying the element |
| IWorkbenchAdapter adapter = getAdapter(element); |
| if (adapter == null) |
| return null; |
| ImageDescriptor descriptor = adapter.getImageDescriptor(element); |
| if (descriptor == null) |
| return null; |
| |
| // add any annotations to the image descriptor |
| descriptor = decorateImage(descriptor, element); |
| /* |
| * Image image = (Image) |
| * SWTResourceUtil.getImageTable().get(descriptor); if (image == null) { |
| * image = descriptor.createImage(); |
| * SWTResourceUtil.getImageTable().put(descriptor, image); } |
| */ |
| Image image = descriptor.createImage(); |
| return image; |
| } |
| |
| /* |
| * (non-Javadoc) Method declared on ILabelProvider |
| */ |
| public final String getText(Object element) { |
| // query the element for its label |
| IWorkbenchAdapter adapter = getAdapter(element); |
| if (adapter == null) |
| return ""; //$NON-NLS-1$ |
| String label = adapter.getLabel(element); |
| |
| // return the decorated label |
| return decorateText(label, element); |
| } |
| |
| /* |
| * (non-Javadoc) |
| * |
| * @see org.eclipse.jface.viewers.IColorProvider#getForeground(java.lang.Object) |
| */ |
| public Color getForeground(Object element) { |
| return getColor(element, true); |
| } |
| |
| /* |
| * (non-Javadoc) |
| * |
| * @see org.eclipse.jface.viewers.IColorProvider#getBackground(java.lang.Object) |
| */ |
| public Color getBackground(Object element) { |
| return getColor(element, false); |
| } |
| |
| /* |
| * (non-Javadoc) |
| * |
| * @see org.eclipse.jface.viewers.IFontProvider#getFont(java.lang.Object) |
| */ |
| public Font getFont(Object element) { |
| IWorkbenchAdapter2 adapter = getAdapter2(element); |
| if (adapter == null) |
| return null; |
| |
| FontData descriptor = adapter.getFont(element); |
| if (descriptor == null) |
| return null; |
| /* |
| * Font font = (Font) SWTResourceUtil.getFontTable().get(descriptor); if |
| * (font == null) { font = new Font(Display.getCurrent(), descriptor); |
| * SWTResourceUtil.getFontTable().put(descriptor, font); } |
| */ |
| Font font = new Font(Display.getCurrent(), descriptor); |
| return font; |
| } |
| |
| private Color getColor(Object element, boolean forground) { |
| IWorkbenchAdapter2 adapter = getAdapter2(element); |
| if (adapter == null) |
| return null; |
| RGB descriptor = forground ? adapter.getForeground(element) : adapter |
| .getBackground(element); |
| if (descriptor == null) |
| return null; |
| /* |
| * Color color = (Color) |
| * SWTResourceUtil.getColorTable().get(descriptor); if (color == null) { |
| * color = new Color(Display.getCurrent(), descriptor); |
| * SWTResourceUtil.getColorTable().put(descriptor, color); } |
| */ |
| Color color = new Color(Display.getCurrent(), descriptor); |
| return color; |
| } |
| } |