/*******************************************************************************

 * Copyright (c) 2000, 2007 IBM Corporation and others.

 * Portion Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).

 * 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

 *

 * Contributors:

 *     IBM Corporation - initial API and implementation

 *     Nokia Corporation - Qt implementation

 *******************************************************************************/

package org.eclipse.swt.widgets;

import java.util.Vector;

import org.eclipse.swt.SWT;

import org.eclipse.swt.events.ShellListener;

import org.eclipse.swt.graphics.Point;

import org.eclipse.swt.graphics.Rectangle;

import org.eclipse.swt.internal.qt.OS;

import org.eclipse.swt.internal.qt.SymbianWindowVisibilityListener;

import org.eclipse.swt.internal.qt.WidgetState;

import org.eclipse.swt.internal.qt.graphics.WindowSurface;

/**

 * Instances of this class represent the "windows"

 * which the desktop or "window manager" is managing.

 * Instances that do not have a parent (that is, they

 * are built using the constructor, which takes a 

 * <code>Display</code> as the argument) are described

 * as <em>top level</em> shells. Instances that do have

 * a parent are described as <em>secondary</em> or

 * <em>dialog</em> shells.

 * <p>

 * Instances are always displayed in one of the maximized, 

 * minimized or normal states:

 * <ul>

 * <li>

 * When an instance is marked as <em>maximized</em>, the

 * window manager will typically resize it to fill the

 * entire visible area of the display, and the instance

 * is usually put in a state where it can not be resized 

 * (even if it has style <code>RESIZE</code>) until it is

 * no longer maximized.

 * </li><li>

 * When an instance is in the <em>normal</em> state (neither

 * maximized or minimized), its appearance is controlled by

 * the style constants which were specified when it was created

 * and the restrictions of the window manager (see below).

 * </li><li>

 * When an instance has been marked as <em>minimized</em>,

 * its contents (client area) will usually not be visible,

 * and depending on the window manager, it may be

 * "iconified" (that is, replaced on the desktop by a small

 * simplified representation of itself), relocated to a

 * distinguished area of the screen, or hidden. Combinations

 * of these changes are also possible.

 * </li>

 * </ul>

 * </p><p>

 * The <em>modality</em> of an instance may be specified using

 * style bits. The modality style bits are used to determine

 * whether input is blocked for other shells on the display.

 * The <code>PRIMARY_MODAL</code> style allows an instance to block

 * input to its parent. The <code>APPLICATION_MODAL</code> style

 * allows an instance to block input to every other shell in the

 * display. The <code>SYSTEM_MODAL</code> style allows an instance

 * to block input to all shells, including shells belonging to

 * different applications.

 * </p><p>

 * Note: The styles supported by this class are treated

 * as <em>HINT</em>s, since the window manager for the

 * desktop on which the instance is visible has ultimate

 * control over the appearance and behavior of decorations

 * and modality. For example, some window managers only

 * support resizable windows and will always assume the

 * RESIZE style, even if it is not set. In addition, if a

 * modality style is not supported, it is "upgraded" to a

 * more restrictive modality style that is supported. For

 * example, if <code>PRIMARY_MODAL</code> is not supported,

 * it would be upgraded to <code>APPLICATION_MODAL</code>.

 * A modality style may also be "downgraded" to a less

 * restrictive style. For example, most operating systems

 * no longer support <code>SYSTEM_MODAL</code> because

 * it can freeze up the desktop, so this is typically

 * downgraded to <code>APPLICATION_MODAL</code>.

 * <dl>

 * <dt><b>Styles:</b></dt>

 * <dd>BORDER, CLOSE, MIN, MAX, NO_TRIM, RESIZE, TITLE, ON_TOP, TOOL</dd>

 * <dd>APPLICATION_MODAL, MODELESS, PRIMARY_MODAL, SYSTEM_MODAL</dd>

 * <dt><b>Events:</b></dt>

 * <dd>Activate, Close, Deactivate, Deiconify, Iconify</dd>

 * </dl>

 * Class <code>SWT</code> provides two "convenience constants"

 * for the most commonly required style combinations:

 * <dl>

 * <dt><code>SHELL_TRIM</code></dt>

 * <dd>

 * the result of combining the constants which are required

 * to produce a typical application top level shell: (that 

 * is, <code>CLOSE | TITLE | MIN | MAX | RESIZE</code>)

 * </dd>

 * <dt><code>DIALOG_TRIM</code></dt>

 * <dd>

 * the result of combining the constants which are required

 * to produce a typical application dialog shell: (that 

 * is, <code>TITLE | CLOSE | BORDER</code>)

 * </dd>

 * </dl>

 * </p>

 * <p>

 * Note: Only one of the styles APPLICATION_MODAL, MODELESS, 

 * PRIMARY_MODAL and SYSTEM_MODAL may be specified.

 * </p><p>

 * IMPORTANT: This class is not intended to be subclassed.

 * </p>

 *

 * @see Decorations

 * @see SWT

 */

public class Shell extends Decorations {

/**

 * Handle of the QMainWindow for a top-level Shell.

 * For non top-level Shells this handle is zero.

 */

int mainWindowHandle;

/**

 * Handle of the QWidget that owns the window for a dialog Shell. For non-dialog

 * Shells this handle is zero.

 */

int dialogWindowHandle;

Rectangle defBounds;

Point oldSize;

/**

 * The WindowSurface wrapper for top level shells. Window surface

 * provides access for Qt created draw surface.

 */

WindowSurface windowSurface;

/**

 * When QMainWindow/QDialog visibility is changed, Qt may send a resize event.

 * eSWT application may have a Shell.setVisible() call in Shell's resize event

 * handler, which would cause an infinite loop. To prevent this suppress resize

 * events when Shell visibility is being changed.

 */

boolean suppressResizeEvent;

private Vector winVisibilityListeners = new Vector();

/**

 * Constructs a new instance of this class. This is equivalent

 * to calling <code>Shell((Display) null)</code>.

 *

 * @exception SWTException <ul>

 *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent</li>

 *    <li>ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass</li>

 * </ul>

 */

public Shell () {

    this ((Display) null);

}

/**

 * Constructs a new instance of this class given only the style

 * value describing its behavior and appearance. This is equivalent

 * to calling <code>Shell((Display) null, style)</code>.

 * <p>

 * The style value is either one of the style constants defined in

 * class <code>SWT</code> which is applicable to instances of this

 * class, or must be built by <em>bitwise OR</em>'ing together 

 * (that is, using the <code>int</code> "|" operator) two or more

 * of those <code>SWT</code> style constants. The class description

 * lists the style constants that are applicable to the class.

 * Style bits are also inherited from superclasses.

 * </p>

 *

 * @param style the style of control to construct

 *

 * @exception SWTException <ul>

 *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent</li>

 *    <li>ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass</li>

 * </ul>

 * 

 * @see SWT#BORDER

 * @see SWT#CLOSE

 * @see SWT#MIN

 * @see SWT#MAX

 * @see SWT#RESIZE

 * @see SWT#TITLE

 * @see SWT#NO_TRIM

 * @see SWT#SHELL_TRIM

 * @see SWT#DIALOG_TRIM

 * @see SWT#MODELESS

 * @see SWT#PRIMARY_MODAL

 * @see SWT#APPLICATION_MODAL

 * @see SWT#SYSTEM_MODAL

 */

public Shell (int style) {

    this ((Display) null, style);

}

/**

 * Constructs a new instance of this class given only the display

 * to create it on. It is created with style <code>SWT.SHELL_TRIM</code>.

 * <p>

 * Note: Currently, null can be passed in for the display argument.

 * This has the effect of creating the shell on the currently active

 * display if there is one. If there is no current display, the 

 * shell is created on a "default" display. <b>Passing in null as

 * the display argument is not considered to be good coding style,

 * and may not be supported in a future release of SWT.</b>

 * </p>

 *

 * @param display the display to create the shell on

 *

 * @exception SWTException <ul>

 *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent</li>

 *    <li>ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass</li>

 * </ul>

 */

public Shell (Display display) {

    this (display, SWT.SHELL_TRIM);

}

/**

 * Constructs a new instance of this class given the display

 * to create it on and a style value describing its behavior

 * and appearance.

 * <p>

 * The style value is either one of the style constants defined in

 * class <code>SWT</code> which is applicable to instances of this

 * class, or must be built by <em>bitwise OR</em>'ing together 

 * (that is, using the <code>int</code> "|" operator) two or more

 * of those <code>SWT</code> style constants. The class description

 * lists the style constants that are applicable to the class.

 * Style bits are also inherited from superclasses.

 * </p><p>

 * Note: Currently, null can be passed in for the display argument.

 * This has the effect of creating the shell on the currently active

 * display if there is one. If there is no current display, the 

 * shell is created on a "default" display. <b>Passing in null as

 * the display argument is not considered to be good coding style,

 * and may not be supported in a future release of SWT.</b>

 * </p>

 *

 * @param display the display to create the shell on

 * @param style the style of control to construct

 *

 * @exception SWTException <ul>

 *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent</li>

 *    <li>ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass</li>

 * </ul>

 * 

 * @see SWT#BORDER

 * @see SWT#CLOSE

 * @see SWT#MIN

 * @see SWT#MAX

 * @see SWT#RESIZE

 * @see SWT#TITLE

 * @see SWT#NO_TRIM

 * @see SWT#SHELL_TRIM

 * @see SWT#DIALOG_TRIM

 * @see SWT#MODELESS

 * @see SWT#PRIMARY_MODAL

 * @see SWT#APPLICATION_MODAL

 * @see SWT#SYSTEM_MODAL

 */

public Shell (Display display, int style) {

    this (display, null, style, null);

}

/**

 * <p>

 * <b>IMPORTANT:</b> This constructor is <em>not</em> part of the SWT

 * public API. It should never be referenced from application code. 

 * </p>

 */

protected Shell (Display display, Shell parent, int style, Object packageProxy) {

    super ();

    checkSubclass ();

    setPackageProxy(packageProxy);

    if (display == null) display = Display.getCurrent ();

    if (display == null) display = Display.getDefault ();

    if (!display.isValidThread ()) {

        error (SWT.ERROR_THREAD_INVALID_ACCESS);

    }

    if (parent != null && parent.isDisposed ()) {

        error (SWT.ERROR_INVALID_ARGUMENT); 

    }

    this.style = checkStyle (style, parent);

    this.parent = parent;

    this.display = display;

    createWidget (0);

}

/**

 * Constructs a new instance of this class given only its

 * parent. It is created with style <code>SWT.DIALOG_TRIM</code>.

 * <p>

 * Note: Currently, null can be passed in for the parent.

 * This has the effect of creating the shell on the currently active

 * display if there is one. If there is no current display, the 

 * shell is created on a "default" display. <b>Passing in null as

 * the parent is not considered to be good coding style,

 * and may not be supported in a future release of SWT.</b>

 * </p>

 *

 * @param parent a shell which will be the parent of the new instance

 *

 * @exception IllegalArgumentException <ul>

 *    <li>ERROR_INVALID_ARGUMENT - if the parent is disposed</li> 

 * </ul>

 * @exception SWTException <ul>

 *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent</li>

 *    <li>ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass</li>

 * </ul>

 */

public Shell (Shell parent) {

    this (parent, SWT.DIALOG_TRIM);

}

/**

 * Constructs a new instance of this class given its parent

 * and a style value describing its behavior and appearance.

 * <p>

 * The style value is either one of the style constants defined in

 * class <code>SWT</code> which is applicable to instances of this

 * class, or must be built by <em>bitwise OR</em>'ing together 

 * (that is, using the <code>int</code> "|" operator) two or more

 * of those <code>SWT</code> style constants. The class description

 * lists the style constants that are applicable to the class.

 * Style bits are also inherited from superclasses.

 * </p><p>

 * Note: Currently, null can be passed in for the parent.

 * This has the effect of creating the shell on the currently active

 * display if there is one. If there is no current display, the 

 * shell is created on a "default" display. <b>Passing in null as

 * the parent is not considered to be good coding style,

 * and may not be supported in a future release of SWT.</b>

 * </p>

 *

 * @param parent a shell which will be the parent of the new instance

 * @param style the style of control to construct

 *

 * @exception IllegalArgumentException <ul>

 *    <li>ERROR_INVALID_ARGUMENT - if the parent is disposed</li> 

 * </ul>

 * @exception SWTException <ul>

 *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent</li>

 *    <li>ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass</li>

 * </ul>

 * 

 * @see SWT#BORDER

 * @see SWT#CLOSE

 * @see SWT#MIN

 * @see SWT#MAX

 * @see SWT#RESIZE

 * @see SWT#TITLE

 * @see SWT#NO_TRIM

 * @see SWT#SHELL_TRIM

 * @see SWT#DIALOG_TRIM

 * @see SWT#ON_TOP

 * @see SWT#MODELESS

 * @see SWT#PRIMARY_MODAL

 * @see SWT#APPLICATION_MODAL

 * @see SWT#SYSTEM_MODAL

 */

public Shell (Shell parent, int style) {

    this (parent != null ? parent.display : null, parent, style, null);

}

final static int checkStyle (int style, Composite parent) {

    style = Decorations.checkStyle (style, parent);

    style &= ~SWT.TRANSPARENT;

    if(OS.windowServer == OS.WS_SYMBIAN_S60) {

        // Set the RESIZE flag to prevent fixing the size so that the

        // always-maximized top-level Shell will be automatically resized

        // when available space changes. 

        if (parent == null) {

            style |= SWT.RESIZE;

        }

    }

    int mask = SWT.SYSTEM_MODAL | SWT.APPLICATION_MODAL | SWT.PRIMARY_MODAL;

    int bits = style & ~mask;

    if ((style & SWT.SYSTEM_MODAL) != 0) return bits | SWT.SYSTEM_MODAL;

    if ((style & SWT.APPLICATION_MODAL) != 0) return bits | SWT.APPLICATION_MODAL;

    if ((style & SWT.PRIMARY_MODAL) != 0) return bits | SWT.PRIMARY_MODAL;

    return bits;

}

/**

 * Adds the listener to the collection of listeners who will

 * be notified when operations are performed on the receiver,

 * by sending the listener one of the messages defined in the

 * <code>ShellListener</code> interface.

 *

 * @param listener the listener which should be notified

 *

 * @exception IllegalArgumentException <ul>

 *    <li>ERROR_NULL_ARGUMENT - if the listener is null</li>

 * </ul>

 * @exception SWTException <ul>

 *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>

 *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>

 * </ul>

 *

 * @see ShellListener

 * @see #removeShellListener

 */

public void addShellListener (ShellListener listener) {

    checkWidget();

    if (listener == null) error (SWT.ERROR_NULL_ARGUMENT);

    TypedListener typedListener = new TypedListener (listener);

    addListener (SWT.Close,typedListener);

    addListener (SWT.Iconify,typedListener);

    addListener (SWT.Deiconify,typedListener);

    addListener (SWT.Activate, typedListener);

    addListener (SWT.Deactivate, typedListener);

}

/**

 * Requests that the window manager close the receiver in

 * the same way it would be closed when the user clicks on

 * the "close box" or performs some other platform specific

 * key or mouse combination that indicates the window

 * should be removed.

 *

 * @exception SWTException <ul>

 *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>

 *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>

 * </ul>

 *

 * @see SWT#Close

 * @see #dispose

 */

public void close () {

    checkWidget ();

    closeWidget ();

}

public Point computeSize (int wHint, int hHint, boolean changed) {

    // On Symbian the top-level Shells are always maximized. 

    // They have no trim. No need to compute anything. Just return the size. 

    if(OS.windowServer == OS.WS_SYMBIAN_S60 && parent == null) {

        return OS.QWidget_size(topHandle);

    }

    Point size = super.computeSize(wHint, hHint, changed);

    if(OS.windowServer == OS.WS_X11) {

        if((style & SWT.RESIZE) != 0) {

            // Resizeable windows won't go smaller than this

            if(size.x < 81) size.x = 81;

            if(size.y < 100) size.y = 100;

        } else if(willBeDecorated()) {

            // Windows won't go smaller than their trim

            size.x = Math.max(size.x, windowFrameTrim() * 2);

            size.y = Math.max(size.y, windowFrameTrim() * 2);

        }

    }

    return size;

}

/*

 * On non-Symbian platform the Shell size is initially set to some nice

 * looking default. On Symbian platform Qt implements automatic resizing for

 * maximized widgets. Thus, top-level Shells are always maximized and it's

 * prevented from the application to set their size freely. 

 */

Point setInitialSize () {

    Rectangle area = display.getClientArea();

    if(OS.windowServer != OS.WS_SYMBIAN_S60) {

        area.width /= 3;

        area.height /= 3;

    }

    Point size =  computeSize(area.width, area.height, true);

    size.x -= windowFrameTrim() * 2;

    size.y -= windowTitleTrim() + windowFrameTrim();

    // These values will be returned if the size is queried before the Shell

    // is made visible (and they are not set again). 

    OS.QWidget_resize(topHandle, size.x, size.y);

    if(OS.windowServer == OS.WS_SYMBIAN_S60 && parent == null) {

        setRestoreState(OS.QT_WINDOWMAXIMIZED, false);

    }

    return size;

}

public Rectangle computeTrim (int x, int y, int width, int height) {

    checkWidget();

    Rectangle scrollableTrim = super.computeTrim (x, y, width, height);

    // Normally window frame is learned on setVisible(true). If it has not been

    // called then try to learn the window trim dimensions here. 

    learnTrim();

    int leftTrim, rightTrim, topTrim, bottomTrim;

    leftTrim = rightTrim = bottomTrim = windowFrameTrim();

    topTrim = windowTitleTrim();

    scrollableTrim.x -= leftTrim;

    scrollableTrim.width += (leftTrim + rightTrim);

    scrollableTrim.y -= topTrim;

    scrollableTrim.height += (topTrim + bottomTrim);