Snapshot before max-resize threshold diagnosis

Control.h

@@ -4,6 +4,7 @@
  * @描述:
  *     提供控件的基本属性和方法，包括位置、尺寸、重绘标记等。
  *     实现绘图状态保存和恢复机制，确保控件绘制不影响全局状态。
+ *     同时提供“事件阶段登记、收口阶段统一提交”的托管重绘基础接口。
  *
  * @特性:
  *     - 定义控件基本属性（坐标、尺寸、脏标记）
@@ -44,7 +45,7 @@ protected:
 	Window* hostWindow = nullptr; // 宿主窗口（顶层由 Window 注入，子控件可沿 parent 回溯）
 	bool dirty = true; // 是否重绘
 	bool show = true; // 是否显示
-	bool eventVisualChanged = false; // 最近一次 handleEvent 是否真的引发了视觉变化
+	bool eventVisualChanged = false; // 最近一次 handleEvent 是否真的引发了视觉变化（用于上层判断是否需要登记重绘）
 
 	/* == 布局模式 == */
 	StellarX::LayoutMode layoutMode = StellarX::LayoutMode::Fixed;  // 布局模式
@@ -81,10 +82,11 @@ public:
 		discardBackground();
 	}
 protected:
-	//向上请求重绘
+	// 向上请求重绘：普通路径交给父容器，托管路径则登记到 Window
 	virtual void requestRepaint(Control* parent);
-	//根控件/无父时触发重绘
+	// 根控件/无父时触发重绘
 	virtual void onRequestRepaintAsRoot();
+	// 当前是否处于 Window 托管分发阶段；若为真，则不应立即画
 	bool shouldDeferManagedRepaint() const;
 protected:
 	//保存背景快照
@@ -127,8 +129,12 @@ public:
 	void setParent(Control* parent) { this->parent = parent; }
 	//设置宿主窗口（通常仅由顶层 Window/对话框注入）
 	virtual void setHostWindow(Window* host) { this->hostWindow = host; }
-	Window* getHostWindow() const;
-	RECT getBoundsRect() const;
+	Window* getHostWindow() const;                         // 获取宿主 Window；子控件可沿 parent 向上回溯
+	RECT getBoundsRect() const;                           // 获取当前控件外接矩形，用于覆盖/相交判断
+	Control* getManagedRepaintRoot();                     // 找到本控件对应的托管重绘 root
+	bool hasValidBackgroundSnapshot() const { return hasSnap && saveBkImage != nullptr; } // 当前是否持有可用于局部恢复的快照
+	virtual bool canCommitManagedPartialRepaint() const; // 当前 root 是否可安全做“局部提交”而非整 root 重画
+	virtual void commitManagedRepaint();                  // 托管收口阶段真正执行绘制的入口
 	//设置是否重绘
 	virtual void setDirty(bool dirty) { this->dirty = dirty; }
 	//检查控件是否可见
@@ -137,6 +143,7 @@ public:
 	std::string getId() const { return id; }
 	//检查是否为脏
 	bool isDirty() { return dirty; }
+	//获取控件最近一次事件处理是否引发了视觉变化
 	bool didEventAffectVisual() const { return eventVisualChanged; }
 	//用来检查对话框是否模态，其他控件不用实现
 	virtual bool model()const = 0;