dockcontainer.h

浏览该文件的文档.

 
#pragma once
 
#include "qxdock_global.h"
#include <QFrame>
#include "dockwidget.h"
 
class QSplitter;
class QXmlStreamWriter;
 
QX_DOCK_BEGIN_NAMESPACE
 
class DockWindow;
class DockPanel;
class DockWidget;
class DockFloatingContainer;
class DockSplitter;
class DockAutoHideContainer;
class DockSideBar;
class DockStateReader;
 
class DockContainerPrivate;
 
class QX_DOCK_EXPORT DockContainer : public QFrame
{
    Q_OBJECT
public:
    using Super = QFrame;
public:
    explicit DockContainer(DockWindow *window, QWidget *parent = nullptr);
    virtual ~DockContainer();
 
    DockPanel *addDockWidget(Qx::DockWidgetArea area, DockWidget *w, DockPanel *p = nullptr, int index = -1);
    void removeDockWidget(DockWidget *w);
 
    virtual unsigned int zOrderIndex() const;
    bool isInFrontOf(DockContainer *other) const;
 
    DockWindow *dockWindow() const;
    DockPanel *dockPanelAt(const QPoint &globalPos) const;
    DockPanel *dockPanel(int index) const;
 
    QList<DockPanel *> openedDockPanels() const;
    QList<DockWidget *> openedDockWidgets() const;
    bool hasOpenDockPanels() const;
    bool hasTopLevelDockWidget() const;
    int dockPanelCount() const;
    int visibleDockPanelCount() const;
 
    DockWidget::DockWidgetFeatures features() const;
    bool isFloating() const;
 
    DockFloatingContainer *floatingWidget() const;
 
    void closeOtherAreas(DockPanel *keepOpenPanel);
 
    DockSideBar *autoHideSideBar(Qx::DockSideBarArea area) const;
    QList<DockAutoHideContainer *> autoHideWidgets() const;
    QRect contentRect() const;
 
Q_SIGNALS:
    void dockAreasAdded();
    void dockAreasRemoved();
    void autoHideWidgetCreated(DockAutoHideContainer *autoHideWidget);
    void dockAreaViewToggled(DockPanel *panel, bool open);
protected:
    DockSplitter *rootSplitter() const;
    void createRootSplitter();
    void addDockPanel(DockPanel *panel, Qx::DockWidgetArea area = Qx::CenterDockWidgetArea);
    void removeDockPanel(DockPanel *panel);
    QList<QPointer<DockPanel>> removeAllDockPanels();
    DockWidget *topLevelDockWidget() const;
    DockPanel *topLevelDockPanel() const;
    DockPanel *lastAddedDockPanel(Qx::DockWidgetArea area) const;
    QList<DockWidget *> dockWidgets() const;
    void updateSplitterHandles(QSplitter *splitter);
    void dropFloatingWidget(DockFloatingContainer *floatingWidget, const QPoint &targetPos);
    void dropWidget(QWidget *widget, Qx::DockWidgetArea dropArea, DockPanel *targetPanel, int tabIndex = -1);
 
    void createSideTabBarWidgets();
    DockAutoHideContainer *createAndSetupAutoHideContainer(Qx::DockSideBarArea area, DockWidget *w, int tabIndex = -1);
    void registerAutoHideWidget(DockAutoHideContainer *autoHideWidget);
    void removeAutoHideWidget(DockAutoHideContainer *autoHideWidget);
    void handleAutoHideWidgetEvent(QEvent *e, QWidget *w);
 
    void saveState(QXmlStreamWriter &s) const;
    bool restoreState(DockStateReader &s, bool testing);
protected:
    virtual bool event(QEvent *e) override;
private:
    QX_DECLARE_PRIVATE(DockContainer)
    friend class DockPanel;
    friend class DockFloatingContainer;
    friend class DockFloatingContainerPrivate;
    friend class DockWidget;
    friend class DockFloatingPreview;
    friend class DockAutoHideContainer;
    friend class DockWindow;
    friend class DockAutoHideContainerPrivate;
    friend class DockSideBar;
    friend class DockSideTabPrivate;
    friend class DockWindowPrivate;
};
 
QX_DOCK_END_NAMESPACE