Refactory: replaced deprecated constructor DefaultInformationControl(Shell, int,...
[phpeclipse.git] / net.sourceforge.phpeclipse.ui / src / net / sourceforge / phpdt / ui / actions / SelectionDispatchAction.java
1 /*******************************************************************************
2  * Copyright (c) 2002 International Business Machines Corp. and others.
3  * All rights reserved. This program and the accompanying materials 
4  * are made available under the terms of the Common Public License v0.5 
5  * which accompanies this distribution, and is available at
6  * http://www.eclipse.org/legal/cpl-v05.html
7  * 
8  * Contributors:
9  *     IBM Corporation - initial API and implementation
10  ******************************************************************************/
11 package net.sourceforge.phpdt.ui.actions;
12
13 import org.eclipse.jface.action.Action;
14 import org.eclipse.jface.text.ITextSelection;
15 //incastrix
16 //import org.eclipse.jface.text.Assert;
17 import org.eclipse.core.runtime.Assert;
18 import org.eclipse.jface.viewers.ISelection;
19 import org.eclipse.jface.viewers.ISelectionChangedListener;
20 import org.eclipse.jface.viewers.ISelectionProvider;
21 import org.eclipse.jface.viewers.IStructuredSelection;
22 import org.eclipse.jface.viewers.SelectionChangedEvent;
23 import org.eclipse.swt.widgets.Shell;
24 import org.eclipse.ui.IWorkbenchSite;
25
26 /**
27  * Action that dispatches the <code>IAction#run()</code> and the
28  * <code>ISelectionChangedListener#selectionChanged</code> according to the
29  * type of the selection.
30  * 
31  * <ul>
32  * <li>if selection is of type <code>ITextSelection</code> then
33  * <code>run(ITextSelection)</code> and
34  * <code>selectionChanged(ITextSelection)</code> is called.</li>
35  * <li>if selection is of type <code>IStructuredSelection</code> then
36  * <code>run(IStructuredSelection)</code> and <code>
37  *      selectionChanged(IStructuredSelection)</code>
38  * is called.</li>
39  * <li>default is to call <code>run(ISelection)</code> and <code>
40  *      selectionChanged(ISelection)</code>.</li>
41  * </ul>
42  * 
43  * <p>
44  * Note: This class is not intended to be subclassed outside the JDT UI plugin.
45  * </p>
46  * 
47  * @since 2.0
48  */
49 public abstract class SelectionDispatchAction extends Action implements
50                 ISelectionChangedListener {
51
52         private IWorkbenchSite fSite;
53
54         /**
55          * Creates a new action with no text and no image.
56          * <p>
57          * Configure the action later using the set methods.
58          * </p>
59          * 
60          * @param site
61          *            the site this action is working on
62          */
63         protected SelectionDispatchAction(IWorkbenchSite site) {
64                 Assert.isNotNull(site);
65                 fSite = site;
66         }
67
68         /**
69          * Returns the site owning this action.
70          * 
71          * @return the site owning this action
72          */
73         public IWorkbenchSite getSite() {
74                 return fSite;
75         }
76
77         /**
78          * Returns the selection provided by the site owning this action.
79          * 
80          * @return the site's selection
81          */
82         public ISelection getSelection() {
83                 return getSelectionProvider().getSelection();
84         }
85
86         /**
87          * Returns the shell provided by the site owning this action.
88          * 
89          * @return the site's shell
90          */
91         public Shell getShell() {
92                 return fSite.getShell();
93         }
94
95         /**
96          * Returns the selection provider managed by the site owning this action.
97          * 
98          * @return the site's selection provider
99          */
100         public ISelectionProvider getSelectionProvider() {
101                 return fSite.getSelectionProvider();
102         }
103
104         /**
105          * Updates the action's enablement state according to the given selection.
106          * This default implementation calls one of the
107          * <code>selectionChanged</code> methods depending on the type of the
108          * passed selection.
109          * 
110          * @param selection
111          *            the selection this action is working on
112          */
113         public void update(ISelection selection) {
114                 dispatchSelectionChanged(selection);
115         }
116
117         /**
118          * Notifies this action that the given structured selection has changed.
119          * This default implementation calls
120          * <code>selectionChanged(ISelection selection)</code>.
121          * 
122          * @param selection
123          *            the new selection
124          */
125         protected void selectionChanged(IStructuredSelection selection) {
126                 selectionChanged((ISelection) selection);
127         }
128
129         /**
130          * Executes this actions with the given structured selection. This default
131          * implementation calls <code>run(ISelection selection)</code>.
132          */
133         protected void run(IStructuredSelection selection) {
134                 run((ISelection) selection);
135         }
136
137         /**
138          * Notifies this action that the given text selection has changed. This
139          * default implementation calls
140          * <code>selectionChanged(ISelection selection)</code>.
141          * 
142          * @param selection
143          *            the new selection
144          */
145         protected void selectionChanged(ITextSelection selection) {
146                 selectionChanged((ISelection) selection);
147         }
148
149         /**
150          * Executes this actions with the given text selection. This default
151          * implementation calls <code>run(ISelection selection)</code>.
152          */
153         protected void run(ITextSelection selection) {
154                 run((ISelection) selection);
155         }
156
157         /**
158          * Notifies this action that the given selection has changed. This default
159          * implementation sets the action's enablement state to <code>false</code>.
160          * 
161          * @param selection
162          *            the new selection
163          */
164         protected void selectionChanged(ISelection selection) {
165                 setEnabled(false);
166         }
167
168         /**
169          * Executes this actions with the given selection. This default
170          * implementation does nothing.
171          */
172         protected void run(ISelection selection) {
173         }
174
175         /*
176          * (non-Javadoc) Method declared on IAction.
177          */
178         public void run() {
179                 dispatchRun(getSelection());
180         }
181
182         /*
183          * (non-Javadoc) Method declared on ISelectionChangedListener.
184          */
185         public void selectionChanged(SelectionChangedEvent event) {
186                 dispatchSelectionChanged(event.getSelection());
187         }
188
189         private void dispatchSelectionChanged(ISelection selection) {
190                 if (selection instanceof IStructuredSelection) {
191                         selectionChanged((IStructuredSelection) selection);
192                 } else if (selection instanceof ITextSelection) {
193                         selectionChanged((ITextSelection) selection);
194                 } else {
195                         selectionChanged(selection);
196                 }
197         }
198
199         private void dispatchRun(ISelection selection) {
200                 if (selection instanceof IStructuredSelection) {
201                         run((IStructuredSelection) selection);
202                 } else if (selection instanceof ITextSelection) {
203                         run((ITextSelection) selection);
204                 } else {
205                         run(selection);
206                 }
207         }
208 }