Import Wizards

Identifier:
org.eclipse.ui.importWizards

Description:
This extension point is used to register import wizard extensions. Import wizards appear as choices within the "Import Dialog" and are used to import resources into the workbench.
Wizards may optionally specify a description subelement whose body should contain short text about the wizard.

Configuration Markup:

<!ELEMENT extension (wizard*)>

<!ATTLIST extension

point CDATA #REQUIRED
id    CDATA #IMPLIED
name  CDATA #IMPLIED>

point - a fully qualified identifier of the target extension point
id - an optional identifier of the extension instance
name - an optional name of the extension instance

<!ELEMENT wizard (description? , selection*)>

<!ATTLIST wizard

id    CDATA #REQUIRED
name  CDATA #REQUIRED
class CDATA #REQUIRED
icon  CDATA #IMPLIED>

an element that will be used to create import wizard

id - a unique name that will be used to identify this wizard
name - a translatable name that will be used in the dialog box to represent this wizard
class - a fully qualified name of the class that implements org.eclipse.ui.IImportWizard interface
icon - a relative name of the icon that will be used alongside the wizard name in the import engine listing.

<!ELEMENT description (#CDATA)>

an optional subelement whose body should represent a short description of the import engine functionality.

<!ELEMENT selection EMPTY>

<!ATTLIST selection

name  CDATA #IMPLIED
class CDATA #REQUIRED>

an optional element that restricts the types and names of objects that can be selected when the wizard is invoked.

name - an optional name filter. Each object in the workbench selection must match the name filter to be passed to the wizard.
class - fully qualified class name. If each object in the workbench selection implements this interface the selection will be passed to the wizard. Otherwise, an empty selection is passed.

Examples:
The following is an example of an import extension definition:
   <extension 
       point=
"org.eclipse.ui.importWizards"
> 
      <wizard 
         id=
"com.xyz.ImportWizard1"
 
         name=
"XYZ Web Scraper"
 
         class=
"com.xyz.imports.ImportWizard1"
 
         icon=
"./icons/import1.gif"
> 
         <description> 
            A simple engine that searches the Web and imports files 
         </description> 
         <selection class=
"org.eclipse.core.resources.IResource"
/> 
      </wizard> 
   </extension> 
API Information:
The value of the class attribute must represent a name of the class that implements org.eclipse.ui.IImportWizard.

Supplied Implementation:
The workbench comes preloaded with the basic import engines for files and directories.

Copyright (c) 2002, 2004 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made available under the terms of the Common Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/cpl-v10.html