ultimatepp/bazaar/Docking/Docking.h
mrjt 0dfde73755 Docking & TabBar: namespace declaration changed
git-svn-id: svn://ultimatepp.org/upp/trunk@1345 f0d560ea-af0d-0410-9eb7-867de7ffcac7
2009-06-29 08:43:21 +00:00

402 lines
16 KiB
C++

#ifndef _Docking_Docking_h_
#define _Docking_Docking_h_
#include <CtrlLib/CtrlLib.h>
#include <Docking/DockableCtrl.h>
#include <Docking/DockCont.h>
#include <Docking/DockPane.h>
#include <Docking/DockMenu.h>
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> {
PosInfo() : state(DockCont::STATE_NONE) {}
DockCont::DockState state; // State info
Ptr<DockCont> 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<DockCont> conts;
Vector<DockableCtrl *> dockers;
ArrayMap<String, String> layouts;
Array<DockableCtrl> ctrls;
HighlightCtrl hlc;
DockPane dockpane[4];
SplitterFrame dockframe[4];
AutoHideBar hideframe[4];
DockMenu menu;
Vector<PosInfo> 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<class T>
T& CreateDockable(WString title);
template<class T>
T& CreateDockable(const char *title = 0) { return CreateDockable<T>((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<DockableCtrl *>& 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<String, String>& 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<DockCont *>(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<Style> {
Value inner[5];
Value outer[4];
Value hide[4];
Value highlight;
int innersize;
int outersize;
};
static const Style& StyleDefault();
protected:
virtual void ContainerDragStart(DockCont& dc);
virtual void ContainerDragMove(DockCont& dc);
virtual void ContainerDragEnd(DockCont& dc);
private:
struct PopUpButton : public Ctrl {
const Value *icon;
const Value *hlight;
virtual void Paint(Draw& w) { Rect r = GetSize(); ChPaint(w, r, *icon); if (hlight) ChPaint(w, r, *hlight); }
PopUpButton() { hlight = NULL; }
};
const Style *style;
DockCont *last_target;
PopUpButton *last_popup;
PopUpButton inner[5];
PopUpButton outer[4];
PopUpButton hide[4];
bool showhide;
int PopUpHighlight(PopUpButton *pb, int cnt);
void ShowOuterPopUps(DockCont& dc);
void ShowInnerPopUps(DockCont& dc, DockCont *target);
void ShowPopUp(PopUpButton& pb, const Rect& r);
void HidePopUps(bool _inner, bool _outer);
public:
PopUpDockWindow& SetStyle(const Style& s);
PopUpDockWindow();
PopUpDockWindow& AutoHidePopUps(bool v = true) { showhide = v; return *this; }
};
#define LAYOUTFILE <Docking/Docking.lay>
#include <CtrlCore/lay.h>
class DockConfigDlg : public WithDockConfigLayout<TopWindow>
{
public:
typedef DockConfigDlg CLASSNAME;
DockConfigDlg(DockWindow& dockwindow);
private:
DockWindow & dock;
const Vector<DockableCtrl *>& dockers;
VectorMap<String, int> groups;
DockMenu menu;
String backup;
int all;
DockableCtrl *highlight;
void RefreshTree(bool dogroups = false);
void OnTreeContext(Bar& bar);
void OnSaveLayout();
void OnLoadLayout();
void OnDeleteLayout();
void OnTreeCursor();
void OnListCursor();
void OnNewGroup();
void OnDeleteGroup();
void OnOK();
void OnCancel();
void OnLock();
void OnTreeDrag();
void OnTreeDrop(int parent, int ii, PasteClip& d);
void Highlight(DockableCtrl *dc);
void StopHighlight();
void DeleteGroup(int id);
String DockerString(DockableCtrl *dc) const;
String PositionString(DockableCtrl *dc) const;
int ListIndex() const;
void DupePrompt(String type);
};
template <class T>
T& DockWindow::CreateDockable(WString title)
{
T &q = ctrls.Create<T>();
Register(q.Title(title));
return q;
}
END_UPP_NAMESPACE
#endif