bundles/org.eclipse.ui.workbench/Eclipse UI/org/eclipse/ui/internal/WWinPluginAction.java - platform/eclipse.platform.ui - Git at Google

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

 import java.util.ArrayList;
 import java.util.Iterator;

 import org.eclipse.core.runtime.IConfigurationElement;
 import org.eclipse.jface.action.IAction;
 import org.eclipse.jface.util.IPropertyChangeListener;
 import org.eclipse.jface.util.PropertyChangeEvent;
 import org.eclipse.jface.viewers.ISelection;
 import org.eclipse.swt.events.HelpEvent;
 import org.eclipse.swt.events.HelpListener;
 import org.eclipse.swt.widgets.Event;
 import org.eclipse.ui.IActionDelegate;
 import org.eclipse.ui.IWorkbenchPart;
 import org.eclipse.ui.IWorkbenchWindow;
 import org.eclipse.ui.IWorkbenchWindowActionDelegate;
 import org.eclipse.ui.WorkbenchException;
 import org.eclipse.ui.actions.LabelRetargetAction;
 import org.eclipse.ui.actions.RetargetAction;
 import org.eclipse.ui.internal.registry.IWorkbenchRegistryConstants;

 /**
  * This class extends regular plugin action with the additional requirement that
  * the delegate has to implement interface
  * {@link org.eclipse.ui.IWorkbenchWindowActionDelegate}. This interface has
  * one additional method (init) whose purpose is to initialize the delegate with
  * the window in which the action is intended to run.
  */
 public class WWinPluginAction extends PluginAction implements
         IActionSetContributionItem {
     /**
      * The help listener assigned to this action, or <code>null</code> if none.
      */
     private HelpListener localHelpListener;

     private IWorkbenchWindow window;

     private String actionSetId;

     private RetargetAction retargetAction;

     private static ArrayList staticActionList = new ArrayList(50);

     /**
      * Constructs a new <code>WWinPluginAction</code> object.
      *
      * @param actionElement the configuration element
      * @param window the window to contribute to
      * @param id the identifier
      * @param style the style
      */
     public WWinPluginAction(IConfigurationElement actionElement,
             IWorkbenchWindow window, String id, int style) {
         super(actionElement, id, style);
         this.window = window;

         // If config specifies a retarget action, create it now
         String retarget = actionElement
                 .getAttribute(IWorkbenchRegistryConstants.ATT_RETARGET);
         if (retarget != null && Boolean.valueOf(retarget).booleanValue()) {
             // create a retarget action
             String allowLabelUpdate = actionElement
                     .getAttribute(IWorkbenchRegistryConstants.ATT_ALLOW_LABEL_UPDATE);
             String label = actionElement
                     .getAttribute(IWorkbenchRegistryConstants.ATT_LABEL);

             if (allowLabelUpdate != null && Boolean.valueOf(allowLabelUpdate).booleanValue()) {
 				retargetAction = new LabelRetargetAction(id, label, style);
 			} else {
 				retargetAction = new RetargetAction(id, label, style);
 			}
             retargetAction
                     .addPropertyChangeListener(new IPropertyChangeListener() {
                         public void propertyChange(PropertyChangeEvent event) {
                             if (event.getProperty().equals(IAction.ENABLED)) {
                                 Object val = event.getNewValue();
                                 if (val instanceof Boolean) {
                                     setEnabled(((Boolean) val).booleanValue());
                                 }
                             } else if (event.getProperty().equals(
                                     IAction.CHECKED)) {
                                 Object val = event.getNewValue();
                                 if (val instanceof Boolean) {
                                     setChecked(((Boolean) val).booleanValue());
                                 }
                             } else if (event.getProperty().equals(IAction.TEXT)) {
                                 Object val = event.getNewValue();
                                 if (val instanceof String) {
                                     setText((String) val);
                                 }
                             } else if (event.getProperty().equals(
                                     IAction.TOOL_TIP_TEXT)) {
                                 Object val = event.getNewValue();
                                 if (val instanceof String) {
                                     setToolTipText((String) val);
                                 }
                             }
                         }
                     });
             retargetAction.setEnabled(false);
             setEnabled(false);
             window.getPartService().addPartListener(retargetAction);
             IWorkbenchPart activePart = window.getPartService().getActivePart();
             if (activePart != null) {
 				retargetAction.partActivated(activePart);
 			}
         } else {
             // if we retarget the handler will look after selection changes
             window.getSelectionService().addSelectionListener(this);
             refreshSelection();
         }
         addToActionList(this);

         super.setHelpListener(new HelpListener() {
             public void helpRequested(HelpEvent e) {
                 HelpListener listener = null;
                 if (retargetAction != null) {
 					listener = retargetAction.getHelpListener();
 				}
                 if (listener == null) {
 					// use our own help listener
                     listener = localHelpListener;
 				}
                 if (listener != null) {
 					// pass on the event
                     listener.helpRequested(e);
 				}
             }
         });
     }

     /**
      * Adds an item to the action list.
      */
     private static void addToActionList(WWinPluginAction action) {
         staticActionList.add(action);
     }

     /**
      * Removes an item from the action list.
      */
     private static void removeFromActionList(WWinPluginAction action) {
         staticActionList.remove(action);
     }

     /**
      * Creates any actions which belong to an activated plugin.
      */
     public static void refreshActionList() {
         Iterator iter = staticActionList.iterator();
         while (iter.hasNext()) {
             WWinPluginAction action = (WWinPluginAction) iter.next();
             if ((action.getDelegate() == null) && action.isOkToCreateDelegate()) {
                 action.createDelegate();
                 // creating the delegate also refreshes its enablement
             }
         }
     }

     /* (non-Javadoc)
      * Method declared on PluginAction.
      */
     protected IActionDelegate validateDelegate(Object obj)
             throws WorkbenchException {
         if (obj instanceof IWorkbenchWindowActionDelegate) {
 			return (IWorkbenchWindowActionDelegate) obj;
 		}

         throw new WorkbenchException(
                 "Action must implement IWorkbenchWindowActionDelegate"); //$NON-NLS-1$
     }

     /* (non-Javadoc)
      * Method declared on PluginAction.
      */
     protected void initDelegate() {
         super.initDelegate();
         ((IWorkbenchWindowActionDelegate) getDelegate()).init(window);
     }

     /**
      * Disposes of the action and any resources held.
      */
     public void dispose() {
         removeFromActionList(this);
         if (retargetAction != null) {
             window.getPartService().removePartListener(retargetAction);
             retargetAction.dispose();
             retargetAction = null;
         }
         window.getSelectionService().removeSelectionListener(this);
         super.dispose();
     }

     /**
      * Returns the action set id.
      */
     public String getActionSetId() {
         return actionSetId;
     }

     /**
      * Returns true if the window has been set.
      * The window may be null after the constructor is called and
      * before the window is stored.  We cannot create the delegate
      * at that time.
      */
     public boolean isOkToCreateDelegate() {
         return super.isOkToCreateDelegate() && window != null
                 && retargetAction == null;
     }

     /* (non-Javadoc)
      * Method declared on IActionDelegate2.
      */
     public void runWithEvent(Event event) {
         if (retargetAction == null) {
             super.runWithEvent(event);
             return;
         }

         if (event != null) {
 			retargetAction.runWithEvent(event);
 		} else {
 			retargetAction.run();
 		}
     }

     /**
      * Sets the action set id.
      */
     public void setActionSetId(String newActionSetId) {
         actionSetId = newActionSetId;
     }

     /**
      * The <code>WWinPluginAction</code> implementation of this method
      * declared on <code>IAction</code> stores the help listener in
      * a local field. The supplied listener is only used if there is
      * no retarget action.
      */
     public void setHelpListener(HelpListener listener) {
         localHelpListener = listener;
     }

     /* (non-Javadoc)
      * Method declared on IAction.
      */
     public void setChecked(boolean checked) {
         super.setChecked(checked);
         // This call may come from the SWT control event handler
         // itself, so notify the retarget action to keep things
         // in sync.
         if (retargetAction != null) {
 			retargetAction.setChecked(checked);
 		}
     }

     /**
      * Refresh the selection for the action.
      */
     protected void refreshSelection() {
         ISelection selection = window.getSelectionService().getSelection();
         selectionChanged(selection);
     }
 }
	/*******************************************************************************
	* Copyright (c) 2000, 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;

	import java.util.ArrayList;
	import java.util.Iterator;

	import org.eclipse.core.runtime.IConfigurationElement;
	import org.eclipse.jface.action.IAction;
	import org.eclipse.jface.util.IPropertyChangeListener;
	import org.eclipse.jface.util.PropertyChangeEvent;
	import org.eclipse.jface.viewers.ISelection;
	import org.eclipse.swt.events.HelpEvent;
	import org.eclipse.swt.events.HelpListener;
	import org.eclipse.swt.widgets.Event;
	import org.eclipse.ui.IActionDelegate;
	import org.eclipse.ui.IWorkbenchPart;
	import org.eclipse.ui.IWorkbenchWindow;
	import org.eclipse.ui.IWorkbenchWindowActionDelegate;
	import org.eclipse.ui.WorkbenchException;
	import org.eclipse.ui.actions.LabelRetargetAction;
	import org.eclipse.ui.actions.RetargetAction;
	import org.eclipse.ui.internal.registry.IWorkbenchRegistryConstants;

	/**
	* This class extends regular plugin action with the additional requirement that
	* the delegate has to implement interface
	* {@link org.eclipse.ui.IWorkbenchWindowActionDelegate}. This interface has
	* one additional method (init) whose purpose is to initialize the delegate with
	* the window in which the action is intended to run.
	*/
	public class WWinPluginAction extends PluginAction implements
	IActionSetContributionItem {
	/**
	* The help listener assigned to this action, or <code>null</code> if none.
	*/
	private HelpListener localHelpListener;

	private IWorkbenchWindow window;

	private String actionSetId;

	private RetargetAction retargetAction;

	private static ArrayList staticActionList = new ArrayList(50);

	/**
	* Constructs a new <code>WWinPluginAction</code> object.
	*
	* @param actionElement the configuration element
	* @param window the window to contribute to
	* @param id the identifier
	* @param style the style
	*/
	public WWinPluginAction(IConfigurationElement actionElement,
	IWorkbenchWindow window, String id, int style) {
	super(actionElement, id, style);
	this.window = window;

	// If config specifies a retarget action, create it now
	String retarget = actionElement
	.getAttribute(IWorkbenchRegistryConstants.ATT_RETARGET);
	if (retarget != null && Boolean.valueOf(retarget).booleanValue()) {
	// create a retarget action
	String allowLabelUpdate = actionElement
	.getAttribute(IWorkbenchRegistryConstants.ATT_ALLOW_LABEL_UPDATE);
	String label = actionElement
	.getAttribute(IWorkbenchRegistryConstants.ATT_LABEL);

	if (allowLabelUpdate != null && Boolean.valueOf(allowLabelUpdate).booleanValue()) {
	retargetAction = new LabelRetargetAction(id, label, style);
	} else {
	retargetAction = new RetargetAction(id, label, style);
	}
	retargetAction
	.addPropertyChangeListener(new IPropertyChangeListener() {
	public void propertyChange(PropertyChangeEvent event) {
	if (event.getProperty().equals(IAction.ENABLED)) {
	Object val = event.getNewValue();
	if (val instanceof Boolean) {
	setEnabled(((Boolean) val).booleanValue());
	}
	} else if (event.getProperty().equals(
	IAction.CHECKED)) {
	Object val = event.getNewValue();
	if (val instanceof Boolean) {
	setChecked(((Boolean) val).booleanValue());
	}
	} else if (event.getProperty().equals(IAction.TEXT)) {
	Object val = event.getNewValue();
	if (val instanceof String) {
	setText((String) val);
	}
	} else if (event.getProperty().equals(
	IAction.TOOL_TIP_TEXT)) {
	Object val = event.getNewValue();
	if (val instanceof String) {
	setToolTipText((String) val);
	}
	}
	}
	});
	retargetAction.setEnabled(false);
	setEnabled(false);
	window.getPartService().addPartListener(retargetAction);
	IWorkbenchPart activePart = window.getPartService().getActivePart();
	if (activePart != null) {
	retargetAction.partActivated(activePart);
	}
	} else {
	// if we retarget the handler will look after selection changes
	window.getSelectionService().addSelectionListener(this);
	refreshSelection();
	}
	addToActionList(this);

	super.setHelpListener(new HelpListener() {
	public void helpRequested(HelpEvent e) {
	HelpListener listener = null;
	if (retargetAction != null) {
	listener = retargetAction.getHelpListener();
	}
	if (listener == null) {
	// use our own help listener
	listener = localHelpListener;
	}
	if (listener != null) {
	// pass on the event
	listener.helpRequested(e);
	}
	}
	});
	}

	/**
	* Adds an item to the action list.
	*/
	private static void addToActionList(WWinPluginAction action) {
	staticActionList.add(action);
	}

	/**
	* Removes an item from the action list.
	*/
	private static void removeFromActionList(WWinPluginAction action) {
	staticActionList.remove(action);
	}

	/**
	* Creates any actions which belong to an activated plugin.
	*/
	public static void refreshActionList() {
	Iterator iter = staticActionList.iterator();
	while (iter.hasNext()) {
	WWinPluginAction action = (WWinPluginAction) iter.next();
	if ((action.getDelegate() == null) && action.isOkToCreateDelegate()) {
	action.createDelegate();
	// creating the delegate also refreshes its enablement
	}
	}
	}

	/* (non-Javadoc)
	* Method declared on PluginAction.
	*/
	protected IActionDelegate validateDelegate(Object obj)
	throws WorkbenchException {
	if (obj instanceof IWorkbenchWindowActionDelegate) {
	return (IWorkbenchWindowActionDelegate) obj;
	}

	throw new WorkbenchException(
	"Action must implement IWorkbenchWindowActionDelegate"); //$NON-NLS-1$
	}

	/* (non-Javadoc)
	* Method declared on PluginAction.
	*/
	protected void initDelegate() {
	super.initDelegate();
	((IWorkbenchWindowActionDelegate) getDelegate()).init(window);
	}

	/**
	* Disposes of the action and any resources held.
	*/
	public void dispose() {
	removeFromActionList(this);
	if (retargetAction != null) {
	window.getPartService().removePartListener(retargetAction);
	retargetAction.dispose();
	retargetAction = null;
	}
	window.getSelectionService().removeSelectionListener(this);
	super.dispose();
	}

	/**
	* Returns the action set id.
	*/
	public String getActionSetId() {
	return actionSetId;
	}

	/**
	* Returns true if the window has been set.
	* The window may be null after the constructor is called and
	* before the window is stored. We cannot create the delegate
	* at that time.
	*/
	public boolean isOkToCreateDelegate() {
	return super.isOkToCreateDelegate() && window != null
	&& retargetAction == null;
	}

	/* (non-Javadoc)
	* Method declared on IActionDelegate2.
	*/
	public void runWithEvent(Event event) {
	if (retargetAction == null) {
	super.runWithEvent(event);
	return;
	}

	if (event != null) {
	retargetAction.runWithEvent(event);
	} else {
	retargetAction.run();
	}
	}

	/**
	* Sets the action set id.
	*/
	public void setActionSetId(String newActionSetId) {
	actionSetId = newActionSetId;
	}

	/**
	* The <code>WWinPluginAction</code> implementation of this method
	* declared on <code>IAction</code> stores the help listener in
	* a local field. The supplied listener is only used if there is
	* no retarget action.
	*/
	public void setHelpListener(HelpListener listener) {
	localHelpListener = listener;
	}

	/* (non-Javadoc)
	* Method declared on IAction.
	*/
	public void setChecked(boolean checked) {
	super.setChecked(checked);
	// This call may come from the SWT control event handler
	// itself, so notify the retarget action to keep things
	// in sync.
	if (retargetAction != null) {
	retargetAction.setChecked(checked);
	}
	}

	/**
	* Refresh the selection for the action.
	*/
	protected void refreshSelection() {
	ISelection selection = window.getSelectionService().getSelection();
	selectionChanged(selection);
	}
	}