#ifndef _Docking_Docking_h_ #define _Docking_Docking_h_ #include #include #include #include #include NAMESPACE_UPP class DockWindow : public TopWindow { public: typedef DockWindow CLASSNAME; enum { DOCK_NONE = -1, DOCK_LEFT = SplitterFrame::LEFT, DOCK_TOP = SplitterFrame::TOP, DOCK_RIGHT = SplitterFrame::RIGHT, DOCK_BOTTOM = SplitterFrame::BOTTOM, }; virtual void State(int reason); protected: enum { TIMEID_ACTION_CHECK = Ctrl::TIMEID_COUNT, TIMEID_ANIMATE, TIMEID_ANIMATE_DELAY, TIMEID_COUNT }; // DnD interface struct HighlightCtrl : public DockableCtrl { HighlightCtrl() { BackPaint(); } void ClearHighlight() { img.Clear(); buffer.Clear(); } void SetHighlight(const Value& hl, bool _isnested, bool cannest, Image bg = Image()); void SetNested(bool _isnested); void CreateBuffer(); virtual void Paint(Draw& w); int oldframesize; Rect bounds; private: Image img; Image buffer; bool isnested; bool cannest; const Value *highlight; }; struct PosInfo : public Moveable { PosInfo() : state(DockCont::STATE_NONE) {} DockCont::DockState state; // State info Ptr tabcont;// Only valid when ctrl was tabbed String data; // Serialized context info dependent on state }; protected: // Highlight control virtual HighlightCtrl& GetHighlightCtrl() { return hlc; } void StartHighlight(DockCont *dcptr); void Highlight(int align, DockCont& cont, DockCont *target); void StopHighlight(bool do_animatehl); virtual bool NeedFrameReorder(int align); bool IsReorderingFrames() { return prehighlightframepos >= 0; } // Called by containers to signal drag-drop events virtual void ContainerDragStart(DockCont& dc); virtual void ContainerDragMove(DockCont& dc); virtual void ContainerDragEnd(DockCont& dc); // Container docking/undocking void DockContainer(int align, DockCont& c, int pos = -1); void DockAsTab(DockCont& target, DockableCtrl& dc); void DockContainerAsTab(DockCont& target, DockCont& c, bool do_nested); void FloatContainer(DockCont& c, Point p = Null, bool move = true); void FloatFromTab(DockCont& c, DockableCtrl& tab) { FloatFromTab(c, *CreateContainer(tab)); } void FloatFromTab(DockCont& c, DockCont& tab); void AutoHideContainer(int align, DockCont& c); void CloseContainer(DockCont& c); DockCont *TabifyGroup(String group); void Undock(DockCont& c); void Unfloat(DockCont& c); void Detach(DockCont& c) { Undock(c); Unfloat(c); } // For finding drag-drop targets and computing boundary rect DockCont *GetMouseDockTarget(); DockCont *FindDockTarget(DockCont& dc, int& al); int FindDocker(const Ctrl *dc); Rect GetAlignBounds(int al, Rect r, bool center, bool allow_lr = true, bool allow_tb = true); int GetPointAlign(const Point p, Rect r, bool center, bool allow_lr = true, bool allow_tb = true); int GetQuad(Point p, Rect r); Rect GetFinalAnimRect(int align, Ctrl& c); // Helpers bool IsTL(int align) const { return align < 2; } //ie (align == DOCK_LEFT || align == DOCK_TOP) bool IsTB(int align) const { return align & 1; } //ie (align == DOCK_TOP || align == DOCK_BOTTOM) int GetDockAlign(const Ctrl& c) const; int GetDockAlign(const Point& p) const; int GetAutoHideAlign(const DockCont& c) const; bool IsFrameAnimating(int align) const { return frameanim[align].inc; } bool IsPaneAnimating(int align) const { return dockpane[align].IsAnimating(); } bool CheckNesting() const { return (GetMouseFlags() & nesttoggle) ? !nestedtabs : nestedtabs; } void SaveDockerPos(DockableCtrl& dc, PosInfo& pi); void SetDockerPosInfo(DockableCtrl& dc, const PosInfo& pi); friend class DockCont; private: bool init; bool tabbing; bool autohide; bool animatehl; bool animatefrm; bool animatewnd; bool nestedtabs; bool grouping; bool menubtn; bool closebtn; bool hidebtn; bool dockable[4]; bool locked; bool tabtext; bool tabalign; bool frameorder; bool childtoolwindows; dword nesttoggle; String layoutbackup; int dockframepos; int prehighlightframepos; Array conts; Vector dockers; ArrayMap layouts; Array ctrls; HighlightCtrl hlc; DockPane dockpane[4]; SplitterFrame dockframe[4]; AutoHideBar hideframe[4]; DockMenu menu; Vector dockerpos; struct FrameAnim { FrameAnim() : target(0), inc(0) {} int target; int inc; }; FrameAnim frameanim[4]; int animdelay; public: void DockLayout(bool tb_precedence = true); virtual void DockInit() { } DockableCtrl& Dockable(Ctrl& ctrl, WString title); DockableCtrl& Dockable(Ctrl& ctrl, const char *title = 0) { return Dockable(ctrl, (WString)title); } template T& CreateDockable(WString title); template T& CreateDockable(const char *title = 0) { return CreateDockable((WString)title); } void DockLeft(DockableCtrl& dc, int pos = -1) { Dock(DOCK_LEFT, dc, pos); } void DockTop(DockableCtrl& dc, int pos = -1) { Dock(DOCK_TOP, dc, pos); } void DockRight(DockableCtrl& dc, int pos = -1) { Dock(DOCK_RIGHT, dc, pos); } void DockBottom(DockableCtrl& dc, int pos = -1) { Dock(DOCK_BOTTOM, dc, pos); } void Dock(int align, DockableCtrl& dc, int pos = -1); void Tabify(DockableCtrl& target, DockableCtrl& dc); void Float(DockableCtrl& dc, Point p = Null); void Float(DockableCtrl& dc, const char *title, Point p = Null); void AutoHide(DockableCtrl& dc); void AutoHide(int align, DockableCtrl& dc); void Close(DockableCtrl& dc); void ActivateDockable(Ctrl& c); void ActivateDockableChild(Ctrl& c); void SaveDockerPos(DockableCtrl& dc); void RestoreDockerPos(DockableCtrl& dc, bool savefirst = false); void DockGroup(int align, String group, int pos = -1); void FloatGroup(String group); void AutoHideGroup(int align, String group); void AutoHideGroup(String group); void TabDockGroup(int align, String group, int pos = -1); void TabFloatGroup(String group); void CloseGroup(String group); bool IsDockVisible(int align) const { ASSERT(align >= 0 && align <= 4); return dockpane[align].IsVisible(); } void SetFrameSize(int align, int size); DockWindow& AnimateDelay(int ms) { animdelay = max(ms, 0); return *this; } DockWindow& Animate(bool highlight = true, bool frames = true, bool windows = true, int ticks = 10, int interval = 20); DockWindow& NoAnimate() { return Animate(false, false); } bool IsAnimated() const { return animatehl || animatewnd; } bool IsAnimatedHighlight() const { return animatehl; } bool IsAnimatedFrames() const { return animatefrm; } bool IsAnimatedWindows() const { return animatewnd; } void LockLayout(bool lock = true); void UnlockLayout() { LockLayout(true); } bool IsLocked() const { return locked; } DockWindow& TabAutoAlign(bool al = true); DockWindow& TabShowText(bool text = true); DockWindow& Tabbing(bool _tabbing = true) { tabbing = _tabbing; return *this; } DockWindow& NoTabbing() { return Tabbing(false); } bool IsTabbing() const { return tabbing; } DockWindow& NestedTabs(bool _nestedtabs = true) { nestedtabs = _nestedtabs; return *this; } DockWindow& NoNestedTabs() { return NestedTabs(false); } bool IsNestedTabs() const { return nestedtabs; } DockWindow& Grouping(bool grouping = true); DockWindow& NoGrouping() { return Grouping(false); } bool IsGrouping() const { return grouping; } DockWindow& FrameReordering(bool reorder = true){ frameorder = reorder; return *this;} DockWindow& NoFrameReordering() { return FrameReordering(false); } bool IsFrameReordering() const { return frameorder; } DockWindow& SetFrameOrder(int first, int second = DOCK_NONE, int third = DOCK_NONE, int fourth = DOCK_NONE); DockWindow& AllowDockAll(); DockWindow& AllowDockNone(); DockWindow& AllowDockLeft(bool v = true) { dockable[DOCK_LEFT] = v; return *this; } DockWindow& AllowDockTop(bool v = true) { dockable[DOCK_TOP] = v; return *this; } DockWindow& AllowDockRight(bool v = true) { dockable[DOCK_RIGHT] = v; return *this; } DockWindow& AllowDockBottom(bool v = true) { dockable[DOCK_BOTTOM] = v; return *this; } DockWindow& AllowDock(int a, bool v = true) { ASSERT(a >= 0 && a < 4); dockable[a] = v; return *this; } bool IsDockAllowed(int align) { ASSERT(align >= 0 && align < 4); return dockable[align]; } bool IsDockAllowed(int align, DockableCtrl& dc); DockWindow& AutoHide(bool v = true); bool IsAutoHide() { return autohide; } dword NestedToggleKey() { return nesttoggle; } DockWindow& SetNestedToggleKey(dword key) { nesttoggle = key; return *this; } DockWindow& WindowButtons(bool menu, bool hide, bool close); bool HasMenuButtons() const { return menubtn; } bool HasHideButtons() const { return hidebtn; } bool HasCloseButtons() const { return closebtn; } void ChildToolWindows(bool v = true) { childtoolwindows = v; SyncAll(); } bool HasToolWindows() const { return childtoolwindows; } DockableCtrl& Register(DockableCtrl& dc); void Deregister(const DockableCtrl& dc); const Vector& GetDockableCtrls() const { return dockers; } void DockManager(); void DockWindowMenu(Bar& bar); void SerializeWindow(Stream& s); void SerializeLayout(Stream& s, bool withsavedlayouts = true); void BackupLayout(); void RestoreLayout(); int SaveLayout(String name); void LoadLayout(int ix); void LoadLayout(String name); void DeleteLayout(String name) { layouts.RemoveKey(name); } String GetLayoutName(int ix) const { return layouts.GetKey(ix); } int LayoutCount() const { return layouts.GetCount(); } const ArrayMap& GetLayouts() const { return layouts; } void DisableFloating() { EnableFloating(false); } void EnableFloating(bool enable = true); void SetHighlightStyle(DockableCtrl::Style& s) { GetHighlightCtrl().SetStyle(s); } DockWindow(); private: // Container management DockCont *GetContainer(Ctrl& dc) { return dynamic_cast(dc.GetParent()); } DockCont *CreateContainer(); DockCont *CreateContainer(DockableCtrl& dc); void DestroyContainer(DockCont& c); DockCont *GetReleasedContainer(DockableCtrl& dc); void SyncContainer(DockCont& c); void SyncAll(); // Helpers void Dock0(int align, Ctrl& c, int pos, bool do_animatehl = false, bool ishighlight = false); void Dock0(int align, Ctrl& c, int pos, Size sz, bool do_animatehl = false, bool ishighlight = false); void Undock0(Ctrl& c, bool do_animatehl = false, int fsz = -1, bool ishighlight = false); void Activate(DockableCtrl& dc); void DoFrameSize(bool animate, int align, int targetsize); void FrameAnimateTick(); void DoFrameReorder(int align); void UndoFrameReorder(); Size CtrlBestSize(const Ctrl& c, int align, bool restrict = true) const; void ClearLayout(); }; class PopUpDockWindow : public DockWindow { public: struct Style : ChStyle