/*
� � � � � � � �=.            This file is part of the OPIE Project
� � � � � � �.=l.            Copyright (c)  2003 hOlgAr <zecke@handhelds.org>
� � � � � �.>+-=
�_;:, � � .> � �:=|.         This library is free software; you can
.> <`_, � > �. � <=          redistribute it and/or  modify it under
:`=1 )Y*s>-.-- � :           the terms of the GNU Library General Public
.="- .-=="i, � � .._         License as published by the Free Software
�- . � .-<_> � � .<>         Foundation; either version 2 of the License,
� � �._= =} � � � :          or (at your option) any later version.
� � .%`+i> � � � _;_.
� � .i_,=:_. � � �-<s.       This library 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
..}^=.= � � � = � � � ;      Library General Public License for more
++= � -. � � .` � � .:       details.
�: � � = �...= . :.=-
�-. � .:....=;==+<;          You should have received a copy of the GNU
� -_. . . � )=. �=           Library General Public License along with
� � -- � � � �:-=`           this library; see the file COPYING.LIB.
                             If not, write to the Free Software Foundation,
                             Inc., 59 Temple Place - Suite 330,
                             Boston, MA 02111-1307, USA.

*/

#ifndef OWIDGETSTACK_H
#define OWIDGETSTACK_H

/* QT*/
#include <qframe.h>
#include <qmap.h>

class QWidgetStack;

namespace Opie
{
/**
 *
 * OWidgetStack is the answer to the problem of using Opie at different screen
 * sizes and to have a different behaviour. Most applications use a QWidgetStack
 * to supply a view on click. And by clicking the (X) you go back but this
 * behaviour feels strange on bigger screens. It's ok on smaller one because
 * one can't determine the difference.
 * This stack reads the default out of the size of the desktop widget but
 * can be forced to have either the one or the other behaviour.
 * The first widget added is considered the 'main' widget and its
 * sizeHint will be taking if in BigScreen  mode.
 * In small screen mode this widget behaves exactly like a QWidgetStack and in BigScreen
 * mode it'll use the MainWindow as child of this widget and arranges the others as
 * hidden top level widgets.
 *
 * @version 0.1
 * @author hOlgAr F.
 * @short Either a true stack or a list of top Level widgets
 */
class OWidgetStack : public QFrame {
    Q_OBJECT
public:
    enum Mode { SmallScreen, BigScreen, NoForce };
    OWidgetStack( QWidget* parent, const char* name = 0, WFlags fl = 0 );
    ~OWidgetStack();

    enum Mode mode()const;
    void forceMode( enum Mode );

    void addWidget( QWidget* , int );
    void removeWidget( QWidget* );

//    QSizeHint sizeHint()const;
//    QSizeHint minimumSizeHint()const;

    QWidget *widget( int )const;
    int id( QWidget* )const;



    QWidget* visibleWidget() const;

    bool eventFilter( QObject*, QEvent* );
signals:
    /**
     * OWidgetStack monitors the Desktop Widget for
     * size changes if it recignizes a change size it'll
     * send a signal and adjust its mode. After the signal
     * was emitted. During the signal a call to mode() the
     * old mode will be returned. Note that if a size change happens
     * but no modeChange no signal will be emitted
     *
     *
     * @param mode The new mode of the desktop
     */
    void modeChanged( enum Mode mode);

    /**
     * These two signals are emitted whenever we're about to
     * show one of the widgets
     */
    void aboutToShow( QWidget* );
    void aboutToShow( int );

public slots:
    void raiseWidget( int );
    void raiseWidget( QWidget* );
    void hideWidget( int );
    void hideWidget( QWidget* );
    void setMainWindow( QWidget* );
    void setMainWindow( int );

protected:
    void resizeEvent( QResizeEvent* );

private:
    void switchStack();
    void switchTop();
    QMap<int, QWidget*> m_list;
    QWidgetStack *m_stack;
    QWidget *m_mWidget;
    QWidget *m_last;

    enum Mode m_mode;
    bool m_forced : 1;

    struct Private;
    Private *d;
};

};

#endif