| gvSIG desktop 1

/* gvSIG. Sistema de Informaci?n Geogr?fica de la Generalitat Valenciana

 *

 * Copyright (C) 2004-2007 IVER T.I. and Generalitat Valenciana.

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,USA.

 *

 * For more information, contact:

 *

 *  Generalitat Valenciana

 *   Conselleria d'Infraestructures i Transport

 *   Av. Blasco Ib??ez, 50

 *   46010 VALENCIA

 *   SPAIN

 *

 *      +34 963862235

 *   gvsig@gva.es

 *      www.gvsig.gva.es

 *

 *    or

 *

 *   IVER T.I. S.A

 *   Salamanca 50

 *   46005 Valencia

 *   Spain

 *

 *   +34 963163400

 *   dac@iver.es

 */

package org.gvsig.andami.ui.mdiManager;

import java.awt.Dimension;

import java.awt.Rectangle;

import java.beans.PropertyChangeListener;

import java.beans.PropertyChangeSupport;

import java.util.HashMap;

import java.util.Map;

import org.exolab.castor.xml.XMLException;

import org.gvsig.andami.PluginServices;

import org.gvsig.tools.ToolsLocator;

import org.gvsig.tools.dynobject.DynStruct;

import org.gvsig.tools.persistence.PersistenceManager;

import org.gvsig.tools.persistence.Persistent;

import org.gvsig.tools.persistence.PersistentState;

import org.gvsig.tools.persistence.exception.PersistenceException;

import org.gvsig.tools.util.Callable;

import org.gvsig.utils.XMLEntity;

/**

 * This class represents the state of the associated window.

 * The <code>set</code> methods (<code>setX</code>, <code>setY</code>,

 * <code>setHeight</code>, etc) are immediately reflected on the

 * window.

 *

 * The <code>update</code> methods doesn't update the window, because

 * they are used to update the WindowInfo object when the associated

 * window was modified by user interaction.

 *

 * @author Fernando Gonz?lez Cort?s

 */

public class WindowInfo implements Persistent{

        public static final String PERSISTENCE_DEFINITION_NAME = "WindowInfo";

        /** Specifies that the window is resizable  */

    public static final int RESIZABLE = 1;

    /** Specifies that the window is maximizable */

    public static final int MAXIMIZABLE = 2;

    /** Specifies that the window is iconifiable */

    public static final int ICONIFIABLE = 4;

    /** Specifies that the window is modal */

    public static final int MODALDIALOG = 8;

    /** Specifies that the window is modeless (it's on the top but doesn't block any other window) */

    public static final int MODELESSDIALOG = 16;

    /** Specifies that the window may be docked inside another window */

    public static final int PALETTE = 32;

    /** Specifies that the window may be closed */

    public static final int NOTCLOSABLE = 64;

    /** Specifies that this window has an editor profile */

    public static final Integer EDITOR_PROFILE = new Integer(1);

    /** Specifies that this window has an editor profile */

    public static final Integer TOOL_PROFILE = new Integer(2);

    /** Specifies that this window has an editor profile */

    public static final Integer PROJECT_PROFILE = new Integer(3);

    /** Specifies that this window has an editor profile */

    public static final Integer PROPERTIES_PROFILE = new Integer(4);

    /** Specifies that this window has an editor profile */

    public static final Integer DIALOG_PROFILE = new Integer(5);

    private PropertyChangeSupport support = new PropertyChangeSupport(this);

    /** DOCUMENT ME! */

    private boolean resizable = false;

    /** DOCUMENT ME! */

    private boolean maximizable = false;

    /** DOCUMENT ME! */

    private boolean iconifiable = false;

    /** DOCUMENT ME! */

    private boolean modal = false;

    private boolean modeless = false;

    private boolean notclosable = false;

    /**

     * Do we want to persist the geometry of this window in the project file?

     */

    private boolean persistWindow = true;

    /**

     * Se usa para poner una ventana de tipo paleta, por

     * encima de las dem?s. Equivale a poner usar

     * JDesktopPane.PALETTE_LAYER

     */

    private boolean palette = false;

    private String additionalInfo = null;

    /** These properties store the dimension and position of the frame */

    private int width = -1;

    private int height = -1;

    private int x = -1;

    private int y = -1;

    /**

     * These properties store the position and dimension of the frame when it is not maximized

     * (so that it can be restored to its original size). They are equal to the not-normal properties

     * when the frame is not maximized, and different when the frame is maximized.

     */

    private int normalX = 0;

    private int normalY = 0;

    private int normalHeight = -1;

    private int normalWidth = -1;

    /** The minimum allowed size for this window. */

    private Dimension minSize = null;

    /* Whether the window is maximized */

    private boolean isMaximized = false;

    private boolean visible = true;

    /* Whether the window is closed */

    private boolean isClosed = false;

    /** DOCUMENT ME! */

    private String title;

    private int id;

    /**

     * ActionCommand del tool seleccionado. Lo usamos

     * para activar el tool que estaba seleccionado en

     * la vista, cuando volvemos a ella.

     */

    @SuppressWarnings("rawtypes")

        private Map selectedTools = null;

    // this should be the same value defined at plugin-config.xsd

    private String defaultGroup = "unico";

    /**

     * Adds a PropertyChangeListener to the listener list. The listener will be

     * notified about changes in this object.

     *

     * @param listener

     */

    public void addPropertyChangeListener(PropertyChangeListener listener) {

        support.addPropertyChangeListener(listener);

    }

    /**

     * Remove a PropertyChangeListener from the listener list. The listener will

     * not be notified anymore about changes in this object.

     *

     * @param listener

     */

    public void removePropertyChangeListener(PropertyChangeListener listener) {

        support.removePropertyChangeListener(listener);

    }

    /**

     * Creates a new WindowInfo object with the provided properties.

     * Valid properties include:

     * <ul>

     * <li>WindowInfo.MODALDIALOG</li>

     * <li>WindowInfo.MODELESSDIALOG</li>

     * <li>WindowInfo.PALETTE</li>

     * <li>WindowInfo.ICONIFIABLE</li>

     * <li>WindowInfo.RESIZABLE</li>

     * <li>WindowInfo.MAXIMIZABLE</li>

     *

     * <p>Properties can be set together by using the binary OR operator

     * "<b>|</b>". For example:</p>

     *

     * <p><code>WindowInfo wi = new WindowInfo(WindowInfo.MODELESSDIALOG

     *   |WindowInfo.ICONIFIABLE|WindowInfo.RESIZABLE).</code></p>

     *

     * <p>The WindowInfo.MODELESSDIALOG and WindowInfo.MODALDIALOG properties

     * cannot be set at the same time</p>

     *

     * @param code Bit-or of the window properties.

     *

     * @throws IllegalStateException If incompatible properties are set together,

     * for example, if MODALDIALOG and MODELESSDIALGO are set together.

     */

    public WindowInfo(int code) {

        resizable = (code % 2) > 0;

        code = code / 2;

        maximizable = (code % 2) > 0;

        code = code / 2;

        iconifiable = (code % 2) > 0;

        code = code / 2;

        modal = (code % 2) > 0;

        code = code / 2;

        modeless = (code % 2) > 0;

        code = code / 2;

        palette = (code % 2) > 0;

        code = code / 2;

        notclosable = (code % 2) > 0;

        if (modal && modeless) {

            throw new IllegalStateException("modal && modeless");

        }

    }

    /**

     * Creates a new WindowInfo object with the default properties:

     * <ul>

     * <li>not resizable</li>

     * <li>not maximizable</li>

     * <li>not iconifiable</li>

     * <li>not modal</li>

     * <li>not modeless</li>

     * <li>not palette</li>

     * </uil>

     *

     */

    public WindowInfo(){

    }

    /**

     * Returns the current x coordinate of the window's origin

     * (left-upper corner of the window).

     *

     * @return Returns the value (in pixels) of the x coordinate

     * of the window's origin.

     */

    public int getX() {

        return x;

    }

    /**

     * Sets the x coordinate of the window's origin

     * (left-upper corner of the window).

     *

     * @param x        The value (in pixels) of the x coordinate to set.

     */

    public void setX(int x) {

            support.firePropertyChange("x", this.x, x);

            this.x = x;

            if (!isMaximized)

                    this.normalX = x;

    }

    /**

     * Updates the value of the x coordinate for this WindowInfo

     * object. It doesn't get reflected on the window (use

     * setX for that).

     *

     * @param x The value (in pixels) of the x coordinate

     */

    public void updateX(int x) {

            this.x = x;

            if (!isMaximized)

                    this.normalX = x;

    }

    /**

     * Gets the value of the y coordinate for the origin

     * (left-upper corner of the window) of the associated

     * window.

     *

     * @return Returns the y coordinate (in pixels).

     */

    public int getY() {

        return y;

    }

    /**

     * Sets the value of the y coordinate for the origin

     * (left-upper corner of the window) of the associated

     * window.

     *

     * @param y The value (in pixels) of the y coordinate

     */

    public void setY(int y) {

            support.firePropertyChange("y", this.y, y);

        this.y = y;

        if (!isMaximized)

                this.normalY = y;

    }

    /**

     * Updates the value of the y coordinate for this WindowInfo

     * object. It doesn't get reflected on the window (use

     * setY for that).

     *

     * @param y The value (in pixels) of the y coordinate

     */

    public void updateY(int y) {

            this.y = y;

            if (!isMaximized)

                    this.normalY = y;

    }

    /**

     * Determines whether the associated window is iconifiable or not

     *

     * @return

     */

    public boolean isIconifiable() {

        return iconifiable;

    }

    /**

     * Determines whether the associated window is maximizable or not

     *

     * @return

     */

    public boolean isMaximizable() {

        return maximizable;

    }

    /**

     * Determines whether the associated window is resizable or not

     *

     * @return

     */

    public boolean isResizable() {

        return resizable;

    }

    /**

     * Determines whether the associated window is modal or not

     *

     * @return

     */

    public boolean isModal() {

        return modal;

    }

    /**

     * Gets the window height.

     *

     * @return The window height (in pixels).

     */

    public int getHeight() {

        return height;

    }

    /**

     * Gets the window width.

     *

     * @return The window width (in pixels).

     */

    public int getWidth() {

        return width;

    }

    /**

     * Sets the window height.

     *

     * @param The window height (in pixels)

     */

    public void setHeight(int height) {

            if (height!=-1)

                    support.firePropertyChange("height", this.height, height);

            this.height = height;

        if (!isMaximized)

                this.normalHeight = height;

    }

    /**

     * Updates the height property for this WindowInfo

     * object. It doesn't get reflected on the window (use

     * <code>setHeight</code> for that).

     *

     * @param height The height value for this WindowInfo object

     */

    public void updateHeight(int height) {

            this.height = height;

        if (!isMaximized)

                this.normalHeight = height;

    }

    /**

     * Sets the width property for the associated Window.

     *

     * @param w The new width.

     */

    public void setWidth(int w) {

            if (w!=-1)

                    support.firePropertyChange("width", this.width, w);

        width = w;

        if (!isMaximized)

                this.normalWidth = w;

    }

    /**

     * Updates the width property for for this WindowInfo

     * object. It doesn't get reflected on the window (use

     * <code>setWidth</code> for that).

     *

     * @param height The height value for this WindowInfo object

     */

    public void updateWidth(int width) {

            this.width = width;

        if (!isMaximized)

                this.normalWidth = width;

    }

    /**

     * Gets the title property

     *

     * @return

     */

    public String getTitle() {

        return title;

    }

    /**

     * Sets the title property.

     *

     * @param title The new title.

     */

    public void setTitle(String title) {

            support.firePropertyChange("title", this.title, title);

        this.title = title;

    }

    /**

     * Updates the title property for for this WindowInfo

     * object. It doesn't get reflected on the window (use

     * <code>setTitle</code> for that).

     *

     * @param title The title value for this WindowInfo object

     */

    public void updateTitle(String title) {

            this.title = title;

    }

    /**

     * Determines whether the associated window is modeless

     * (it is on the top but does not block any other window)

     *

     * @return

     */

    public boolean isModeless() {

        return modeless;

    }

    /**

     * Determines whether the associated window is closable or not

     *

     * @return

     */

    public boolean isNotClosable() {

        return notclosable;

    }

    /**

     * Sets notclosable property

     *

     * @return

     */

    public void setNotClosable(boolean b) {

        notclosable = b;

    }

     /**

      * Determines whether the associated window is visible

      *

      * @return true if the associated window is visible, false

      * if it is hidden

      */

    public boolean isVisible() {

        return visible;

    }

    /**

     * Determines whether the associated dockable window is

     * currently in palette status or docked.

     *

     * @return true if the window is currently in palette status,

     * false if it is docked in another window

     */

    public boolean isPalette()

    {

        return palette;

    }

    /**

     * Sets the window's ID.

     *

     * @param id An integer to identify the window. Different

     * windows must have different IDs.

     */

    public void setId(int id){

            this.id = id;

    }

    /**

     * Gets the window ID.

     *

     * @return id An integer to identify the window. Different

     * windows must have different IDs.

     */

    public int getId(){

            return id;

    }

    /**

     * Updates all the properties in this object so that

     * they match the properties of the provided

     * <code>wi</code> object. The changes are not reflected on the

     * window, just the WindowInfo object is updated.

     *

     * @param vi A WindowInfo object containing the new

     * properties of the window.

     */

    public void setWindowInfo(WindowInfo vi){

            this.resizable = vi.resizable;

            this.maximizable = vi.maximizable;

            this.isMaximized = vi.isMaximized;

            this.iconifiable = vi.iconifiable;

            this.additionalInfo = vi.additionalInfo;

            this.modal = vi.modal;

            this.modeless = vi.modeless;

            this.notclosable = vi.notclosable;

            if (vi.width!=-1)

                    this.width = vi.width;

            if (vi.height!=-1)

                    this.height = vi.height;

            this.x = vi.x;

            this.y = vi.y;

            this.visible = vi.visible;

            this.title = vi.title;

            this.id = vi.id;

            if (vi.normalHeight!=-1)

                    this.normalHeight = vi.normalHeight;

            if (vi.normalWidth!=-1)

                    this.normalWidth = vi.normalWidth;

            this.normalX = vi.normalX;

            this.normalY = vi.normalY;

            this.isClosed = vi.isClosed;

            this.persistWindow = vi.persistWindow;

    }

    /**

     * Sets whether the window is in palette mode or is in docked mode.

     * This method <b>does not</b> update the window status, it just

     * updates the WindowInfo object. Use the IWindowTransform interface

     * to actually change the window status.

     *

     * @param b

     */

    public void toPalette(boolean b){

            this.palette=b;

    }

    /**

     * Gets the list of selected tools for this window.

     *

     * @return A HashMap containing pairs (group, actionCommand), which

     * are the selected tools for this window.

     */

    @SuppressWarnings("rawtypes")

        public Map getSelectedTools() {

        return selectedTools;

    }

    /**

     * Use {@link setSelectedTools(HashMap selectedTool)}

     *

     * @param selectedTool

     * @deprecated

     */

    @SuppressWarnings("unchecked")

        public void setSelectedTool(String selectedTool) {

        if (selectedTool != null)

            selectedTools.put(defaultGroup ,selectedTool);

    }

    /**

     * Sets the list of selected tools for this window.

     * @param selectedTools  A HashMap containing pairs

     * (group, actionCommand), which will be set as the selected tools

     * for this window.

     */

    @SuppressWarnings("rawtypes")

        public void setSelectedTools(Map selectedTools) {

        if (selectedTools != null)

            this.selectedTools = selectedTools;

    }

    /** Finds out whether a view is open (showing) or closed */

    public boolean isClosed() {

            return isClosed;

    }

    /** Specifies whether a view is open (showing) or closed */

    public void setClosed(boolean closed) {

            support.firePropertyChange("closed", this.isClosed, closed);

            this.isClosed = closed;

    }

    /**

     * Updates the closed property for this WindowInfo

     * object. It doesn't get reflected on the window (use

     * <code>setClosed</code> for that).

     *

     * @param closed The new closed property for this WindowInfo object

     */

    public void updateClosed(boolean closed) {

            this.isClosed = closed;

    }

    /**

     * Sets the normalX property for this WindowInfo object. This sets the X

     * position that the window would have when it gets restored from the

     * maximized state.

     *

     * @param normalX The new normalX property for this WindowInfo object

     */

    public void setNormalX(int normalX) {

            if (!isMaximized()) {

                    setX(normalX);

            }

            else {

                    support.firePropertyChange("normalX", this.normalX, normalX);

                    this.normalX = normalX;

            }

    }

    /**

     * Updates the normalX property for this WindowInfo

     * object. It doesn't get reflected on the window (use

     * <code>setNormalX</code> for that).

     *

     * @param normalX The new normalX property for this WindowInfo object

     */

    public void updateNormalX(int normalX) {

            this.normalX = normalX;

            if (!isMaximized())

                    x = normalX;

    }

    /**

     * Sets the normalY property for this WindowInfo object. This sets the Y

     * position that the window would have when it gets restored from the

     * maximized state.

     *

     * @param normalY The new normalY property for this WindowInfo object

     */

    public void setNormalY(int normalY) {

            if (!isMaximized()) {

                    setY(normalY);

            }

            else {

                    support.firePropertyChange("normalY", this.normalY, normalY);

                    this.normalY = normalY;

            }

    }

    /**

     * Updates the normalY property for this WindowInfo

     * object. It doesn't get reflected on the window (use

     * <code>setNormalY</code> for that).

     *

     * @param normalY The new normalY property for this WindowInfo object

     */

    public void updateNormalY(int normalY) {

            this.normalY = normalY;

            if (!isMaximized())

                    y = normalY;

    }

    /**

     * Sets the normalHeight property for this WindowInfo object. This sets the height

     * position that the window would have when it gets restored from the

     * maximized state.

     *

     * @param normalY The new normalHeight property for this WindowInfo object

     */

    public void setNormalHeight(int normalHeight) {

            if (!isMaximized) {

                    setHeight(normalHeight);

            }

            else {

                    support.firePropertyChange("normalHeight", this.normalHeight, normalHeight);

                    this.normalHeight = normalHeight;

            }

    }

    /**

     * Updates the normalHeight property for this WindowInfo

     * object. It doesn't get reflected on the window (use

     * <code>setNormalHeight</code> for that).

     *

     * @param normalHeight The new normalHeight property for this WindowInfo object

     */

    public void updateNormalHeight(int normalHeight) {

            this.normalHeight = normalHeight;

            if (!isMaximized) {

                    this.height = normalHeight;

            }

    }

    /**

     * Sets the normalWidth property for this WindowInfo object. This sets the width

     * position that the window would have when it gets restored from the

     * maximized state.

     *

     * @param normalY The new normalWidth property for this WindowInfo object

     */

    public void setNormalWidth(int normalWidth) {

            if (!isMaximized()) {

                    setWidth(normalWidth);

            }

            else {

                    support.firePropertyChange("normalWidth", this.normalWidth, normalWidth);

                    this.normalWidth = normalWidth;

            }

    }

    /**

     * Sets the minimum allowed size for the associated window. If null is provided,

     * the minimum size is disabled (and thus

     * the window can be resized to any size).

     *

     * @param minSize The minimum allowed size for the associated window.

     */

    public void setMinimumSize(Dimension minSize) {

            support.firePropertyChange("minimumSize", this.minSize, minSize);

            this.minSize = minSize;

    }

    /**

     * Updates the minimum allowed size for the associated window. It doesn't

     * get reflected on the window (use <code>setMinimumSize</code> for that).

     *

     * @param minSize The minimum allowed size for the associated window.

     */

    public void updateMinimumSize(Dimension minSize) {

            this.minSize = minSize;

    }

    /**

     * Gets the minimum allowed size for the associated window.

     *

     * @return minSize The minimum allowed size for the associated window.

     */

    public Dimension getMinimumSize() {

            return minSize;

    }

    /**

     * Updates the normalWidth property for this WindowInfo

     * object. It doesn't get reflected on the window (use

     * <code>setNormalWidth</code> for that).

     *

     * @param normalWidth The new normalHeight property for this WindowInfo object

     */

    public void updateNormalWidth(int normalWidth) {

            this.normalWidth = normalWidth;

            if (!isMaximized())

                    this.width = normalWidth;

    }

    /**

     * Maximize the associated window

     *

     * @param maximized

     */

    public void setMaximized(boolean maximized) {

            support.firePropertyChange("maximized", this.isMaximized, maximized);

            this.isMaximized = maximized;

    }

    /**

     * Updates the maximized property for this WindowInfo

     * object. It doesn't get reflected on the window (use

     * <code>setMaximized</code> for that).

     *

     * @param maximized The new maximized property for this WindowInfo object

     */

    public void updateMaximized(boolean maximized) {

            this.isMaximized = maximized;

    }

    public void setMaximizable(boolean maximizable) {

            this.maximizable = maximizable;

    }

    /**

     * Sets the bounds of the associated window.

     *

     * @param x

     * @param y

     * @param width

     * @param height

     */

    private void setBounds(int x, int y, int width, int height) {

            setX(x);

            setY(y);

            setWidth(width);

            setHeight(height);

    }

    /**

     * Updates the bounds for this WindowInfo object. It doesn't get reflected

     * on the window (use <code>setBounds</code> for that).

     *

     * @param x

     * @param y

     * @param width

     * @param height

     */

    public void updateBounds(int x, int y, int width, int height) {

            this.x = x;

            this.y = y;

            this.width = width;

            this.height = height;

            if (!isMaximized()) {

                    this.normalX = x;

                    this.normalY = y;

                    this.normalWidth = width;

                    this.normalHeight = height;

            }

    }

    /**

     * Sets the normal bounds of the associated window. This sets the bounds

     * that the window would have when it gets restored from the

     * maximized state.

     *

     * @param x

     * @param y

     * @param width

     * @param height

     */

    public void setNormalBounds(int x, int y, int width, int height) {

            setNormalX(x);

            setNormalY(y);

            setNormalWidth(width);

            setNormalHeight(height);

    }

    /**

     * Updates the normal bounds for this WindowInfo object. It doesn't get

     * reflected on the window (use <code>setNormalBounds</code> for that).

     *

     * @param x

     * @param y

     * @param width

     * @param height

     */

    public void updateNormalBounds(int x, int y, int width, int height) {

                this.normalX = x;

                this.normalY = y;

                this.normalWidth = width;

                this.normalHeight = height;

            if (!isMaximized()) {

                this.x = x;

                this.y = y;

                this.width = width;

                this.height = height;

            }

    }

    /**

     * Gets the normal bounds of the associated window. This gets the bounds

     * that the window would have when it gets restored from the

     * maximized state.

     *

     * @return The normal bounds of the associated window.

     */

    public Rectangle getNormalBounds() {

            return new Rectangle(getNormalX(), getNormalY(), getNormalWidth(), getNormalHeight());

    }

    /**

     * Sets the normal bounds of the associated window. This sets the bounds

     * that the window would have when it gets restored from the

     * maximized state.

     *

     * @param normalBounds

     */

    public void setNormalBounds(Rectangle normalBounds) {

            setNormalBounds(normalBounds.x, normalBounds.y, normalBounds.width, normalBounds.height);

    }

    /**

     * Updates the normal bounds for this WindowInfo object. It doesn't get

     * reflected on the window (use <code>setNormalBounds</code> for that).

     *

     * @param normalBounds

     */

    public void updateNormalBounds(Rectangle normalBounds) {