Application: gvSIG desktop

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

 *

 * Copyright (C) 2004 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 com.iver.andami.ui.mdiManager;

import java.awt.Dimension;

import java.awt.Rectangle;

import java.beans.PropertyChangeListener;

import java.beans.PropertyChangeSupport;

import org.exolab.castor.xml.XMLException;

import com.iver.andami.PluginServices;

import com.iver.utiles.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 inmediately 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 {

    /** 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 (doesn't block any other window) */

    public static final int MODELESSDIALOG = 16;

    /** Specifies that the window is semimodal */

    public static final int PALETTE = 32;

    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;

    /**

     * 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;

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

    private int width = -1;

    private int height = -1;

    private int x = 0;

    private int y = 0;

    /**

     * 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.

     */

    private String selectedTool;

    /**

     * DOCUMENT ME!

     *

     * @param listener

     */

    public void addPropertyChangeListener(PropertyChangeListener listener) {

        support.addPropertyChangeListener(listener);

    }

    /**

     * DOCUMENT ME!

     *

     * @param listener

     */

    public void removePropertyChangeListener(PropertyChangeListener listener) {

        support.removePropertyChangeListener(listener);

    }

    /**

     * Establece las propiedades de la vista

     *

     * @param code Bit-or de las propiedades de la vista

     *

     * @throws IllegalStateException DOCUMENT ME!

     */

    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;

        if (modal && modeless) {

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

        }

    }

    public WindowInfo(){

    }

    /**

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

     *

     * @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.

     *

     * @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 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 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;

    }

    /**

     * Si es iconificable

     *

     * @return

     */

    public boolean isIconifiable() {

        return iconifiable;

    }

    /**

     * Si es maximizable

     *

     * @return

     */

    public boolean isMaximizable() {

        return maximizable;

    }

    /**

     * Si es resizable

     *

     * @return

     */

    public boolean isResizable() {

        return resizable;

    }

    /**

     * Devuelve si el di?logo es modal

     *

     * @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;

    }

    /**

     * DOCUMENT ME!

     *

     * @return

     */

    public boolean isModeless() {

        return modeless;

    }

    /**

     * DOCUMENT ME!

     *

     * @return

     */

    public boolean isVisible() {

        return visible;

    }

    public boolean isPalette()

    {

        return palette;

    }

    public void setId(int id){

            this.id = id;

    }

    public int getId(){

            return id;

    }

    public void setWindowInfo(WindowInfo vi){

            this.resizable = vi.resizable;

            this.maximizable = vi.maximizable;

            this.isMaximized = vi.isMaximized;

            this.iconifiable = vi.iconifiable;

            this.modal = vi.modal;

            this.modeless = vi.modeless;

            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;

    }

    public void toPalette(boolean b){

            this.palette=b;

    }

    public String getSelectedTool() {

        return selectedTool;

    }

    public void setSelectedTool(String selectedTool) {

        if (selectedTool != null)

            this.selectedTool = selectedTool;

    }

    /** 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) {

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

    }

    /**

     * Sets the bounds of the associated window.

     * 

     * @param bounds

     */

    public void setBounds(Rectangle bounds) {

            setBounds(bounds.x, bounds.y, bounds.width, bounds.height);

    }

    /**

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

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

     * 

     * @param bounds

     */

    public void updateBounds(Rectangle bounds) {

            updateBounds(bounds.x, bounds.y, bounds.width, bounds.height);

    }

    /**

     * Gets the bounds of the associated window.

     * 

     * @return The bounds of the associated window.

     */

    public Rectangle getBounds() {

            return new Rectangle(x, y, width, height);

    }

    public int getNormalX() {

            if (normalX!=0)

                    return this.normalX;

            else

                    return x;

    }

    public int getNormalY() {

            if (normalY!=0)

                    return this.normalY;

            else

                    return y;

    }

    public int getNormalHeight() {

            if (normalHeight!=0)

                    return this.normalHeight;

            else

                    return height;

    }

    public int getNormalWidth() {

            if (normalWidth!=0)

                    return this.normalWidth;

            else

                    return width;

    }

    public boolean isMaximized() {

            return this.isMaximized;

    }

    /**

     * Checks if the geometry of this window should be persisted in the

     * project file. This is set by the persistWindow(boolean) method,

     * and the default value is true.

     *

     * @return True if the geometry of this window should be persisted

     * in the project files, false otherwise.

     */

    public boolean checkPersistence() {

            return this.persistWindow;

    }

    /**

     * Set whether the geometry of this window should be persisted in the

     * project files.

     *

     * @param persist

     */

    public void setPersistence(boolean persist) {

            this.persistWindow = persist;

    }

    /**

         * Gets the window properties in an XMLEntity object, suitable

         * for persistence.

         *

         * @return An XMLEntity object containing the window properties, or null if the window was set as

         * not persistent

     * @throws SaveException

         * @throws XMLException

         * @throws SaveException

         */

        public XMLEntity getXMLEntity() {

                XMLEntity xml = new XMLEntity();

                xml.setName("ViewInfoProperties");

                xml.putProperty("X", this.getX());

                xml.putProperty("Y", this.getY());

                xml.putProperty("Width", this.getWidth());

                xml.putProperty("Height", this.getHeight());

                xml.putProperty("isVisible", this.isVisible());

                xml.putProperty("isResizable", this.isResizable());

                xml.putProperty("isMaximizable", this.isMaximizable());

                xml.putProperty("isModal", this.isModal());

                xml.putProperty("isModeless", this.isModeless());

                xml.putProperty("isClosed", this.isClosed());

                if (this.isMaximized()==true) {

                        xml.putProperty("isMaximized", this.isMaximized());

                        xml.putProperty("normalX", this.getNormalX());

                        xml.putProperty("normalY", this.getNormalY());

                        xml.putProperty("normalWidth", this.getNormalWidth());

                        xml.putProperty("normalHeight", this.getNormalHeight());

                }

                return xml;

        }

        public static WindowInfo createFromXMLEntity(XMLEntity xml)

        {

                WindowInfo result = new WindowInfo();

                try {

                        result.setX(xml.getIntProperty("X"));

                        result.setY(xml.getIntProperty("Y"));

                        result.setHeight(xml.getIntProperty("Height"));

                        result.setWidth(xml.getIntProperty("Width"));

                        result.setClosed(xml.getBooleanProperty("isClosed"));

                        if (xml.contains("isMaximized")) {

                                boolean maximized = xml.getBooleanProperty("isMaximized");

                                result.setMaximized(maximized);

                                if (maximized==true) {

                                        result.setNormalBounds(xml.getIntProperty("normalX"), xml.getIntProperty("normalY"), xml.getIntProperty("normalWidth"), xml.getIntProperty("normalHeight"));

                                }

                                else {

                                        result.setNormalBounds(result.getBounds());

                                }

                        }

                }

                catch (com.iver.utiles.NotExistInXMLEntity ex) {

                        PluginServices.getLogger().warn(PluginServices.getText(null, "Window_properties_not_stored_correctly_Window_state_will_not_be_restored"));

                }

                return result;

        }

        public void getPropertiesFromXMLEntity(XMLEntity xml)

        {

                this.x = xml.getIntProperty("X");

                this.y = xml.getIntProperty("Y");

                this.height = xml.getIntProperty("Height");

                this.width = xml.getIntProperty("Width");

                this.isClosed = xml.getBooleanProperty("isClosed");

                if (xml.contains("isMaximized")) {

                        boolean maximized = xml.getBooleanProperty("isMaximized");

                        this.isMaximized = maximized;

                        if (maximized==true) {

                                this.setNormalBounds(xml.getIntProperty("normalX"), xml.getIntProperty("normalY"), xml.getIntProperty("normalWidth"), xml.getIntProperty("normalHeight"));

                        }

                }

        }

}