org.eclipse.ui.IWorkingSetUpdater Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of workbench Show documentation

This plug-in contains the bulk of the Workbench implementation, and depends on JFace, SWT, and Core Runtime. It cannot be used independently from org.eclipse.ui. Workbench client plug-ins should not depend directly on this plug-in.

The newest version!

/*******************************************************************************
 * Copyright (c) 2000, 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;

/**
 * An IWorkingSetUpdater can be used to dynamically update
 * the content of a working set. 
 * 
 * A working set updater manages a set of working sets. It is contributed
 * via the attribute updaterClass of the 
 * org.eclipse.ui.workingSets extension point. Extensions of this
 * extension point must therefore implement this interface.
 * 
 * 
 * API under construction and subject to change at any time.
 * 
 * @since 3.1
 */
public interface IWorkingSetUpdater {
	/**
	 * Adds a working set to this updater.
	 * 
	 * @param workingSet the working set to add to this updater
	 */
	public void add(IWorkingSet workingSet);
	
	/**
	 * Removes a working set from this updater.
	 * 
	 * @param workingSet the working set to remove
	 * 
	 * @return true if the updater changed (e.g.
	 *  the element got removed)
	 */
	public boolean remove(IWorkingSet workingSet);
	
	/**
	 * Returns true if the updater contains the
	 * given working set; otherwise false is 
	 * returned.
	 * 
	 * @param workingSet the parameter to check
	 * 
	 * @return whether the updater contains the given working
	 *  set
	 */
	public boolean contains(IWorkingSet workingSet);
	
	/**
	 * Disposes this working set updater. Implementations of this
	 * method typically remove listeners from some delta providers. 
	 */
	public void dispose();
}