Fix import
[phpeclipse.git] / net.sourceforge.phpeclipse / src / net / sourceforge / phpdt / ui / actions / SelectionDispatchAction.java
index 321c425..41d8d34 100644 (file)
@@ -22,18 +22,19 @@ 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. 
+ * 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>
+ * <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>
  * 
@@ -43,21 +44,23 @@ import org.eclipse.ui.IWorkbenchSite;
  * 
  * @since 2.0
  */
-public abstract class SelectionDispatchAction extends Action implements ISelectionChangedListener {
-       
+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
+        * @param site
+        *            the site this action is working on
         */
        protected SelectionDispatchAction(IWorkbenchSite site) {
                Assert.isNotNull(site);
-               fSite= site;
+               fSite = site;
        }
 
        /**
@@ -73,7 +76,7 @@ public abstract class SelectionDispatchAction extends Action implements ISelecti
         * Returns the selection provided by the site owning this action.
         * 
         * @return the site's selection
-        */     
+        */
        public ISelection getSelection() {
                return getSelectionProvider().getSelection();
        }
@@ -81,94 +84,101 @@ public abstract class SelectionDispatchAction extends Action implements ISelecti
        /**
         * Returns the shell provided by the site owning this action.
         * 
-        * @return the site's shell     
+        * @return the site's shell
         */
-       public  Shell getShell() {
+       public Shell getShell() {
                return fSite.getShell();
        }
-       
+
        /**
         * Returns the selection provider managed by the site owning this action.
         * 
-        * @return the site's selection provider        
+        * @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.
+        * 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
+        * @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>.
+        * Notifies this action that the given structured selection has changed.
+        * This default implementation calls
+        * <code>selectionChanged(ISelection selection)</code>.
         * 
-        * @param selection the new selection
-        */
+        * @param selection
+        *            the new selection
+        */
        protected void selectionChanged(IStructuredSelection selection) {
-               selectionChanged((ISelection)selection);
+               selectionChanged((ISelection) selection);
        }
 
        /**
-        * Executes this actions with the given structured selection. This default implementation
-        * calls <code>run(ISelection selection)</code>.
+        * 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);
+               run((ISelection) selection);
        }
-       
+
        /**
-        * Notifies this action that the given text selection has changed.  This default
-        * implementation calls <code>selectionChanged(ISelection selection)</code>.
+        * Notifies this action that the given text selection has changed. This
+        * default implementation calls
+        * <code>selectionChanged(ISelection selection)</code>.
         * 
-        * @param selection the new selection
-        */
+        * @param selection
+        *            the new selection
+        */
        protected void selectionChanged(ITextSelection selection) {
-               selectionChanged((ISelection)selection);
+               selectionChanged((ISelection) selection);
        }
-       
+
        /**
-        * Executes this actions with the given text selection. This default implementation
-        * calls <code>run(ISelection selection)</code>.
+        * 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);
+               run((ISelection) selection);
        }
-       
+
        /**
-        * Notifies this action that the given selection has changed.  This default
+        * 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
-        */
+        * @param selection
+        *            the new selection
+        */
        protected void selectionChanged(ISelection selection) {
                setEnabled(false);
        }
-       
+
        /**
-        * Executes this actions with the given selection. This default implementation
-        * does nothing.
+        * Executes this actions with the given selection. This default
+        * implementation does nothing.
         */
        protected void run(ISelection selection) {
        }
 
-       /* (non-Javadoc)
-        * Method declared on IAction.
+       /*
+        * (non-Javadoc) Method declared on IAction.
         */
        public void run() {
                dispatchRun(getSelection());
        }
-       
-       /* (non-Javadoc)
-        * Method declared on ISelectionChangedListener.
+
+       /*
+        * (non-Javadoc) Method declared on ISelectionChangedListener.
         */
        public void selectionChanged(SelectionChangedEvent event) {
                dispatchSelectionChanged(event.getSelection());
@@ -176,9 +186,9 @@ public abstract class SelectionDispatchAction extends Action implements ISelecti
 
        private void dispatchSelectionChanged(ISelection selection) {
                if (selection instanceof IStructuredSelection) {
-                       selectionChanged((IStructuredSelection)selection);
+                       selectionChanged((IStructuredSelection) selection);
                } else if (selection instanceof ITextSelection) {
-                       selectionChanged((ITextSelection)selection);
+                       selectionChanged((ITextSelection) selection);
                } else {
                        selectionChanged(selection);
                }
@@ -186,9 +196,9 @@ public abstract class SelectionDispatchAction extends Action implements ISelecti
 
        private void dispatchRun(ISelection selection) {
                if (selection instanceof IStructuredSelection) {
-                       run((IStructuredSelection)selection);
+                       run((IStructuredSelection) selection);
                } else if (selection instanceof ITextSelection) {
-                       run((ITextSelection)selection);
+                       run((ITextSelection) selection);
                } else {
                        run(selection);
                }