完成 StellarX 核心重构、缺陷修复与测试收口

include/StellarX/Label.h

@@ -0,0 +1,71 @@
+/*******************************************************************************
+ * @类: Label
+ * @摘要: 简单文本标签控件，用于显示静态文本
+ * @描述:
+ *     提供基本的文本显示功能，支持透明背景和自定义样式。
+ *     不支持用户交互，专注于文本呈现。
+ *
+ * @特性:
+ *     - 支持背景透明/不透明模式
+ *     - 完整的文本样式控制（字体、颜色、效果）
+ *     - 自动适应文本内容
+ *     - 轻量级无事件处理开销
+ *
+ * @使用场景: 显示说明文字、标题、状态信息等静态内容
+ * @所属框架: 星垣(StellarX) GUI框架
+ * @作者: 我在人间做废物
+ ******************************************************************************/
+
+#pragma once
+#include "Control.h"
+
+class Label : public Control
+{
+	std::string text;         //标签文本
+	COLORREF textBkColor; //标签背景颜色
+	bool textBkDisap = false;   //标签背景是否透明
+	std::string lastMeasuredText;              // 最近一次参与尺寸测量的文本
+	StellarX::ControlText lastMeasuredStyle;   // 最近一次参与尺寸测量的字体样式
+	bool contentMeasureValid = false;          // 当前内容尺寸缓存是否有效
+
+	// Label 不处理输入事件，固定返回 false。
+	bool handleEvent(const ExMessage&) override { return false; }
+	// Label 不是模态对话框，固定返回 false。
+	bool model() const override { return false; };
+	// 根据当前文本和字体样式刷新运行态尺寸。
+	// 这是 Label 的内容驱动几何入口：
+	// - 覆盖文本变化
+	// - 覆盖字体样式变化
+	// - 只更新运行态宽高，不自动提交设计基线 local*
+	void refreshContentDrivenRuntimeGeometry();
+public:
+	// 标签字体样式保持公开，便于用户直接改字段。
+	// 但直接修改 textStyle 后，必须显式调用 setDirty(true)，
+	// 才会触发内容驱动尺寸刷新并让新的运行态宽高生效。
+	StellarX::ControlText   textStyle;   //标签文本样式
+public:
+	// 默认构造：创建一个内容驱动尺寸的标签
+	Label();
+	// 指定位置、文本和基础样式构造标签
+	Label(int x, int y, std::string text = "标签", COLORREF textcolor = BLACK, COLORREF bkColor = RGB(255, 255, 255));
+
+	// 绘制标签文本
+	void draw() override;
+	// 隐藏 Label 并恢复背景；主要供 Button Tooltip 关闭时复用。
+	void hide();
+	// Label 的内容尺寸由文本和字体样式共同决定。
+	// 因此只要进入 dirty 状态，就在绘制前先刷新一次运行态尺寸，
+	// 避免 draw() 阶段继续承担新的几何决策。
+	void setDirty(bool dirty) override;
+	// 设置标签背景是否透明
+	void setTextdisap(bool key);
+	// 设置标签背景颜色
+	void setTextBkColor(COLORREF color);
+	// 设置标签文本，并触发内容驱动尺寸刷新。
+	// Label 的布局系统只负责位置；运行态宽高仍由文本和 textStyle 测量结果决定。
+	void setText(std::string text);
+protected:
+	// 统一布局器只负责安置 Label 的运行态位置；
+	// 宽高仍由 Label 自己的内容驱动路径决定。
+	void applyResolvedLayoutRect(const StellarX::ResolvedLayoutRect& rect) override;
+};