/*******************************************************************************
 * Copyright (c) 2004 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials 
 * are made available under the terms of the Common Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/cpl-v10.html
 * 
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.ui.internal.intro;

import org.eclipse.core.runtime.CoreException;
import org.eclipse.jface.resource.ImageDescriptor;
import org.eclipse.ui.intro.IIntroPart;

/**
 * Describes an introduction extension.
 *  
 * @since 3.0
 */
public interface IIntroDescriptor {
	
	/**
	 * Creates an instance of the intro part defined in the descriptor.
	 */
	IIntroPart createIntro() throws CoreException;		
	
	/**
	 * Returns the part id.
	 *
	 * @return the id of the part
	 */
	public String getId();
	/**
	 * Returns the descriptor of the image for this part.
	 *
	 * @return the descriptor of the image to display next to this part
	 */
	public ImageDescriptor getImageDescriptor();
}