DockManager.cpp

Go to the documentation of this file.

/*******************************************************************************
** Qt Advanced Docking System
** Copyright (C) 2017 Uwe Kindler
** 
** This library is free software; you can redistribute it and/or
** modify it under the terms of the GNU Lesser General Public
** License as published by the Free Software Foundation; either
** version 2.1 of the License, or (at your option) any later version.
** 
** 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
** Lesser General Public License for more details.
** 
** You should have received a copy of the GNU Lesser General Public
** License along with this library; If not, see <http://www.gnu.org/licenses/>.
******************************************************************************/
 
 
//============================================================================
//============================================================================
 
 
//============================================================================
//                                   INCLUDES
//============================================================================
#include "DockWidgetTab.h"
#include "DockManager.h"
 
#include <algorithm>
#include <iostream>
 
#include <QMainWindow>
#include <QList>
#include <QMap>
#include <QVariant>
#include <QDebug>
#include <QFile>
#include <QAction>
#include <QXmlStreamWriter>
#include <QSettings>
#include <QMenu>
#include <QApplication>
 
#include "FloatingDockContainer.h"
#include "DockOverlay.h"
#include "DockWidget.h"
#include "ads_globals.h"
#include "DockAreaWidget.h"
#include "IconProvider.h"
#include "DockingStateReader.h"
#include "DockAreaTitleBar.h"
#include "DockFocusController.h"
#include "DockSplitter.h"
 
#ifdef Q_OS_LINUX
#include "linux/FloatingWidgetTitleBar.h"
#endif
 
 
static void initResource()
{
        Q_INIT_RESOURCE(ads);
}
 
 
namespace ads
{
enum eStateFileVersion
{
        InitialVersion = 0,      
        Version1 = 1,            
        CurrentVersion = Version1
};
 
static CDockManager::ConfigFlags StaticConfigFlags = CDockManager::DefaultNonOpaqueConfig;
 
struct DockManagerPrivate
{
        CDockManager* _this;
        QList<CFloatingDockContainer*> FloatingWidgets;
        QList<CDockContainerWidget*> Containers;
        CDockOverlay* ContainerOverlay;
        CDockOverlay* DockAreaOverlay;
        QMap<QString, CDockWidget*> DockWidgetsMap;
        QMap<QString, QByteArray> Perspectives;
        QMap<QString, QMenu*> ViewMenuGroups;
        QMenu* ViewMenu;
        CDockManager::eViewMenuInsertionOrder MenuInsertionOrder = CDockManager::MenuAlphabeticallySorted;
        bool RestoringState = false;
        QVector<CFloatingDockContainer*> UninitializedFloatingWidgets;
        CDockFocusController* FocusController = nullptr;
    CDockWidget* CentralWidget = nullptr;
 
        DockManagerPrivate(CDockManager* _public);
 
        bool checkFormat(const QByteArray &state, int version);
 
        bool restoreStateFromXml(const QByteArray &state, int version, bool Testing = internal::Restore);
 
        bool restoreState(const QByteArray &state, int version);
 
        void restoreDockWidgetsOpenState();
        void restoreDockAreasIndices();
        void emitTopLevelEvents();
 
        void hideFloatingWidgets()
        {
                // Hide updates of floating widgets from user
                for (auto FloatingWidget : FloatingWidgets)
                {
                        FloatingWidget->hide();
                }
        }
 
        void markDockWidgetsDirty()
        {
                for (auto DockWidget : DockWidgetsMap)
                {
                        DockWidget->setProperty("dirty", true);
                }
        }
 
        bool restoreContainer(int Index, CDockingStateReader& stream, bool Testing);
 
        void loadStylesheet();
 
        void addActionToMenu(QAction* Action, QMenu* Menu, bool InsertSorted);
};
// struct DockManagerPrivate
 
//============================================================================
DockManagerPrivate::DockManagerPrivate(CDockManager* _public) :
        _this(_public)
{
 
}
 
 
//============================================================================
void DockManagerPrivate::loadStylesheet()
{
        initResource();
        QString Result;
        QString FileName = ":ads/stylesheets/";
        FileName += CDockManager::testConfigFlag(CDockManager::FocusHighlighting)
                ? "focus_highlighting" : "default";
#ifdef Q_OS_LINUX
    FileName += "_linux";
#endif
    FileName += ".css";
        QFile StyleSheetFile(FileName);
        StyleSheetFile.open(QIODevice::ReadOnly);
        QTextStream StyleSheetStream(&StyleSheetFile);
        Result = StyleSheetStream.readAll();
        StyleSheetFile.close();
  //_this->setStyleSheet(Result);
}
 
 
//============================================================================
bool DockManagerPrivate::restoreContainer(int Index, CDockingStateReader& stream, bool Testing)
{
        if (Testing)
        {
                Index = 0;
        }
 
        bool Result = false;
        if (Index >= Containers.count())
        {
                CFloatingDockContainer* FloatingWidget = new CFloatingDockContainer(_this);
                Result = FloatingWidget->restoreState(stream, Testing);
        }
        else
        {
        ADS_PRINT("d->Containers[i]->restoreState ");
                auto Container = Containers[Index];
                if (Container->isFloating())
                {
                        Result = Container->floatingWidget()->restoreState(stream, Testing);
                }
                else
                {
                        Result = Container->restoreState(stream, Testing);
                }
        }
 
        return Result;
}
 
 
//============================================================================
bool DockManagerPrivate::checkFormat(const QByteArray &state, int version)
{
    return restoreStateFromXml(state, version, internal::RestoreTesting);
}
 
 
//============================================================================
bool DockManagerPrivate::restoreStateFromXml(const QByteArray &state,  int version,
        bool Testing)
{
        Q_UNUSED(version);
 
    if (state.isEmpty())
    {
        return false;
    }
    CDockingStateReader s(state);
    s.readNextStartElement();
    if (s.name() != "QtAdvancedDockingSystem")
    {
        return false;
    }
    ADS_PRINT(s.attributes().value("Version"));
    bool ok;
    int v = s.attributes().value("Version").toInt(&ok);
    if (!ok || v > CurrentVersion)
    {
        return false;
    }
    s.setFileVersion(v);
 
    ADS_PRINT(s.attributes().value("UserVersion"));
    // Older files do not support UserVersion but we still want to load them so
    // we first test if the attribute exists
    if (!s.attributes().value("UserVersion").isEmpty())
    {
                v = s.attributes().value("UserVersion").toInt(&ok);
                if (!ok || v != version)
                {
                        return false;
                }
    }
 
    bool Result = true;
#ifdef ADS_DEBUG_PRINT
    int  DockContainers = s.attributes().value("Containers").toInt();
#endif
    ADS_PRINT(DockContainers);
 
    if (CentralWidget)
    {
                const auto CentralWidgetAttribute = s.attributes().value("CentralWidget");
                // If we have a central widget but a state without central widget, then
                // something is wrong.
                if (CentralWidgetAttribute.isEmpty())
                {
                        qWarning() << "Dock manager has central widget but saved state does not have central widget.";
                        return false;
                }
 
                // If the object name of the central widget does not match the name of the
                // saved central widget, the something is wrong
                if (CentralWidget->objectName() != CentralWidgetAttribute.toString())
                {
                        qWarning() << "Object name of central widget does not match name of central widget in saved state.";
                        return false;
                }
    }
 
    int DockContainerCount = 0;
    while (s.readNextStartElement())
    {
        if (s.name() == "Container")
        {
                Result = restoreContainer(DockContainerCount, s, Testing);
                        if (!Result)
                        {
                                break;
                        }
                        DockContainerCount++;
        }
    }
 
    if (!Testing)
    {
                // Delete remaining empty floating widgets
                int FloatingWidgetIndex = DockContainerCount - 1;
                for (int i = FloatingWidgetIndex; i < FloatingWidgets.count(); ++i)
                {
                        auto* floatingWidget = FloatingWidgets[i];
                        _this->removeDockContainer(floatingWidget->dockContainer());
                        floatingWidget->deleteLater();
                }
    }
 
    return Result;
}
 
 
//============================================================================
void DockManagerPrivate::restoreDockWidgetsOpenState()
{
    // All dock widgets, that have not been processed in the restore state
    // function are invisible to the user now and have no assigned dock area
    // They do not belong to any dock container, until the user toggles the
    // toggle view action the next time
    for (auto DockWidget : DockWidgetsMap)
    {
        if (DockWidget->property(internal::DirtyProperty).toBool())
        {
                DockWidget->flagAsUnassigned();
            emit DockWidget->viewToggled(false);
        }
        else
        {
                DockWidget->toggleViewInternal(!DockWidget->property(internal::ClosedProperty).toBool());
        }
    }
}
 
 
//============================================================================
void DockManagerPrivate::restoreDockAreasIndices()
{
    // Now all dock areas are properly restored and we setup the index of
    // The dock areas because the previous toggleView() action has changed
    // the dock area index
    int Count = 0;
    for (auto DockContainer : Containers)
    {
        Count++;
        for (int i = 0; i < DockContainer->dockAreaCount(); ++i)
        {
                CDockAreaWidget* DockArea = DockContainer->dockArea(i);
                QString DockWidgetName = DockArea->property("currentDockWidget").toString();
                CDockWidget* DockWidget = nullptr;
                if (!DockWidgetName.isEmpty())
                {
                        DockWidget = _this->findDockWidget(DockWidgetName);
                }
 
                if (!DockWidget || DockWidget->isClosed())
                {
                        int Index = DockArea->indexOfFirstOpenDockWidget();
                        if (Index < 0)
                        {
                                continue;
                        }
                        DockArea->setCurrentIndex(Index);
                }
                else
                {
                        DockArea->internalSetCurrentDockWidget(DockWidget);
                }
        }
    }
}
 
//============================================================================
void DockManagerPrivate::emitTopLevelEvents()
{
    // Finally we need to send the topLevelChanged() signals for all dock
    // widgets if top level changed
    for (auto DockContainer : Containers)
    {
        CDockWidget* TopLevelDockWidget = DockContainer->topLevelDockWidget();
        if (TopLevelDockWidget)
        {
                TopLevelDockWidget->emitTopLevelChanged(true);
        }
        else
        {
                        for (int i = 0; i < DockContainer->dockAreaCount(); ++i)
                        {
                                auto DockArea = DockContainer->dockArea(i);
                                for (auto DockWidget : DockArea->dockWidgets())
                                {
                                        DockWidget->emitTopLevelChanged(false);
                                }
                        }
        }
    }
}
 
 
//============================================================================
bool DockManagerPrivate::restoreState(const QByteArray& State, int version)
{
        QByteArray state = State.startsWith("<?xml") ? State : qUncompress(State);
    if (!checkFormat(state, version))
    {
        ADS_PRINT("checkFormat: Error checking format!!!!!!!");
        return false;
    }
 
    // Hide updates of floating widgets from use
    hideFloatingWidgets();
    markDockWidgetsDirty();
 
    if (!restoreStateFromXml(state, version))
    {
        ADS_PRINT("restoreState: Error restoring state!!!!!!!");
        return false;
    }
 
    restoreDockWidgetsOpenState();
    restoreDockAreasIndices();
    emitTopLevelEvents();
    _this->dumpLayout();
 
    return true;
}
 
 
//============================================================================
void DockManagerPrivate::addActionToMenu(QAction* Action, QMenu* Menu, bool InsertSorted)
{
        if (InsertSorted)
        {
                auto Actions = Menu->actions();
                auto it = std::find_if(Actions.begin(), Actions.end(),
                        [&Action](const QAction* a)
                        {
                                return a->text().compare(Action->text(), Qt::CaseInsensitive) > 0;
                        });
 
                if (it == Actions.end())
                {
                        Menu->addAction(Action);
                }
                else
                {
                        Menu->insertAction(*it, Action);
                }
        }
        else
        {
                Menu->addAction(Action);
        }
}
 
 
//============================================================================
CDockManager::CDockManager(QWidget *parent) :
        CDockContainerWidget(this, parent),
        d(new DockManagerPrivate(this))
{
        createRootSplitter();
        QMainWindow* MainWindow = qobject_cast<QMainWindow*>(parent);
        if (MainWindow)
        {
                MainWindow->setCentralWidget(this);
        }
 
        d->ViewMenu = new QMenu(tr("Show View"), this);
        d->DockAreaOverlay = new CDockOverlay(this, CDockOverlay::ModeDockAreaOverlay);
        d->ContainerOverlay = new CDockOverlay(this, CDockOverlay::ModeContainerOverlay);
        d->Containers.append(this);
        d->loadStylesheet();
 
        if (CDockManager::testConfigFlag(CDockManager::FocusHighlighting))
        {
                d->FocusController = new CDockFocusController(this);
        }
 
#ifdef Q_OS_LINUX
        window()->installEventFilter(this);
#endif
}
 
//============================================================================
CDockManager::~CDockManager()
{
        auto FloatingWidgets = d->FloatingWidgets;
        for (auto FloatingWidget : FloatingWidgets)
        {
                delete FloatingWidget;
        }
        delete d;
}
 
//============================================================================
#ifdef Q_OS_LINUX
bool CDockManager::eventFilter(QObject *obj, QEvent *e)
{
        // Emulate Qt:Tool behaviour.
        // Required because on some WMs Tool windows can't be maximized.
 
        // Window always on top of the MainWindow.
        if (e->type() == QEvent::WindowActivate)
        {
                for (auto _window : floatingWidgets())
                {
                        if (!_window->isVisible() || window()->isMinimized())
                        {
                                continue;
                        }
                        // setWindowFlags(Qt::WindowStaysOnTopHint) will hide the window and thus requires a show call.
                        // This then leads to flickering and a nasty endless loop (also buggy behaviour on Ubuntu).
                        // So we just do it ourself.
                        internal::xcb_update_prop(true, _window->window()->winId(),
                                "_NET_WM_STATE", "_NET_WM_STATE_ABOVE", "_NET_WM_STATE_STAYS_ON_TOP");
                }
        }
        else if (e->type() == QEvent::WindowDeactivate)
        {
                for (auto _window : floatingWidgets())
                {
                        if (!_window->isVisible() || window()->isMinimized())
                        {
                                continue;
                        }
                        internal::xcb_update_prop(false, _window->window()->winId(),
                                "_NET_WM_STATE", "_NET_WM_STATE_ABOVE", "_NET_WM_STATE_STAYS_ON_TOP");
                        _window->raise();
                }
        }
 
        // Sync minimize with MainWindow
        if (e->type() == QEvent::WindowStateChange)
        {
                for (auto _window : floatingWidgets())
                {
                        if (! _window->isVisible())
                        {
                                continue;
                        }
 
                        if (window()->isMinimized())
                        {
                                _window->showMinimized();
                        }
                        else
                        {
                                _window->setWindowState(_window->windowState() & (~Qt::WindowMinimized));
                        }
                }
                if (!window()->isMinimized())
                {
                        QApplication::setActiveWindow(window());
                }
        }
        return Super::eventFilter(obj, e);
}
#endif
 
//============================================================================
void CDockManager::registerFloatingWidget(CFloatingDockContainer* FloatingWidget)
{
        d->FloatingWidgets.append(FloatingWidget);
        emit floatingWidgetCreated(FloatingWidget);
    ADS_PRINT("d->FloatingWidgets.count() " << d->FloatingWidgets.count());
}
 
 
//============================================================================
void CDockManager::removeFloatingWidget(CFloatingDockContainer* FloatingWidget)
{
        d->FloatingWidgets.removeAll(FloatingWidget);
}
 
 
//============================================================================
void CDockManager::registerDockContainer(CDockContainerWidget* DockContainer)
{
        d->Containers.append(DockContainer);
}
 
 
//============================================================================
void CDockManager::removeDockContainer(CDockContainerWidget* DockContainer)
{
        if (this != DockContainer)
        {
                d->Containers.removeAll(DockContainer);
        }
}
 
 
//============================================================================
CDockOverlay* CDockManager::containerOverlay() const
{
        return d->ContainerOverlay;
}
 
 
//============================================================================
CDockOverlay* CDockManager::dockAreaOverlay() const
{
        return d->DockAreaOverlay;
}
 
 
//============================================================================
const QList<CDockContainerWidget*> CDockManager::dockContainers() const
{
        return d->Containers;
}
 
 
//============================================================================
const QList<CFloatingDockContainer*> CDockManager::floatingWidgets() const
{
        return d->FloatingWidgets;
}
 
 
//============================================================================
unsigned int CDockManager::zOrderIndex() const
{
        return 0;
}
 
 
//============================================================================
QByteArray CDockManager::saveState(int version) const
{
    QByteArray xmldata;
    QXmlStreamWriter s(&xmldata);
    auto ConfigFlags = CDockManager::configFlags();
        s.setAutoFormatting(ConfigFlags.testFlag(XmlAutoFormattingEnabled));
    s.writeStartDocument();
                s.writeStartElement("QtAdvancedDockingSystem");
                s.writeAttribute("Version", QString::number(CurrentVersion));
                s.writeAttribute("UserVersion", QString::number(version));
                s.writeAttribute("Containers", QString::number(d->Containers.count()));
                if (d->CentralWidget)
                {
                        s.writeAttribute("CentralWidget", d->CentralWidget->objectName());
                }
                for (auto Container : d->Containers)
                {
                        Container->saveState(s);
                }
 
                s.writeEndElement();
    s.writeEndDocument();
 
    return ConfigFlags.testFlag(XmlCompressionEnabled)
        ? qCompress(xmldata, 9) : xmldata;
}
 
 
//============================================================================
bool CDockManager::restoreState(const QByteArray &state, int version)
{
        // Prevent multiple calls as long as state is not restore. This may
        // happen, if QApplication::processEvents() is called somewhere
        if (d->RestoringState)
        {
                return false;
        }
 
        // We hide the complete dock manager here. Restoring the state means
        // that DockWidgets are removed from the DockArea internal stack layout
        // which in turn  means, that each time a widget is removed the stack
        // will show and raise the next available widget which in turn
        // triggers show events for the dock widgets. To avoid this we hide the
        // dock manager. Because there will be no processing of application
        // events until this function is finished, the user will not see this
        // hiding
        bool IsHidden = this->isHidden();
        if (!IsHidden)
        {
                hide();
        }
        d->RestoringState = true;
        emit restoringState();
        bool Result = d->restoreState(state, version);
        d->RestoringState = false;
        if (!IsHidden)
        {
                show();
        }
        emit stateRestored();
        return Result;
}
 
 
//============================================================================
CFloatingDockContainer* CDockManager::addDockWidgetFloating(CDockWidget* Dockwidget)
{
        d->DockWidgetsMap.insert(Dockwidget->objectName(), Dockwidget);
        CDockAreaWidget* OldDockArea = Dockwidget->dockAreaWidget();
        if (OldDockArea)
        {
                OldDockArea->removeDockWidget(Dockwidget);
        }
 
        Dockwidget->setDockManager(this);
        CFloatingDockContainer* FloatingWidget = new CFloatingDockContainer(Dockwidget);
        FloatingWidget->resize(Dockwidget->size());
        if (isVisible())
        {
                FloatingWidget->show();
        }
        else
        {
                d->UninitializedFloatingWidgets.append(FloatingWidget);
        }
        emit dockWidgetAdded(Dockwidget);
        return FloatingWidget;
}
 
 
//============================================================================
void CDockManager::showEvent(QShowEvent *event)
{
        Super::showEvent(event);
        if (d->UninitializedFloatingWidgets.empty())
        {
                return;
        }
 
        for (auto FloatingWidget : d->UninitializedFloatingWidgets)
        {
                FloatingWidget->show();
        }
        d->UninitializedFloatingWidgets.clear();
}
 
 
//============================================================================
CDockAreaWidget* CDockManager::addDockWidget(DockWidgetArea area,
        CDockWidget* Dockwidget, CDockAreaWidget* DockAreaWidget)
{
        d->DockWidgetsMap.insert(Dockwidget->objectName(), Dockwidget);
        auto Container = DockAreaWidget ? DockAreaWidget->dockContainer(): this;
        auto AreaOfAddedDockWidget = Container->addDockWidget(area, Dockwidget, DockAreaWidget);
        emit dockWidgetAdded(Dockwidget);
        return AreaOfAddedDockWidget;
}
 
 
//============================================================================
CDockAreaWidget* CDockManager::addDockWidgetTab(DockWidgetArea area,
        CDockWidget* Dockwidget)
{
        CDockAreaWidget* AreaWidget = lastAddedDockAreaWidget(area);
        if (AreaWidget)
        {
                return addDockWidget(ads::CenterDockWidgetArea, Dockwidget, AreaWidget);
        }
        else if (!openedDockAreas().isEmpty())
        {
                return addDockWidget(area, Dockwidget, openedDockAreas().last());
        }
        else
        {
                return addDockWidget(area, Dockwidget, nullptr);
        }
}
 
 
//============================================================================
CDockAreaWidget* CDockManager::addDockWidgetTabToArea(CDockWidget* Dockwidget,
        CDockAreaWidget* DockAreaWidget)
{
        return addDockWidget(ads::CenterDockWidgetArea, Dockwidget, DockAreaWidget);
}
 
 
//============================================================================
CDockWidget* CDockManager::findDockWidget(const QString& ObjectName) const
{
        return d->DockWidgetsMap.value(ObjectName, nullptr);
}
 
//============================================================================
void CDockManager::removeDockWidget(CDockWidget* Dockwidget)
{
        emit dockWidgetAboutToBeRemoved(Dockwidget);
        d->DockWidgetsMap.remove(Dockwidget->objectName());
        CDockContainerWidget::removeDockWidget(Dockwidget);
        Dockwidget->setDockManager(nullptr);
        emit dockWidgetRemoved(Dockwidget);
}
 
//============================================================================
QMap<QString, CDockWidget*> CDockManager::dockWidgetsMap() const
{
        return d->DockWidgetsMap;
}
 
 
//============================================================================
void CDockManager::addPerspective(const QString& UniquePrespectiveName)
{
        d->Perspectives.insert(UniquePrespectiveName, saveState());
        emit perspectiveListChanged();
}
 
 
//============================================================================
void CDockManager::removePerspective(const QString& Name)
{
        removePerspectives({Name});
}
 
 
//============================================================================
void CDockManager::removePerspectives(const QStringList& Names)
{
        int Count = 0;
        for (auto Name : Names)
        {
                Count += d->Perspectives.remove(Name);
        }
 
        if (Count)
        {
                emit perspectivesRemoved();
                emit perspectiveListChanged();
        }
}
 
 
//============================================================================
QStringList CDockManager::perspectiveNames() const
{
        return d->Perspectives.keys();
}
 
 
//============================================================================
void CDockManager::openPerspective(const QString& PerspectiveName)
{
        const auto Iterator = d->Perspectives.find(PerspectiveName);
        if (d->Perspectives.end() == Iterator)
        {
                return;
        }
 
        emit openingPerspective(PerspectiveName);
        restoreState(Iterator.value());
        emit perspectiveOpened(PerspectiveName);
}
 
 
//============================================================================
void CDockManager::savePerspectives(QSettings& Settings) const
{
        Settings.beginWriteArray("Perspectives", d->Perspectives.size());
        int i = 0;
        for (auto it = d->Perspectives.constBegin(); it != d->Perspectives.constEnd(); ++it)
        {
                Settings.setArrayIndex(i);
                Settings.setValue("Name", it.key());
                Settings.setValue("State", it.value());
                ++i;
        }
        Settings.endArray();
}
 
 
//============================================================================
void CDockManager::loadPerspectives(QSettings& Settings)
{
        d->Perspectives.clear();
        int Size = Settings.beginReadArray("Perspectives");
        if (!Size)
        {
                Settings.endArray();
                return;
        }
 
        for (int i = 0; i < Size; ++i)
        {
                Settings.setArrayIndex(i);
                QString Name = Settings.value("Name").toString();
                QByteArray Data = Settings.value("State").toByteArray();
                if (Name.isEmpty() || Data.isEmpty())
                {
                        continue;
                }
 
                d->Perspectives.insert(Name, Data);
        }
 
        Settings.endArray();
}
 
 
//============================================================================
CDockWidget* CDockManager::centralWidget() const
{
    return d->CentralWidget;
}
 
 
//============================================================================
CDockAreaWidget* CDockManager::setCentralWidget(CDockWidget* widget)
{
        if (!widget)
        {
                d->CentralWidget = nullptr;
                return nullptr;
        }
 
        // Setting a new central widget is now allowed if there is already a central
        // widget or if there are already other dock widgets
        if (d->CentralWidget)
        {
                qWarning("Setting a central widget not possible because there is already a central widget.");
                return nullptr;
        }
 
        // Setting a central widget is now allowed if there are already other
        // dock widgets.
        if (!d->DockWidgetsMap.isEmpty())
        {
                qWarning("Setting a central widget not possible - the central widget need to be the first "
                        "dock widget that is added to the dock manager.");
                return nullptr;
        }
 
 
        widget->setFeature(CDockWidget::DockWidgetClosable, false);
        widget->setFeature(CDockWidget::DockWidgetMovable, false);
        widget->setFeature(CDockWidget::DockWidgetFloatable, false);
        d->CentralWidget = widget;
        CDockAreaWidget* CentralArea = addDockWidget(CenterDockWidgetArea, widget);
        CentralArea->setDockAreaFlag(CDockAreaWidget::eDockAreaFlag::HideSingleWidgetTitleBar, true);
        return CentralArea;
}
 
//============================================================================
QAction* CDockManager::addToggleViewActionToMenu(QAction* ToggleViewAction,
        const QString& Group, const QIcon& GroupIcon)
{
        bool AlphabeticallySorted = (MenuAlphabeticallySorted == d->MenuInsertionOrder);
        if (!Group.isEmpty())
        {
                QMenu* GroupMenu = d->ViewMenuGroups.value(Group, 0);
                if (!GroupMenu)
                {
                        GroupMenu = new QMenu(Group, this);
                        GroupMenu->setIcon(GroupIcon);
                        d->addActionToMenu(GroupMenu->menuAction(), d->ViewMenu, AlphabeticallySorted);
                        d->ViewMenuGroups.insert(Group, GroupMenu);
                }
                else if (GroupMenu->icon().isNull() && !GroupIcon.isNull())
                {
                        GroupMenu->setIcon(GroupIcon);
                }
 
                d->addActionToMenu(ToggleViewAction, GroupMenu, AlphabeticallySorted);
                return GroupMenu->menuAction();
        }
        else
        {
                d->addActionToMenu(ToggleViewAction, d->ViewMenu, AlphabeticallySorted);
                return ToggleViewAction;
        }
}
 
 
//============================================================================
QMenu* CDockManager::viewMenu() const
{
        return d->ViewMenu;
}
 
 
//============================================================================
void CDockManager::setViewMenuInsertionOrder(eViewMenuInsertionOrder Order)
{
        d->MenuInsertionOrder = Order;
}
 
 
//===========================================================================
bool CDockManager::isRestoringState() const
{
        return d->RestoringState;
}
 
 
//===========================================================================
int CDockManager::startDragDistance()
{
        return QApplication::startDragDistance() * 1.5;
}
 
 
//===========================================================================
CDockManager::ConfigFlags CDockManager::configFlags()
{
        return StaticConfigFlags;
}
 
 
//===========================================================================
void CDockManager::setConfigFlags(const ConfigFlags Flags)
{
        StaticConfigFlags = Flags;
}
 
 
//===========================================================================
void CDockManager::setConfigFlag(eConfigFlag Flag, bool On)
{
        internal::setFlag(StaticConfigFlags, Flag, On);
}
 
//===========================================================================
bool CDockManager::testConfigFlag(eConfigFlag Flag)
{
    return configFlags().testFlag(Flag);
}
 
 
//===========================================================================
CIconProvider& CDockManager::iconProvider()
{
        static CIconProvider Instance;
        return Instance;
}
 
 
//===========================================================================
void CDockManager::notifyWidgetOrAreaRelocation(QWidget* DroppedWidget)
{
        if (d->FocusController)
        {
                d->FocusController->notifyWidgetOrAreaRelocation(DroppedWidget);
        }
}
 
 
//===========================================================================
void CDockManager::notifyFloatingWidgetDrop(CFloatingDockContainer* FloatingWidget)
{
        if (d->FocusController)
        {
                d->FocusController->notifyFloatingWidgetDrop(FloatingWidget);
        }
}
 
 
//===========================================================================
void CDockManager::setDockWidgetFocused(CDockWidget* DockWidget)
{
        if (d->FocusController)
        {
                d->FocusController->setDockWidgetFocused(DockWidget);
        }
}
 
 
//===========================================================================
CDockWidget* CDockManager::focusedDockWidget() const
{
        if (!d->FocusController)
        {
                return nullptr;
        }
        else
        {
                return d->FocusController->focusedDockWidget();
        }
}
 
//===========================================================================
QList<int> CDockManager::splitterSizes(CDockAreaWidget *ContainedArea) const
{
    if (ContainedArea)
    {
        auto Splitter = internal::findParent<CDockSplitter*>(ContainedArea);
        if (Splitter)
        {
            return Splitter->sizes();
        }
    }
    return QList<int>();
}
 
//===========================================================================
void CDockManager::setSplitterSizes(CDockAreaWidget *ContainedArea, const QList<int>& sizes)
{
    if (!ContainedArea)
    {
        return;
    }
 
    auto Splitter = internal::findParent<CDockSplitter*>(ContainedArea);
    if (Splitter && Splitter->count() == sizes.count())
    {
        Splitter->setSizes(sizes);
    }
}
 
} // namespace ads
 
//---------------------------------------------------------------------------
// EOF DockManager.cpp