bundles/org.eclipse.ui.workbench/Eclipse UI/org/eclipse/ui/model/IWorkbenchAdapter2.java

/*******************************************************************************
 * Copyright (c) 2004, 2005 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.ui.model;

import org.eclipse.swt.graphics.FontData;
import org.eclipse.swt.graphics.RGB;

/**
 * Extension interface for <code>IWorkbenchAdapter</code> that allows for color 
 * and font support.
 * <p>
 * There is an associate label provider and content provider for showing
 * elements with a registered workbench adapter in JFace structured viewers.
 * </p>
 * @see IWorkbenchAdapter
 * @see WorkbenchLabelProvider
 * @see BaseWorkbenchContentProvider
 * @since 3.0
 */
public interface IWorkbenchAdapter2 {

    /**
     * Provides a foreground color for the given element.
     * 
     * @param element the element
     * @return	the foreground color for the element, or <code>null</code> 
     *   to use the default foreground color
     */
    public RGB getForeground(Object element);

    /**
     * Provides a background color for the given element.
     * 
     * @param element the element
     * @return	the background color for the element, or <code>null</code> 
     *   to use the default background color
     */
    public RGB getBackground(Object element);

    /**
     * Provides a font the given element.
     * 
     * @param element the element
     * @return	the font for the element, or <code>null</code> 
     *   to use the default font
     */
    public FontData getFont(Object element);

}