Codex
9155a86a8a
收口 Dialog/overlay 后鼠标状态同步、Tooltip 临时 coverage 与持久 coverage 拆分、跨 root 脏区补提交、TextBox/Button 绘制副作用修复，并补充 KEY6 回归用例和 BUG/Fix/Feature 开发记录。
197 lines
8.9 KiB
C++
197 lines
8.9 KiB
C++
/*******************************************************************************
|
||
* @类: Button
|
||
* @摘要: 多功能按钮控件，支持多种状态和样式
|
||
* @描述:
|
||
* 提供完整的按钮功能，包括普通点击、切换模式、禁用状态。
|
||
* 支持多种形状（矩形、圆形、椭圆等）和丰富的视觉样式。
|
||
* 通过回调函数机制实现灵活的交互逻辑。
|
||
*
|
||
* @特性:
|
||
* - 支持三种工作模式：普通、切换、禁用
|
||
* - 八种几何形状，各有边框和无边框版本
|
||
* - 自定义颜色（默认、悬停、点击状态）
|
||
* - 多种填充模式（纯色、图案、图像）
|
||
* - 完整的鼠标事件处理（点击、悬停、移出）
|
||
*
|
||
* @使用场景: 作为主要交互控件，用于触发动作或表示状态
|
||
* @所属框架: 星垣(StellarX) GUI框架
|
||
* @作者: 我在人间做废物
|
||
******************************************************************************/
|
||
#pragma once
|
||
#include "Control.h"
|
||
#include"label.h"
|
||
|
||
#define DISABLEDCOLOUR RGB(96, 96, 96) //禁用状态颜色
|
||
#define TEXTMARGINS_X 6
|
||
#define TEXTMARGINS_Y 4
|
||
constexpr int bordWith = 1; //边框宽度，用于快照恢复时的偏移计算
|
||
constexpr int bordHeight = 1; //边框高度，用于快照恢复时的偏移计算
|
||
|
||
class Button : public Control
|
||
{
|
||
std::string text; // 按钮上的文字
|
||
bool click; // 是否被点击
|
||
bool hover; // 是否被悬停
|
||
|
||
std::string cutText; // 切割后的文本
|
||
bool needCutText = true; // 是否需要切割文本
|
||
bool isUseCutText = false; // 是否使用切割文本
|
||
int padX = TEXTMARGINS_X; // 文本最小左右内边距
|
||
int padY = TEXTMARGINS_Y; // 文本最小上下内边距
|
||
|
||
COLORREF buttonTrueColor; // 按钮被点击后的颜色
|
||
COLORREF buttonFalseColor; // 按钮未被点击的颜色
|
||
COLORREF buttonHoverColor; // 按钮被鼠标悬停的颜色
|
||
COLORREF buttonBorderColor = RGB(0, 0, 0);// 按钮边框颜色
|
||
|
||
StellarX::ButtonMode mode; // 按钮模式
|
||
StellarX::ControlShape shape; // 按钮形状
|
||
|
||
StellarX::FillMode buttonFillMode = StellarX::FillMode::Solid; //按钮填充模式
|
||
StellarX::FillStyle buttonFillIma = StellarX::FillStyle::BDiagonal; //按钮填充图案
|
||
std::unique_ptr<IMAGE> buttonFileIMAGE; //按钮填充图像
|
||
|
||
std::function<void()> onClickCallback; //回调函数
|
||
std::function<void()> onToggleOnCallback; //TOGGLE模式下的回调函数
|
||
std::function<void()> onToggleOffCallback; //TOGGLE模式下的回调函数
|
||
|
||
StellarX::ControlText oldStyle = textStyle; // 按钮文字样式
|
||
int oldtext_width = -1;
|
||
int oldtext_height = -1;
|
||
int text_width = 0;
|
||
int text_height = 0;
|
||
|
||
// === Tooltip ===
|
||
bool tipEnabled = false; // 是否启用
|
||
bool tipVisible = false; // 当前是否显示
|
||
bool tipFollowCursor = false; // 是否跟随鼠标
|
||
bool tipUserOverride = false; // 是否用户自定义了tip文本
|
||
int tipDelayMs = 1000; // 延时(毫秒)
|
||
int tipOffsetX = 12; // 相对鼠标偏移
|
||
int tipOffsetY = 18;
|
||
ULONGLONG tipHoverTick = 0; // 开始悬停的时间戳
|
||
int lastMouseX = 0; // 最新鼠标位置(用于定位)
|
||
int lastMouseY = 0;
|
||
|
||
std::string tipTextClick; // NORMAL 模式下用
|
||
std::string tipTextOn; // click==true 时用
|
||
std::string tipTextOff; // click==false 时用
|
||
Label tipLabel; // 直接复用Label作为提示
|
||
|
||
public:
|
||
StellarX::ControlText textStyle; // 按钮文字样式
|
||
|
||
public:
|
||
|
||
//默认按钮颜色
|
||
Button(int x, int y, int width, int height, const std::string text,
|
||
StellarX::ButtonMode mode = StellarX::ButtonMode::NORMAL, StellarX::ControlShape shape = StellarX::ControlShape::RECTANGLE);
|
||
//自定义按钮未被点击和被点击颜色
|
||
Button(int x, int y, int width, int height, const std::string text,
|
||
COLORREF ct, COLORREF cf, StellarX::ButtonMode mode = StellarX::ButtonMode::NORMAL,
|
||
StellarX::ControlShape shape = StellarX::ControlShape::RECTANGLE);
|
||
//自定义按钮颜色和悬停颜色
|
||
Button(int x, int y, int width, int height, const std::string text,
|
||
COLORREF ct, COLORREF cf, COLORREF ch,
|
||
StellarX::ButtonMode mode = StellarX::ButtonMode::NORMAL, StellarX::ControlShape shape = StellarX::ControlShape::RECTANGLE);
|
||
//析构函数 释放图形指针内存
|
||
~Button();
|
||
|
||
//绘制按钮
|
||
void draw() override;
|
||
//按钮事件处理
|
||
bool handleEvent(const ExMessage& msg) override;
|
||
// 清理按钮的鼠标瞬时状态；用于父容器在 WM_MOUSEMOVE 短路后补做 hover/tooltip 收口。
|
||
bool clearTransientMouseState() override;
|
||
// Tooltip 可见时，按钮实际写像素范围不再等于按钮本体，需要把 Tooltip 矩形并入 coverage。
|
||
RECT getManagedRepaintCoverageRect() const override;
|
||
// Button 的持久绘制范围只包含本体；Tooltip 是临时浮层，不能污染兄弟控件背景快照。
|
||
RECT getManagedRepaintPersistentCoverageRect() const override;
|
||
|
||
// 设置 NORMAL 模式下的点击回调
|
||
void setOnClickListener(std::function<void()> callback);
|
||
// 设置 TOGGLE 模式下切换到打开状态时的回调
|
||
void setOnToggleOnListener(std::function<void()> callback);
|
||
// 设置 TOGGLE 模式下切换到关闭状态时的回调
|
||
void setOnToggleOffListener(std::function<void()> callback);
|
||
// 设置按钮模式（NORMAL / TOGGLE / DISABLED）
|
||
void setbuttonMode(StellarX::ButtonMode mode);
|
||
// 设置圆角矩形的圆角宽度
|
||
void setROUND_RECTANGLEwidth(int width);
|
||
// 设置圆角矩形的圆角高度
|
||
void setROUND_RECTANGLEheight(int height);
|
||
// 设置按钮填充模式
|
||
void setFillMode(StellarX::FillMode mode);
|
||
// 设置按钮图案填充样式
|
||
void setFillIma(StellarX::FillStyle ima);
|
||
// 设置按钮图像填充资源
|
||
void setFillIma(std::string imaName);
|
||
// 设置按钮边框颜色
|
||
void setButtonBorder(COLORREF Border);
|
||
// 设置按钮默认态颜色
|
||
void setButtonFalseColor(COLORREF color);
|
||
// 设置按钮文本（char* 重载）
|
||
void setButtonText(const char* text);
|
||
// 设置按钮文本（std::string 重载）
|
||
void setButtonText(std::string text);
|
||
// 设置按钮几何形状
|
||
void setButtonShape(StellarX::ControlShape shape);
|
||
// 直接设置按钮点击状态；NORMAL 设置为 true 时触发 onClick，TOGGLE 仅在状态变化时触发 on/off 回调
|
||
void setButtonClick(BOOL click);
|
||
|
||
// 查询按钮当前是否处于点击/选中状态
|
||
bool isClicked() const;
|
||
|
||
// 获取按钮文本
|
||
std::string getButtonText() const;
|
||
// 获取按钮文本的 C 字符串视图
|
||
const char* getButtonText_c() const;
|
||
// 获取按钮模式
|
||
StellarX::ButtonMode getButtonMode() const;
|
||
// 获取按钮形状
|
||
StellarX::ControlShape getButtonShape() const;
|
||
// 获取按钮填充模式
|
||
StellarX::FillMode getFillMode() const;
|
||
// 获取按钮图案填充样式
|
||
StellarX::FillStyle getFillIma() const;
|
||
// 获取按钮图像填充资源
|
||
IMAGE* getFillImaImage() const;
|
||
// 获取按钮边框颜色
|
||
COLORREF getButtonBorder() const;
|
||
// 获取按钮文字颜色
|
||
COLORREF getButtonTextColor() const;
|
||
// 获取按钮文字样式
|
||
StellarX::ControlText getButtonTextStyle() const;
|
||
public:
|
||
// === Tooltip API===
|
||
// 开关 Tooltip；关闭时只修改内部启用/显示状态，不负责智能选位
|
||
void enableTooltip(bool on) { tipEnabled = on; if (!on) tipVisible = false; }
|
||
// 设置 Tooltip 延时（毫秒）
|
||
void setTooltipDelay(int ms) { tipDelayMs = (ms < 0 ? 0 : ms); }
|
||
// 设置 Tooltip 是否跟随鼠标
|
||
void setTooltipFollowCursor(bool on) { tipFollowCursor = on; }
|
||
// 设置 Tooltip 偏移量；当前仅在 setTooltipFollowCursor(true) 时参与定位
|
||
void setTooltipOffset(int dx, int dy) { tipOffsetX = dx; tipOffsetY = dy; }
|
||
// 设置 Tooltip 的文字、背景和透明样式
|
||
void setTooltipStyle(COLORREF text, COLORREF bk, bool transparent);
|
||
// 设置 NORMAL 模式下 Tooltip 文本
|
||
void setTooltipText(const std::string& s) { tipTextClick = s; tipUserOverride = true; }
|
||
// 设置 TOGGLE 模式开/关两种状态下的 Tooltip 文本
|
||
void setTooltipTextsForToggle(const std::string& onText, const std::string& offText);
|
||
private:
|
||
// 初始化按钮内部状态、颜色和 Tooltip 默认样式
|
||
void initButton(const std::string text, StellarX::ButtonMode mode, StellarX::ControlShape shape, COLORREF ct, COLORREF cf, COLORREF ch);
|
||
// 判断鼠标是否在圆形按钮内
|
||
bool isMouseInCircle(int mouseX, int mouseY, int x, int y, int radius);
|
||
// 判断鼠标是否在椭圆按钮内
|
||
bool isMouseInEllipse(int mouseX, int mouseY, int x, int y, int width, int height);
|
||
//获取对话框类型
|
||
bool model() const override { return false; }
|
||
// 按当前按钮宽度和语言特征裁剪文本
|
||
void cutButtonText();
|
||
// 统一隐藏 Tooltip 并恢复其背景快照
|
||
void hideTooltip();
|
||
// 根据当前 click 状态选择 Tooltip 文案
|
||
void refreshTooltipTextForState();
|
||
};
|