Codex
162 lines
6.6 KiB
C++
162 lines
6.6 KiB
C++
/*******************************************************************************
|
||
* @类: Control
|
||
* @摘要: 所有控件的抽象基类，定义通用接口和基础功能
|
||
* @描述:
|
||
* 提供控件的基本属性和方法，包括位置、尺寸、重绘标记等。
|
||
* 实现绘图状态保存和恢复机制，确保控件绘制不影响全局状态。
|
||
* 同时提供“事件阶段登记、收口阶段统一提交”的托管重绘基础接口。
|
||
*
|
||
* @特性:
|
||
* - 定义控件基本属性（坐标、尺寸、脏标记）
|
||
* - 提供绘图状态管理（saveStyle/restoreStyle）
|
||
* - 声明纯虚接口（draw、handleEvent等）
|
||
* - 禁止移动语义，禁止拷贝语义
|
||
*
|
||
* @使用场景: 作为所有具体控件类的基类，不直接实例化
|
||
* @所属框架: 星垣(StellarX) GUI框架
|
||
* @作者: 我在人间做废物
|
||
******************************************************************************/
|
||
#pragma once
|
||
#ifndef _WIN32_WINNT
|
||
#define _WIN32_WINNT 0x0600
|
||
#endif
|
||
#ifndef WINVER
|
||
#define WINVER _WIN32_WINNT
|
||
#endif
|
||
#include <windows.h>
|
||
#include <vector>
|
||
#include <memory>
|
||
#include <easyx.h>
|
||
#undef MessageBox
|
||
#include <iostream>
|
||
#include <string>
|
||
#include <functional>
|
||
#include "CoreTypes.h"
|
||
|
||
class Window;
|
||
|
||
class Control
|
||
{
|
||
protected:
|
||
std::string id; // 控件ID
|
||
int localx, x, localy, y; // 左上角坐标
|
||
int localWidth, width, localHeight, height; // 控件尺寸
|
||
Control* parent = nullptr; // 父控件
|
||
Window* hostWindow = nullptr; // 宿主窗口（顶层由 Window 注入，子控件可沿 parent 回溯）
|
||
bool dirty = true; // 是否重绘
|
||
bool show = true; // 是否显示
|
||
bool eventVisualChanged = false; // 最近一次 handleEvent 是否真的引发了视觉变化（用于上层判断是否需要登记重绘）
|
||
|
||
/* == 布局模式 == */
|
||
StellarX::LayoutMode layoutMode = StellarX::LayoutMode::Fixed; // 布局模式
|
||
StellarX::Anchor anchor_1 = StellarX::Anchor::Top; // 锚点
|
||
StellarX::Anchor anchor_2 = StellarX::Anchor::Right; // 锚点
|
||
|
||
/* == 背景快照 == */
|
||
std::unique_ptr<IMAGE> saveBkImage;
|
||
int saveBkX = 0, saveBkY = 0; // 快照保存起始坐标
|
||
int saveWidth = 0, saveHeight = 0; // 快照保存尺寸
|
||
bool hasSnap = false; // 当前是否持有有效快照
|
||
|
||
StellarX::RouRectangle rouRectangleSize; // 圆角矩形椭圆宽度和高度
|
||
|
||
LOGFONT currentFont{}; // 保存当前字体样式和颜色
|
||
COLORREF currentColor{};
|
||
COLORREF currentBkColor{}; // 保存当前填充色
|
||
COLORREF currentBorderColor{}; // 边框颜色
|
||
LINESTYLE currentLineStyle{}; // 保存当前线型
|
||
|
||
Control(const Control&) = delete;
|
||
Control& operator=(const Control&) = delete;
|
||
Control(Control&&) = delete;
|
||
Control& operator=(Control&&) = delete;
|
||
|
||
Control() : localx(0), x(0), localy(0), y(0), localWidth(100), width(100), height(100), localHeight(100) {}
|
||
Control(int x, int y, int width, int height)
|
||
: localx(x), x(x), localy(y), y(y), localWidth(width), width(width), height(height), localHeight(height) {
|
||
}
|
||
public:
|
||
|
||
virtual ~Control()
|
||
{
|
||
discardBackground();
|
||
}
|
||
protected:
|
||
// 向上请求重绘：普通路径交给父容器，托管路径则登记到 Window
|
||
virtual void requestRepaint(Control* parent);
|
||
// 根控件/无父时触发重绘
|
||
virtual void onRequestRepaintAsRoot();
|
||
// 当前是否处于 Window 托管分发阶段；若为真，则不应立即画
|
||
bool shouldDeferManagedRepaint() const;
|
||
protected:
|
||
//保存背景快照
|
||
virtual void saveBackground(int x, int y, int w, int h);
|
||
// putimage 回屏
|
||
virtual void restBackground();
|
||
// 回贴旧背景并释放快照
|
||
void discardBackground();
|
||
public:
|
||
// 仅作废快照，不回贴旧背景
|
||
void invalidateBackgroundSnapshot();
|
||
//“纯作废快照 + 标脏”，不再在 resize 路径里回贴旧背景
|
||
virtual void onWindowResize();
|
||
// 获取位置和尺寸
|
||
int getX() const { return x; }
|
||
int getY() const { return y; }
|
||
int getWidth() const { return width; }
|
||
int getHeight() const { return height; }
|
||
int getRight() const { return x + width; }
|
||
int getBottom() const { return y + height; }
|
||
|
||
int getLocalX() const { return localx; }
|
||
int getLocalY() const { return localy; }
|
||
int getLocalWidth() const { return localWidth; }
|
||
int getLocalHeight() const { return localHeight; }
|
||
int getLocalRight() const { return localx + localWidth; }
|
||
int getLocalBottom() const { return localy + localHeight; }
|
||
|
||
virtual void setX(int x) { this->x = x; dirty = true; }
|
||
virtual void setY(int y) { this->y = y; dirty = true; }
|
||
virtual void setWidth(int width) { this->width = width; dirty = true; }
|
||
virtual void setHeight(int height) { this->height = height; dirty = true; }
|
||
public:
|
||
|
||
virtual void draw() = 0;
|
||
virtual bool handleEvent(const ExMessage& msg) = 0;//返回true代表事件已消费
|
||
//设置是否显示
|
||
virtual void setIsVisible(bool show);
|
||
//设置父容器指针
|
||
void setParent(Control* parent) { this->parent = parent; }
|
||
//设置宿主窗口（通常仅由顶层 Window/对话框注入）
|
||
virtual void setHostWindow(Window* host) { this->hostWindow = host; }
|
||
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; }
|
||
//检查控件是否可见
|
||
bool IsVisible() const { return show; };
|
||
//获取控件id
|
||
std::string getId() const { return id; }
|
||
//检查是否为脏
|
||
bool isDirty() { return dirty; }
|
||
//获取控件最近一次事件处理是否引发了视觉变化
|
||
bool didEventAffectVisual() const { return eventVisualChanged; }
|
||
//用来检查对话框是否模态，其他控件不用实现
|
||
virtual bool model()const = 0;
|
||
//布局
|
||
void setLayoutMode(StellarX::LayoutMode layoutMode_);
|
||
void setAnchor(StellarX::Anchor anchor_1, StellarX::Anchor anchor_2);
|
||
StellarX::Anchor getAnchor_1() const;
|
||
StellarX::Anchor getAnchor_2() const;
|
||
StellarX::LayoutMode getLayoutMode() const;
|
||
protected:
|
||
void saveStyle();
|
||
void restoreStyle();
|
||
void resetEventVisualChanged() { eventVisualChanged = false; }
|
||
void markEventVisualChanged(bool changed = true) { eventVisualChanged = changed; }
|
||
};
|