Codex
80 lines
3.4 KiB
C++
80 lines
3.4 KiB
C++
/*******************************************************************************
|
||
* @类: TabControl
|
||
* @摘要: 选项卡容器控件，管理“页签按钮 + 对应页面(Canvas)”
|
||
* @描述:
|
||
* 提供页签栏布局（上/下/左/右）、选中切换、页内容区域定位；
|
||
* 与 Button 一起工作，支持窗口大小变化、可见性联动与脏区重绘。
|
||
* 在托管重绘模式下，TabControl 作为“页签栏 + 当前页面”的统一重绘 root。
|
||
*
|
||
* @特性:
|
||
* - 页签栏四向排列（Top / Bottom / Left / Right）
|
||
* - 一键添加“页签+页”或为指定页添加子控件
|
||
* - 获取/设置当前激活页签索引
|
||
* - 自适应窗口变化，重算页签与页面区域
|
||
* - 与 Button 的 TOGGLE 模式联动显示/隐藏页面
|
||
*
|
||
* @使用场景: 在同一区域内承载多张页面，使用页签进行快速切换
|
||
* @所属框架: 星垣(StellarX) GUI框架
|
||
* @作者: 我在人间做废物
|
||
******************************************************************************/
|
||
|
||
#pragma once
|
||
#include "CoreTypes.h"
|
||
#include "Button.h"
|
||
#include "Canvas.h"
|
||
#define BUTMINHEIGHT 15 //页签按钮最小尺寸，过小会导致显示问题
|
||
#define BUTMINWIDTH 30 //页签按钮最小尺寸，过小会导致显示问题
|
||
class TabControl :public Canvas
|
||
{
|
||
int tabBarHeight = BUTMINWIDTH; //页签栏高度
|
||
bool IsFirstDraw = true; //首次绘制标记
|
||
int defaultActivation = -1; //默认激活页签索引
|
||
StellarX::TabPlacement tabPlacement = StellarX::TabPlacement::Top; //页签排列方式
|
||
std::vector<std::pair<std::unique_ptr<Button>, std::unique_ptr<Canvas>>> controls; //页签/页列表
|
||
|
||
private:
|
||
using Canvas::addControl; // 禁止外部误用
|
||
void addControl(std::unique_ptr<Control>) = delete; // 精准禁用该重载
|
||
private:
|
||
// 初始化页签按钮位置和尺寸
|
||
inline void initTabBar();
|
||
inline void initTabPage();
|
||
public:
|
||
TabControl();
|
||
TabControl(int x, int y, int width, int height);
|
||
~TabControl();
|
||
|
||
//重写位置设置以适应页签和页面布局
|
||
void setX(int x)override;
|
||
void setY(int y)override;
|
||
|
||
void draw() override;
|
||
bool handleEvent(const ExMessage& msg) override;
|
||
|
||
//添加页签+页
|
||
void add(std::pair<std::unique_ptr<Button>, std::unique_ptr<Canvas>>&& control);
|
||
//添加为某个页添加控件
|
||
void add(std::string tabText, std::unique_ptr<Control> control);
|
||
//设置页签位置
|
||
void setTabPlacement(StellarX::TabPlacement placement);
|
||
//设置页签栏高度 两侧排列时为宽度
|
||
void setTabBarHeight(int height);
|
||
//设置不可见后传递给子控件重写
|
||
void setIsVisible(bool visible) override;
|
||
void onWindowResize() override;
|
||
//获取当前激活页签索引
|
||
int getActiveIndex() const;
|
||
//设置当前激活页签索引
|
||
void setActiveIndex(int idx);
|
||
//获取页签数量
|
||
int count() const;
|
||
//通过页签文本返回索引
|
||
int indexOf(const std::string& tabText) const;
|
||
//设置脏区并请求重绘
|
||
void setDirty(bool dirty) override;
|
||
//请求父控件重绘
|
||
void requestRepaint(Control* parent)override; // 托管模式下登记为 root；非托管模式下局部更新脏按钮/脏页面
|
||
bool canCommitManagedPartialRepaint() const override; // 判断当前 TabControl 是否可安全做局部提交
|
||
void commitManagedRepaint() override; // 托管收口阶段执行 TabControl 的真正重绘
|
||
};
|