[转]Eclipse插件开发之基础篇(2) 第一个Eclipse插件

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

<?xml version="1.0" encoding="UTF-8"?>

<?eclipse version="3.4"?>

<plugin>

   <extension

         point="org.eclipse.ui.actionSets"> ①

      <actionSet

            label="Sample Action Set"

            visible="true"

            id="cn.sf.amateras.sample.actionSet">

         <menu

               label="Sample &Menu"

               id="sampleMenu">

            <separator

                  name="sampleGroup">

            </separator>

         </menu>

         <action

               label="&Sample Action"

               icon="icons/sample.gif"

               class="cn.sf.amateras.sample.actions.SampleAction" ②

               tooltip="Hello, Eclipse world"

               menubarPath="sampleMenu/sampleGroup"

               toolbarPath="sampleGroup"

               id="cn.sf.amateras.sample.actions.SampleAction">

         </action>

      </actionSet>

   </extension>

</plugin>

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

package cn.sf.amateras.sample.actions;

import org.eclipse.jface.action.IAction;

import org.eclipse.jface.viewers.ISelection;

import org.eclipse.ui.IWorkbenchWindow;

import org.eclipse.ui.IWorkbenchWindowActionDelegate;

import org.eclipse.jface.dialogs.MessageDialog;

/**

 * Our sample action implements workbench action delegate.

 * The action proxy will be created by the workbench and

 * shown in the UI. When the user tries to use the action,

 * this delegate will be created and execution will be

 * delegated to it.

 * @see IWorkbenchWindowActionDelegate

 */

public class SampleAction implements IWorkbenchWindowActionDelegate {

    private IWorkbenchWindow window;

    /**

     * The constructor.

     */

    public SampleAction() {

    }

    /**

     * The action has been activated. The argument of the

     * method represents the ‘real‘ action sitting

     * in the workbench UI.

     * @see IWorkbenchWindowActionDelegate#run

     */

    public void run(IAction action) {   //......①

        MessageDialog.openInformation(

            window.getShell(),

            "Sample",

            "Hello, Eclipse world");

    }

    /**

     * Selection in the workbench has been changed. We

     * can change the state of the ‘real‘ action here

     * if we want, but this can only happen after

     * the delegate has been created.

     * @see IWorkbenchWindowActionDelegate#selectionChanged

     */

    public void selectionChanged(IAction action, ISelection selection) {

    }

    /**

     * We can use this method to dispose of any system

     * resources we previously allocated.

     * @see IWorkbenchWindowActionDelegate#dispose

     */

    public void dispose() {

    }

    /**

     * We will cache window object in order to

     * be able to provide parent shell for the message dialog.

     * @see IWorkbenchWindowActionDelegate#init

     */

    public void init(IWorkbenchWindow window) {

        this.window = window;

    }

}

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

package cn.sf.amateras.sample;

import org.eclipse.jface.resource.ImageDescriptor;

import org.eclipse.ui.plugin.AbstractUIPlugin;  //....①

import org.osgi.framework.BundleContext;

/**

 * The activator class controls the plug-in life cycle

 */

public class Activator extends AbstractUIPlugin {

    // The plug-in ID

    public static final String PLUGIN_ID = "cn.sf.amateras.sample"; //$NON-NLS-1$

    // The shared instance

    private static Activator plugin;

    /**

     * The constructor

     */

    public Activator() {

    }

    /*

     * (non-Javadoc)

     * @see org.eclipse.ui.plugin.AbstractUIPlugin#start(org.osgi.framework.BundleContext)

     */

    public void start(BundleContext context) throws Exception {//....③

        super.start(context);

        plugin = this;

    }

    /*

     * (non-Javadoc)

     * @see org.eclipse.ui.plugin.AbstractUIPlugin#stop(org.osgi.framework.BundleContext)

     */

    public void stop(BundleContext context) throws Exception {//....④

        plugin = null;

        super.stop(context);

    }

    /**

     * Returns the shared instance

     *

     * @return the shared instance

     */

    public static Activator getDefault() {//....②

        return plugin;

    }

    /**

     * Returns an image descriptor for the image file at the given

     * plug-in relative path

     *

     * @param path the path

     * @return the image descriptor

     */

    public static ImageDescriptor getImageDescriptor(String path) {

        return imageDescriptorFromPlugin(PLUGIN_ID, path);

    }

}