+++ /dev/null
-/*******************************************************************************
- * Copyright (c) 2002 International Business Machines Corp. and others.
- * All rights reserved. This program and the accompanying materials
- * are made available under the terms of the Common Public License v0.5
- * which accompanies this distribution, and is available at
- * http://www.eclipse.org/legal/cpl-v05.html
- *
- * Contributors:
- * IBM Corporation - initial API and implementation
- ******************************************************************************/
-package net.sourceforge.phpdt.internal.ui.actions;
-
-import org.eclipse.jface.action.Action;
-import org.eclipse.jface.text.ITextSelection;
-import org.eclipse.jface.util.Assert;
-import org.eclipse.jface.viewers.ISelection;
-import org.eclipse.jface.viewers.ISelectionChangedListener;
-import org.eclipse.jface.viewers.ISelectionProvider;
-import org.eclipse.jface.viewers.IStructuredSelection;
-import org.eclipse.jface.viewers.SelectionChangedEvent;
-import org.eclipse.swt.widgets.Shell;
-import org.eclipse.ui.IWorkbenchSite;
-
-/**
- * Action that dispatches the <code>IAction#run()</code> and the
- * <code>ISelectionChangedListener#selectionChanged</code> according to the
- * type of the selection.
- *
- * <ul>
- * <li>if selection is of type <code>ITextSelection</code> then
- * <code>run(ITextSelection)</code> and
- * <code>selectionChanged(ITextSelection)</code> is called.</li>
- * <li>if selection is of type <code>IStructuredSelection</code> then
- * <code>run(IStructuredSelection)</code> and <code>
- * selectionChanged(IStructuredSelection)</code>
- * is called.</li>
- * <li>default is to call <code>run(ISelection)</code> and <code>
- * selectionChanged(ISelection)</code>.</li>
- * </ul>
- *
- * <p>
- * Note: This class is not intended to be subclassed outside the JDT UI plugin.
- * </p>
- *
- * @since 2.0
- */
-public abstract class SelectionDispatchAction extends Action implements
- ISelectionChangedListener {
-
- private IWorkbenchSite fSite;
-
- /**
- * Creates a new action with no text and no image.
- * <p>
- * Configure the action later using the set methods.
- * </p>
- *
- * @param site
- * the site this action is working on
- */
- protected SelectionDispatchAction(IWorkbenchSite site) {
- Assert.isNotNull(site);
- fSite = site;
- }
-
- /**
- * Returns the site owning this action.
- *
- * @return the site owning this action
- */
- public IWorkbenchSite getSite() {
- return fSite;
- }
-
- /**
- * Returns the selection provided by the site owning this action.
- *
- * @return the site's selection
- */
- public ISelection getSelection() {
- return getSelectionProvider().getSelection();
- }
-
- /**
- * Returns the shell provided by the site owning this action.
- *
- * @return the site's shell
- */
- public Shell getShell() {
- return fSite.getShell();
- }
-
- /**
- * Returns the selection provider managed by the site owning this action.
- *
- * @return the site's selection provider
- */
- public ISelectionProvider getSelectionProvider() {
- return fSite.getSelectionProvider();
- }
-
- /**
- * Updates the action's enablement state according to the given selection.
- * This default implementation calls one of the
- * <code>selectionChanged</code> methods depending on the type of the
- * passed selection.
- *
- * @param selection
- * the selection this action is working on
- */
- public void update(ISelection selection) {
- dispatchSelectionChanged(selection);
- }
-
- /**
- * Notifies this action that the given structured selection has changed.
- * This default implementation calls
- * <code>selectionChanged(ISelection selection)</code>.
- *
- * @param selection
- * the new selection
- */
- protected void selectionChanged(IStructuredSelection selection) {
- selectionChanged((ISelection) selection);
- }
-
- /**
- * Executes this actions with the given structured selection. This default
- * implementation calls <code>run(ISelection selection)</code>.
- */
- protected void run(IStructuredSelection selection) {
- run((ISelection) selection);
- }
-
- /**
- * Notifies this action that the given text selection has changed. This
- * default implementation calls
- * <code>selectionChanged(ISelection selection)</code>.
- *
- * @param selection
- * the new selection
- */
- protected void selectionChanged(ITextSelection selection) {
- selectionChanged((ISelection) selection);
- }
-
- /**
- * Executes this actions with the given text selection. This default
- * implementation calls <code>run(ISelection selection)</code>.
- */
- protected void run(ITextSelection selection) {
- run((ISelection) selection);
- }
-
- /**
- * Notifies this action that the given selection has changed. This default
- * implementation sets the action's enablement state to <code>false</code>.
- *
- * @param selection
- * the new selection
- */
- protected void selectionChanged(ISelection selection) {
- setEnabled(false);
- }
-
- /**
- * Executes this actions with the given selection. This default
- * implementation does nothing.
- */
- protected void run(ISelection selection) {
- }
-
- /*
- * (non-Javadoc) Method declared on IAction.
- */
- public void run() {
- dispatchRun(getSelection());
- }
-
- /*
- * (non-Javadoc) Method declared on ISelectionChangedListener.
- */
- public void selectionChanged(SelectionChangedEvent event) {
- dispatchSelectionChanged(event.getSelection());
- }
-
- private void dispatchSelectionChanged(ISelection selection) {
- if (selection instanceof IStructuredSelection) {
- selectionChanged((IStructuredSelection) selection);
- } else if (selection instanceof ITextSelection) {
- selectionChanged((ITextSelection) selection);
- } else {
- selectionChanged(selection);
- }
- }
-
- private void dispatchRun(ISelection selection) {
- if (selection instanceof IStructuredSelection) {
- run((IStructuredSelection) selection);
- } else if (selection instanceof ITextSelection) {
- run((ITextSelection) selection);
- } else {
- run(selection);
- }
- }
-}
\ No newline at end of file
git://secure.phpeclipse.com / phpeclipse.git / blobdiff