DockWorkspace.h

浏览该文件的文档.

#pragma once
 
#include "UI/Dock/DockTree.h"
 
#include <unordered_map>
 
namespace z8::ui {
class BaseNode;
class PanelGroupNode;
class PanelNode;
 
enum class PanelDragState { Idle, Pressed, Dragging };
enum class DragPayloadType { None, Panel, PanelGroup };
 
struct PanelDragSession {
  PanelDragState State = PanelDragState::Idle;
  DragPayloadType PayloadType = DragPayloadType::None;
  PanelNode *PayloadPanel = nullptr;
  PanelGroupNode *PayloadGroup = nullptr;
  PanelGroupNode *SourceGroup = nullptr;
  PanelGroupNode *TargetGroup = nullptr;
  BaseNode *Panel = nullptr;
  DockNodeID SourceNode = 0;
  int SourceTabIndex = -1;
  bool SourceWasFloating = false;
  bool PreviewVisible = false;
  DockRect SourceFloatingRect;
  float PressClientX = 0.0f;
  float PressClientY = 0.0f;
  float MouseClientX = 0.0f;
  float MouseClientY = 0.0f;
  float GrabOffsetX = 0.0f;
  float GrabOffsetY = 0.0f;
  DockRect FloatingPreviewRect;
  DockNodeID DockTarget = 0;
  DockSide Side = DockSide::Center;
  int TargetTabIndex = -1;
  DockRect DockPreviewRect;
};
 
struct PanelDockState {
  PanelPlacement Placement = PanelPlacement::Docked;
  DockNodeID DockNode = 0;
  DockRect FloatingRect;
};
 
class DockWorkspace final {
public:
  DockTree Tree;
  PanelDragSession Drag;
 
  void ApplyLayout(float width, float height);
  void BeginDrag(BaseNode &panel, float clientX, float clientY);
  void BeginPanelDrag(PanelNode &panel, PanelGroupNode &sourceGroup,
                      size_t sourceTabIndex, float clientX, float clientY);
  void CancelDrag();
  bool CommitDrag(float clientX, float clientY);
  DockSide DetectSide(const DockRect &rect, float clientX, float clientY) const;
  const PanelDockState *GetState(const BaseNode &panel) const;
  std::vector<BaseNode *> GetFloatingPanels() const;
  bool IsDocked(const BaseNode &panel) const;
  bool IsFloating(const BaseNode &panel) const;
  bool PlaceNew(BaseNode &group, DockNodeID target, DockSide side,
                const DockRect &floatingRect);
  void Reconcile(const std::vector<BaseNode *> &nodes);
  bool Remove(BaseNode &panel);
  void UpdateDrag(float clientX, float clientY);
  bool UpdateFloatingRect(BaseNode &panel, const DockRect &rect);
  bool ResizeSplitter(DockNodeID split, float clientX, float clientY);
  std::string DumpDebug() const;
  bool Validate(std::string *error = nullptr) const;
 
private:
  std::unordered_map<BaseNode *, PanelDockState> States;
  std::vector<BaseNode *> PendingInitialPanels;
  std::string LastTransactionTrace;
 
  void ApplyPanelRect(BaseNode &panel, const DockRect &rect, bool visible);
  void BuildInitialTree(const std::vector<BaseNode *> &panels, float width,
                        float height);
};
 
} // namespace z8::ui