bundles/org.eclipse.ui.workbench/Eclipse UI/org/eclipse/ui/internal/handlers/WorkbenchWindowHandlerDelegate.java

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

import org.eclipse.core.commands.ExecutionEvent;
import org.eclipse.core.commands.ExecutionException;
import org.eclipse.jface.action.IAction;
import org.eclipse.jface.viewers.ISelection;
import org.eclipse.ui.IWorkbenchWindow;

/**
 * A handler that can be used to imitate a IWorkbenchWindowActionDelegate.
 * 
 * @since 3.1
 */
public abstract class WorkbenchWindowHandlerDelegate extends
		ExecutableExtensionHandler implements IWorkbenchWindowHandlerDelegate {

	/**
	 * By default, this will do nothing. Subclasses may override.
	 * 
	 * @param window
	 *            the window that provides the context for this delegate
	 * @see org.eclipse.ui.IWorkbenchWindowActionDelegate#init(IWorkbenchWindow)
	 */
	public void init(final IWorkbenchWindow window) {
		// Do nothing by default.
	}

	/**
	 * This simply calls execute with a <code>null</code> map of parameter
	 * values. If an <code>ExecutionException</code> occurs, then this should
	 * be handle somehow. It's not clear what we'll do yet.
	 * 
	 * @param action
	 *            The action proxy that handles the presentation portion of the
	 *            action
	 * @see org.eclipse.ui.IActionDelegate#run(IAction)
	 */
	public void run(final IAction action) {
		try {
			execute(new ExecutionEvent());
		} catch (final ExecutionException e) {
			// TODO Do something meaningful and poignant.
		}
	}

	/**
	 * By default, this will do nothing. Subclasses may override.
	 * 
	 * @param action
	 *            The action proxy that handles presentation portion of the
	 *            action
	 * @param selection
	 *            The current selection, or <code>null</code> if there is no
	 *            selection.
	 * 
	 * @see org.eclipse.ui.IActionDelegate#selectionChanged(IAction, ISelection)
	 */
	public void selectionChanged(IAction action, ISelection selection) {
		// Do nothing be default.
	}
}