| gvSIG desktop 1

package org.gvsig.app.project.documents;

import java.util.Iterator;

import javax.swing.ImageIcon;

import org.gvsig.andami.ui.mdiManager.IWindow;

import org.gvsig.app.project.Project;

import org.gvsig.app.project.documents.gui.IDocumentWindow;

import org.gvsig.app.project.documents.gui.WindowLayout;

import org.gvsig.tools.extensionpoint.ExtensionBuilder;

import org.gvsig.tools.persistence.PersistenceFactory;

public interface DocumentManager extends ExtensionBuilder, PersistenceFactory{

        /**

         * Returns the type of document priority.

         *

         * @return Priority.

         */

        public int getPriority();

        /**

         * Returns tdocumenthe icon for the type of document.

         *

         * @return Image.

         */

        public ImageIcon getIcon();

        /**

         * Returns the icon for the type of document when is selected

         *

         * @return Image.

         */

        public ImageIcon getIconSelected();

        /**

         * Create a new ProjectDocument.

         *

         * @param project Opened project.

         *

         * @return ProjectDocument.

         */

        public AbstractDocument createDocument();

                /**

     * Uses a gui to be able from the characteristics that we want a

     * ProjectDocument

     * 

     * @return a new Document

     * 

     * @deprecated user {@link #createDocumentsByUser()} instead

     */

        public AbstractDocument createDocumentByUser();

    /**

     * Uses a gui to be able from the characteristics that we want a

     * ProjectDocument

     * 

     * @return the created documents

     */

    public Iterator<? extends Document> createDocumentsByUser();

        /**

         * Returns the title of type of document.

         *

         * @return String title for type of document

         */

        public String getTitle();

        /**

         * Returns the type name of the document factory.

         *

         * @return Name of registration

         */

        public String getTypeName();

        /**

         * Return the main window asociated to the passed document. 

         * If the window alreade exists return it. If not, a new

         * window is created.

         * 

         * @param doc

         * @return Window asociated to document

         */

        public IWindow getMainWindow(Document doc) ;

        /**

         * Return the main window asociated to the document.

         * 

         * @param doc, layout

         * @return Window asociated to document

         */

        public IWindow getMainWindow(Document doc, WindowLayout layout) ;

        /**

         * Return the windows properties asociated to the document.

         * @param doc

         * @return

         */

        public IWindow getPropertiesWindow(Document doc) ;

        /**

         * Return true if the name exists to another document.

         *

         * @param project

         * @param documentName

         *

         * @return True if the name exists.

         * @deprecated use instead  project.getDocument

         */

        public boolean existName(Project project, String documentName);

        /**

         * Return the class that implement the main window for this type of

         * documents.

         * 

         * @return the class of main window 

         */

    public Class<? extends IDocumentWindow> getMainWindowClass();

}