/****************************************************************************
**
** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation (qt-info@nokia.com)
**
** This file is part of the QtGui module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** No Commercial Usage
** This file contains pre-release code and may not be distributed.
** You may use this file in accordance with the terms and conditions
** contained in the Technology Preview License Agreement accompanying
** this package.
**
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file. Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Nokia gives you certain additional
** rights. These rights are described in the Nokia Qt LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
** If you have questions regarding the use of this file, please contact
** Nokia at qt-info@nokia.com.
**
**
**
**
**
**
**
**
** $QT_END_LICENSE$
**
****************************************************************************/
#ifndef QMDIAREA_P_H
#define QMDIAREA_P_H
//
// W A R N I N G
// -------------
//
// This file is not part of the Qt API. It exists purely as an
// implementation detail. This header file may change from version to
// version without notice, or even be removed.
//
// We mean it.
//
#include "qmdiarea.h"
#include "qmdisubwindow.h"
#ifndef QT_NO_MDIAREA
#include <QList>
#include <QRect>
#include <QPoint>
#include <QtGui/qapplication.h>
#include <private/qmdisubwindow_p.h>
#include <private/qabstractscrollarea_p.h>
QT_BEGIN_NAMESPACE
namespace QMdi {
class Rearranger
{
public:
enum Type {
RegularTiler,
SimpleCascader,
IconTiler
};
// Rearranges widgets relative to domain.
virtual void rearrange(QList<QWidget *> &widgets, const QRect &domain) const = 0;
virtual Type type() const = 0;
virtual ~Rearranger() {}
};
class RegularTiler : public Rearranger
{
// Rearranges widgets according to a regular tiling pattern
// covering the entire domain.
// Both positions and sizes may change.
void rearrange(QList<QWidget *> &widgets, const QRect &domain) const;
inline Type type() const { return Rearranger::RegularTiler; }
};
class SimpleCascader : public Rearranger
{
// Rearranges widgets according to a simple, regular cascading pattern.
// Widgets are resized to minimumSize.
// Both positions and sizes may change.
void rearrange(QList<QWidget *> &widgets, const QRect &domain) const;
inline Type type() const { return Rearranger::SimpleCascader; }
};
class IconTiler : public Rearranger
{
// Rearranges icons (assumed to be the same size) according to a regular
// tiling pattern filling up the domain from the bottom.
// Only positions may change.
void rearrange(QList<QWidget *> &widgets, const QRect &domain) const;
inline Type type() const { return Rearranger::IconTiler; }
};
class Placer
{
public:
// Places the rectangle defined by 'size' relative to 'rects' and 'domain'.
// Returns the position of the resulting rectangle.
virtual QPoint place(
const QSize &size, const QList<QRect> &rects, const QRect &domain) const = 0;
virtual ~Placer() {}
};
class MinOverlapPlacer : public Placer
{
QPoint place(const QSize &size, const QList<QRect> &rects, const QRect &domain) const;
static int accumulatedOverlap(const QRect &source, const QList<QRect> &rects);
static QRect findMinOverlapRect(const QList<QRect> &source, const QList<QRect> &rects);
static void getCandidatePlacements(
const QSize &size, const QList<QRect> &rects, const QRect &domain,
QList<QRect> &candidates);
static QPoint findBestPlacement(
const QRect &domain, const QList<QRect> &rects, QList<QRect> &source);
static void findNonInsiders(
const QRect &domain, QList<QRect> &source, QList<QRect> &result);
static void findMaxOverlappers(
const QRect &domain, const QList<QRect> &source, QList<QRect> &result);
};
} // namespace QMdi
class QMdiAreaTabBar;
class QMdiAreaPrivate : public QAbstractScrollAreaPrivate
{
Q_DECLARE_PUBLIC(QMdiArea)
public:
QMdiAreaPrivate();
// Variables.
QMdi::Rearranger *cascader;
QMdi::Rearranger *regularTiler;
QMdi::Rearranger *iconTiler;
QMdi::Placer *placer;
#ifndef QT_NO_RUBBERBAND
QRubberBand *rubberBand;
#endif
QMdiAreaTabBar *tabBar;
QList<QMdi::Rearranger *> pendingRearrangements;
QList< QPointer<QMdiSubWindow> > pendingPlacements;
QList< QPointer<QMdiSubWindow> > childWindows;
QList<int> indicesToActivatedChildren;
QPointer<QMdiSubWindow> active;
QPointer<QMdiSubWindow> aboutToBecomeActive;
QBrush background;
QMdiArea::WindowOrder activationOrder;
QMdiArea::AreaOptions options;
QMdiArea::ViewMode viewMode;
#ifndef QT_NO_TABBAR
bool documentMode;
#endif
#ifndef QT_NO_TABWIDGET
QTabWidget::TabShape tabShape;
QTabWidget::TabPosition tabPosition;
#endif
bool ignoreGeometryChange;
bool ignoreWindowStateChange;
bool isActivated;
bool isSubWindowsTiled;
bool showActiveWindowMaximized;
bool tileCalledFromResizeEvent;
bool updatesDisabledByUs;
bool inViewModeChange;
int indexToNextWindow;
int indexToPreviousWindow;
int indexToHighlighted;
int indexToLastActiveTab;
int resizeTimerId;
int tabToPreviousTimerId;
// Slots.
void _q_deactivateAllWindows(QMdiSubWindow *aboutToActivate = 0);
void _q_processWindowStateChanged(Qt::WindowStates oldState, Qt::WindowStates newState);
void _q_currentTabChanged(int index);
// Functions.
void appendChild(QMdiSubWindow *child);
void place(QMdi::Placer *placer, QMdiSubWindow *child);
void rearrange(QMdi::Rearranger *rearranger);
void arrangeMinimizedSubWindows();
void activateWindow(QMdiSubWindow *child);
void activateCurrentWindow();
void activateHighlightedWindow();
void emitWindowActivated(QMdiSubWindow *child);
void resetActiveWindow(QMdiSubWindow *child = 0);
void updateActiveWindow(int removedIndex, bool activeRemoved);
void updateScrollBars();
void internalRaise(QMdiSubWindow *child) const;
bool scrollBarsEnabled() const;
bool lastWindowAboutToBeDestroyed() const;
void setChildActivationEnabled(bool enable = true, bool onlyNextActivationEvent = false) const;
QRect resizeToMinimumTileSize(const QSize &minSubWindowSize, int subWindowCount);
void scrollBarPolicyChanged(Qt::Orientation, Qt::ScrollBarPolicy); // reimp
QMdiSubWindow *nextVisibleSubWindow(int increaseFactor, QMdiArea::WindowOrder,
int removed = -1, int fromIndex = -1) const;
void highlightNextSubWindow(int increaseFactor);
QList<QMdiSubWindow *> subWindowList(QMdiArea::WindowOrder, bool reversed = false) const;
void disconnectSubWindow(QObject *subWindow);
void setViewMode(QMdiArea::ViewMode mode);
#ifndef QT_NO_TABBAR
void updateTabBarGeometry();
void refreshTabBar();
#endif
inline void startResizeTimer()
{
Q_Q(QMdiArea);
if (resizeTimerId > 0)
q->killTimer(resizeTimerId);
resizeTimerId = q->startTimer(200);
}
inline void startTabToPreviousTimer()
{
Q_Q(QMdiArea);
if (tabToPreviousTimerId > 0)
q->killTimer(tabToPreviousTimerId);
tabToPreviousTimerId = q->startTimer(QApplication::keyboardInputInterval());
}
inline bool windowStaysOnTop(QMdiSubWindow *subWindow) const
{
if (!subWindow)
return false;
return subWindow->windowFlags() & Qt::WindowStaysOnTopHint;
}
inline bool isExplicitlyDeactivated(QMdiSubWindow *subWindow) const
{
if (!subWindow)
return true;
return subWindow->d_func()->isExplicitlyDeactivated;
}
inline void setActive(QMdiSubWindow *subWindow, bool active = true, bool changeFocus = true) const
{
if (subWindow)
subWindow->d_func()->setActive(active, changeFocus);
}
#ifndef QT_NO_RUBBERBAND
inline void showRubberBandFor(QMdiSubWindow *subWindow)
{
if (!subWindow || !rubberBand)
return;
rubberBand->setGeometry(subWindow->geometry());
rubberBand->raise();
rubberBand->show();
}
inline void hideRubberBand()
{
if (rubberBand && rubberBand->isVisible())
rubberBand->hide();
indexToHighlighted = -1;
}
#endif // QT_NO_RUBBERBAND
};
#endif // QT_NO_MDIAREA
QT_END_NAMESPACE
#endif // QMDIAREA_P_H