Initial baseline

2026-03-22 18:45:47 +08:00
commit dde570ac3c
31 changed files with 7771 additions and 0 deletions
@@ -0,0 +1,169 @@
+/*******************************************************************************
+ * @类: Table
+ * @摘要: 高级表格控件，支持分页显示和大数据量展示
+ * @描述:
+ *     提供完整的数据表格功能，包括表头、数据行、分页导航等。
+ *     自动计算列宽行高，支持自定义样式和交互。
+ *
+ * @特性:
+ *     - 自动分页和页码计算
+ *     - 可配置的每页行数
+ *     - 自定义边框样式和填充模式
+ *     - 翻页按钮和页码显示
+ *     - 背景缓存优化渲染性能
+ *
+ * @使用场景: 数据展示、报表生成、记录浏览等表格需求
+ * @所属框架: 星垣(StellarX) GUI框架
+ * @作者: 我在人间做废物
+ ******************************************************************************/
+
+#pragma once
+#include "Control.h"
+#include "Button.h"
+#include "Label.h"
+
+ // === Table metrics (layout) ===
+#define TABLE_PAD_X                 10   // 单元格左右内边距
+#define TABLE_PAD_Y                  5   // 单元格上下内边距
+#define TABLE_COL_GAP               20   // 列间距（列与列之间）
+#define TABLE_HEADER_EXTRA          10   // 表头额外高度（若不想复用 pad 计算）
+#define TABLE_ROW_EXTRA             10   // 行额外高度（同上；或直接用 2*TABLE_PAD_Y）
+#define TABLE_BTN_GAP               12   // 页码与按钮的水平间距
+#define TABLE_BTN_PAD_H             12   // 按钮水平 padding
+#define TABLE_BTN_PAD_V              0   // 按钮垂直 padding（initButton）
+#define TABLE_BTN_TEXT_PAD_V         8   // 计算页脚高度时的按钮文字垂直 padding（initTextWaH）
+#define TABLE_FOOTER_PAD            16   // 页脚额外高度（底部留白）
+#define TABLE_FOOTER_BLANK           8   // 页脚顶部留白
+#define TABLE_PAGE_TEXT_OFFSET_X   (-40) // 页码文本的临时水平修正
+
+// === Table defaults (theme) ===
+#define TABLE_DEFAULT_ROWS_PER_PAGE  5
+#define TABLE_DEFAULT_BORDER_WIDTH   1
+#define TABLE_DEFAULT_BORDER_COLOR   RGB(0,0,0)
+#define TABLE_DEFAULT_BG_COLOR       RGB(255,255,255)
+
+// === Strings (i18n ready) ===
+#define TABLE_STR_PREV             "上一页"
+#define TABLE_STR_NEXT             "下一页"
+#define TABLE_STR_PAGE_PREFIX      "第"
+#define TABLE_STR_PAGE_MID         "页/共"
+#define TABLE_STR_PAGE_SUFFIX      "页"
+
+class Table :public Control
+{
+private:
+	std::vector<std::vector<std::string>> data; // 表格数据
+	std::vector<std::string> headers;           // 表格表头
+	std::string pageNumtext = "页码标签";       // 页码标签文本
+
+	int tableBorderWidth = TABLE_DEFAULT_BORDER_WIDTH;                   // 边框宽度
+
+	std::vector<int> colWidths;                // 每列的宽度
+	std::vector<int> lineHeights;			   // 每行的高度
+
+	int rowsPerPage = TABLE_DEFAULT_ROWS_PER_PAGE;  // 每页显示的行数
+	int currentPage = 1;                        // 当前页码
+	int totalPages = 1;                         // 总页数
+
+	bool isShowPageButton = true;			    // 是否显示翻页按钮
+	bool isNeedDrawHeaders = true;              // 是否需要绘制表头(暂时废弃，单做保留，后期优化可能用到)
+	bool isNeedCellSize = true;                 // 是否需要计算单元格尺寸
+	bool isNeedButtonAndPageNum = true;         // 是否需要计算翻页按钮和页码信息
+
+	std::unique_ptr<Button> prevButton;        // 上一页按钮
+	std::unique_ptr<Button> nextButton;	    // 下一页按钮
+	std::unique_ptr<Label> pageNum;            //页码文本
+
+	int dX = x, dY = y;							// 单元格的开始坐标
+	int uX = x, uY = y;							// 单元格的结束坐标
+
+	int pX = 0;                                 //标签左上角坐标
+	int pY = 0;                                 //标签左上角坐标
+
+	StellarX::FillMode  tableFillMode = StellarX::FillMode::Solid;    //填充模式
+	StellarX::LineStyle tableLineStyle = StellarX::LineStyle::Solid; // 线型
+	COLORREF tableBorderClor = TABLE_DEFAULT_BORDER_COLOR;     // 表格边框颜色
+	COLORREF tableBkClor = TABLE_DEFAULT_BG_COLOR;         // 表格背景颜色
+
+	void initTextWaH();  //初始化文本像素宽度和高度
+	void initButton();   //初始化翻页按钮
+	void initPageNum();  //初始化页码标签
+
+	void drawTable();    //绘制当前页
+	void drawHeader();   //绘制表头
+	void drawPageNum();  //绘制页码信息
+	void drawButton();   //绘制翻页按钮
+private:
+	//用来检查对话框是否模态,此控件不做实现
+	bool model() const override { return false; };
+public:
+	StellarX::ControlText textStyle; // 文本样式
+	void setX(int x) override;
+	void setY(int y) override;
+	void setWidth(int width) override;
+	void setHeight(int height) override;
+public:
+	Table(int x, int y);
+	~Table();
+
+	// 绘制表格
+	void draw() override;
+	//事件处理
+	bool handleEvent(const ExMessage& msg) override;
+
+	//设置表头
+	void setHeaders(std::initializer_list<std::string> headers);
+	//设置表格数据
+	void setData(std::vector<std::string> data);
+	void setData(std::initializer_list<std::vector<std::string>> data);
+	//设置每页显示的行数
+	void setRowsPerPage(int rows);
+	//设置是否显示翻页按钮
+	void showPageButton(bool isShow);
+	//设置表格边框颜色
+	void setTableBorder(COLORREF color);
+	//设置表格背景颜色
+	void setTableBk(COLORREF color);
+	//设置填充模式
+	void setTableFillMode(StellarX::FillMode mode);
+	//设置线型
+	void setTableLineStyle(StellarX::LineStyle style);
+	//设置边框宽度
+	void setTableBorderWidth(int width);
+	//清空表头
+	void clearHeaders();
+	//清空表格数据
+	void clearData();
+	//清空表头和数据
+	void resetTable();
+	//窗口变化丢快照+标脏
+	void onWindowResize() override;
+
+	//************************** 获取属性 *****************************/
+
+	//获取当前页码
+	int getCurrentPage() const;
+	//获取总页数
+	int getTotalPages() const;
+	//获取每页显示的行数
+	int getRowsPerPage() const;
+	//获取是否显示翻页按钮
+	bool getShowPageButton() const;
+	//获取表格边框颜色
+	COLORREF getTableBorder() const;
+	//获取表格背景颜色
+	COLORREF getTableBk() const;
+	//获取填充模式
+	StellarX::FillMode getTableFillMode() const;
+	//获取线型
+	StellarX::LineStyle getTableLineStyle() const;
+	//获取表头
+	std::vector<std::string> getHeaders() const;
+	//获取表格数据
+	std::vector<std::vector<std::string>> getData() const;
+	//获取表格边框宽度
+	int getTableBorderWidth() const;
+	//获取表格尺寸
+	int getTableWidth() const;
+	int getTableHeight() const;
+};