Layout.h

浏览该文件的文档.

//
// Created by zhou_zhengming on 2026/7/29.
//
 
#pragma once
#include "Core/Event.h"
#include "UI/Dock/DockWorkspace.h"
#include <DirectXMath.h>
 
#include <memory>
#include <string>
#include <vector>
 
namespace z8 {
class Application;
class GameObject;
} // namespace z8
 
namespace z8::ui {
class BaseNode;
class BehaviorNode;
class DrawNode;
class TextNode;
class SceneNode;
class TerminalNode;
class RectNode;
 
class Layout : public EventTarget {
public:
  std::unique_ptr<BaseNode> Root;
  std::vector<BaseNode *> Nodes;
  std::vector<DrawNode *> Visuals;
  std::vector<TextNode *> Texts;
  std::vector<SceneNode *> Scenes;
  std::vector<TerminalNode *> Terminals;
  DockWorkspace Dock;
  std::unique_ptr<RectNode> DockPreviewVisual;
  bool DebugPanelBorders = false;
 
  bool Dirty = true;
  BaseNode *CapturedTarget = nullptr;
  BehaviorNode *CapturedHandler = nullptr;
  DockNodeID CapturedSplitter = 0;
  BehaviorNode *HoveredHandler = nullptr;
  BehaviorNode *PressedHandler = nullptr;
  BehaviorNode *FocusedHandler = nullptr;
 
  explicit Layout();
  ~Layout() override;
 
  void RebuildIndex();
  BaseNode *Find(const std::string &key) const;
  void Calculate(float width, float height);
  void ActivateFloating(BaseNode &node);
  void MarkDirty() { Dirty = true; }
  bool ConsumeDirty();
  bool ContainsNode(const BaseNode *node) const;
  void SetRoot(std::unique_ptr<BaseNode> root);
  std::vector<GameObject *> GetUO() const;
  std::vector<GameObject *> GetMainUO() const;
  std::vector<GameObject *> GetSubtreeUO(const BaseNode &root) const;
  std::vector<TextNode *> GetMainTexts() const;
  std::vector<TextNode *> GetSubtreeTexts(const BaseNode &root) const;
  SceneNode *GetSceneNode() const;
  void WriteTerminal(const std::string &message) const;
  DockRect GetDockPreview() const;
  size_t GetPanelDebugBorderCount() const { return PanelDebugVisuals.size(); }
 
  EventReply OnKeyDown(KeyArgs args) override;
  EventReply OnKeyUp(KeyArgs args) override;
  EventReply OnTextInput(wchar_t character) override;
  EventReply OnMouseDown(MouseMovArgs args) override;
  EventReply OnMouseMove(MouseMovArgs args) override;
  EventReply OnMouseDrag(MouseMovArgs args) override;
  EventReply OnMouseUp(MouseMovArgs args) override;
  EventReply OnMouseWheel(MouseWheelArgs args) override;
  MouseCursor GetMouseCursor(MouseMovArgs args) const override;
  void OnPointerCaptureLost() override;
 
private:
  std::vector<DrawNode *> LaterTextOccluders;
  std::vector<std::unique_ptr<RectNode>> PanelDebugVisuals;
 
  void BringToFront(BaseNode *node);
  void CancelTreeCaptures(BaseNode *node);
  void CloseMenusOutside(BaseNode *target);
  bool CommitPanelDrop(float clientX, float clientY);
  BehaviorNode *FindBehaviorNode(BaseNode *node) const;
  BaseNode *HitAt(float x, float y) const;
  void IndexTree(BaseNode *node);
  void NormalizePanelGroups(BaseNode &parent);
  void ResetInteractionStates(BaseNode *node);
  bool RemoveClosedPanelGroups(BaseNode &parent);
  void UpdatePanelDebugVisuals();
  void UpdateTextOcclusion();
  void UpdateTree(BaseNode &node, float parentX, float parentY,
                  const DirectX::XMFLOAT4 &clip, bool dispatchAfterLayout,
                  bool parentVisible = true);
  void UpdateDockPreview();
  void UpdateHoveredHandler(float x, float y);
  void SetFocusedHandler(BehaviorNode *handler);
 
};
} // namespace z8::ui