This extension point is used to supply configuration contributors for the Java Visual Editor. You can supply a contributor for a specific classpath container or for a plugin. <p> The way contributors work is that when a proxy vm for an editor is started or restarted, it goes through the classpath of the project and finds the visible containers (IClasspathContainer). If the container implements IVEContributor1, it will be called as a contributor. Then all of the visible container ids and plugin ids will be used to look into this extension point, and if found, the contributor will be created and asked to contribute. <p> The extensions will be called in plugin order. In other words if plugin A depends on plugin B, the contribution in plugin A will not be called before the contribution in plugin B. <p> If a plugin is in the classpath of the project (in other words the project is PDE plugin development project and requires a plugin) then the contributor with the given plugin id will be called. <p> Both container and plugin can be specified, but at least one of them must be specified. If both are specified, then this entry will be used if either the container or the plugin is found in the classpath.
a fully qualified identifier of the target extension point
an optional identifier of the extension instance
an optional name of the extension instance
This is a contributor for the visible container/plugin defined by container and plugin attributes.
contributor is for a container. The value is the container id (e.g. <b>"JRE_CONTAINER"</b>). This will match "/JRE_CONTAINER" or "/JRE_CONTAINER/...". Or <b>"JRE_CONTAINER/XYZ"</b> would match "/JRE_CONTAINER/XYZ/...". <p> You can also use a regular expression. An expression such as <b>"SWT_CONTAINER/.*/JFACE"</b> will match "/SWT_CONTAINER/PDE/JFACE" but will not match "/SWT_CONTAINER".
contributor is for a plugin. The value is the plugin id (e.g. "org.eclipse.swt").
the class that implements this contributor. The class must implement IVEContributor1.
This is for a simple palette category addition for the given plugin or container.
contributor is for a plugin. The value is the plugin id (e.g. "org.eclipse.swt").
contributor is for a container. The value is the container id (e.g. <b>"JRE_CONTAINER"</b>). This will match "/JRE_CONTAINER" or "/JRE_CONTAINER/...". Or <b>"JRE_CONTAINER/XYZ"</b> would match "/JRE_CONTAINER/XYZ/...". <p> You can also use a regular expression. An expression such as <b>"SWT_CONTAINER/.*/JFACE"</b> will match "/SWT_CONTAINER/PDE/JFACE" but will not match "/SWT_CONTAINER".
location of the category(s). Default is first.
an xmi file containing the categories to be added at "loc". If in the same plugin as the extension declaration, then it should not start with a '/' and the path will be relative to that plugin. If in a different plugin, then it should be of the form "/plugin-id/path-to-file", where "plugin-id" is the id of the plugin where the file is found.
1.0.0
The following is an example of a contributor:

<p> <pre> <extension point="org.eclipse.ve.java.core.contributors"> <contributor class="com.example.ContributorImplementation" container="MY_CONTAINER"> </contributor> </extension> </pre> This will use an instance of <samp>com.example.ContributorImplementation</samp> to supply contributions for the container "MY_CONTAINER". </p> <p> <pre> <extension point="org.eclipse.ve.java.core.contributors"> <palette container="MY_OTHER_CONTAINER" plugin="my.other.plugin" categories="palette/myOtherCats.xmi"> </palette> </extension> </pre> This will use the xmi file "palette/myOtherCats.xmi" for both the container "MY_OTHER_CONTAINER" and for plugin "my.other.plugin". </p>
The <samp>class</samp> attribute must be a fully-qualified class that implements the <samp>org.eclipse.ve.internal.java.codegen.editorpart.IVEContributor1</samp> interface.
There is <samp>org.eclipse.ve.internal.java.codegen.editorpart.VEContributorAdapter</samp> available to subclass to provide specific overrides. The default for the adapter is that it doesn't do anything. It also supplies some helper methods.
Copyright (c) 2004 IBM Corporation and others.<br> 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 <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>