#
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 (#PCDATA)>

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 Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html