EzUI

EzUI 是一个基于原生 Win32 消息机制和 Direct2D 的高性能桌面 UI 框架，具备强大的弹性布局、伪类样式支持和控件系统，目标是提供如 Web 前端般灵活、直观的界面开发体验。

🚀 支持高 DPI、分层窗口、响应式布局、CSS 风格皮肤、GIF 动画、控件组合与继承机制。未来将支持跨平台 2D 图形库扩展。

---

✨ 框架特色

• 🪱 基于 Win32 消息机制：轻量、无依赖，逻辑控件系统拦截并下发鼠标键盘消息
• 🎨 2D 图形绘制：当前基于 Direct2D 绘图，具备高性能、高分辨率适配能力。
• 🧹 弹性布局系统：支持自动宽高、自适应布局，开发体验类比前端 Flex 设计。
• 🎭 伪类 CSS 支持：支持 hover、active、checked 等状态样式，类选择器、ID 选择器、组合选择器等完整选择器系统。
• 🌟 控件组合系统：Label、Button、TextBox、CheckBox、RadioButton 等丰富控件可自由组合构建 UI。
• 💡 事件系统：支持事件冒泡机制，可实现事件捕获与穿透。
• 🧩 高 DPI 适配：框架自动处理 DPI 缩放与坐标换算，支持多显示器高分屏。
• 🪪 多种窗口类型支持：
  • Window：经典边框窗口 windows自动发送WM_PAINT消息绘制
  • BorderlessWindow：无边框、带阴影 windows自动发送WM_PAINT消息绘制
  • LayeredWindow：分层透明窗口，支持异形与实时重绘 手动发送 WM_PAINT消息进行绘制
  • PopupWindow：失焦自动关闭的弹出窗口，适用于菜单等

---

📆 快速开始

1. 下载源码

git clone https://github.com/NewYoungCode/EzUI.git

2. 安装 CMake

请前往 CMake 官网 下载安装。

3. 构建与运行

• 构建 32 位项目：

build.bat

• 构建 64 位项目：

build64.bat

---

📀 使用说明

🏁 程序入口

请在 WinMain 函数中创建 Application 实例并调用 app.Exec() 以启动消息循环：

#include <Windows.h>
#include "EzUI/UIManager.h"
#include "Ezui/Window.h"
#include "Ezui/Application.h"

using namespace ezui;

class TestForm :public Window {
private:
	UIManager umg;//ui管理器
public:
	TestForm() :Window(800, 600) {
		//umg.LoadXmlFile("res/form.htm");//从文件中加载xml界面
		umg.LoadXmlData("<vbox> <label text=\"hello world\"></label> </vbox>");//从内存中加载布局
		umg.SetupUI(this);//设置ui
	}
	virtual ~TestForm() {
	}
	virtual void OnClose(bool& bClose) override {
		int result = ::MessageBoxW(frm.Hwnd(), L"要退出程序吗？", L"提示", MB_YESNO | MB_ICONQUESTION);
		if (result == IDYES) {
			Application::Exit(0);//当窗口关闭时 整个程序退出
		} else {
			bClose=false;  // 用户点击了“否” 此标志设置为false将不会关闭
		}
	}
};

//程序入口;
int APIENTRY wWinMain(_In_ HINSTANCE hInstance,
	_In_opt_ HINSTANCE hPrevInstance,
	_In_ LPWSTR    lpCmdLine,
	_In_ int       nCmdShow)
{

	Application app;

	TestForm testForm;
	testForm.SetText(L"我是测试窗口");
	testForm.Show(nCmdShow);

	return app.Exec();
};

🧱 控件与组件列表（部分）

• Application：EzUI 应用入口与消息循环控制器
• Window：经典 Win32 边框窗口
• BorderlessWindow：无边框带阴影窗口
• LayeredWindow：支持透明和异形的分层窗口
• PopupWindow：失焦自动关闭的弹出窗口
• Control：所有控件基础类，封装鼠标命中、事件分发和重绘逻辑
• Label：文字标签控件
• Button：标准按钮控件
• TextBox：文本输入框
• CheckBox / RadioButton：复选框 / 单选框控件
• PictureBox：图片显示控件，支持 GIF
• ComboBox：下拉框控件
• Menu：菜单支持
• NotifyIcon：托盘图标支持
• ScrollBar / HScrollBar / VScrollBar：滚动条组件
• HLayout / VLayout：水平/垂直布局容器
• HListView / VListView：横向/纵向列表视图容器
• TileListView：瓦片式列表视图
• TabLayout：选项卡切换容器
• Spacer：空隙组件，占位用
• ShadowBox：为无边框窗口提供窗口阴影
• IFrame：内嵌页面控件，功能类似 Web 前端中的 <iframe>
• UIDef：框架内使用的宏定义集合
• UIManager：UI 样式与资源统一管理
• UISelector：选择器匹配系统，实现类选择器、链式查询控件
• UIString / tinystr.h / tinyxml.h：字符串处理与 XML 配置解析支持
• RenderTypes：绘图相关类型定义（颜色、对齐方式等）
• Direct2DRender：Direct2D 绘图实现类
• Bitmap：图像资源封装
• Resource.h：自定义资源管理类（非 VS rc 文件），用于手动加载与管理框架资源
• Timer / Task：定时与异步任务处理辅助类
• EzUI.h：框架主接口头文件，定义事件类、枚举、全局资源等核心结构
• Animation.h：类似于QT的那种过渡动画

🎨 样式示例

#submitBtn {
    width: 100px; /*静态样式时支持调整大小*/
    height: 30px; /*静态样式时支持调整大小*/
    background-color: #0078d7;
}

#submitBtn:hover {
    background-color: #005a9e;
}

.classA .classB {  /*多选择器*/
    color:#ffffff;
}

label{  /*标签选择器*/
    color:#ffffff;
}

.check:checked {
    border:1px;
    border-radius:10px;
    border-color: #005a9e;
}

---

🔧 调试技巧

• 在 Debug 模式下运行时，按下 F11 可实时查看布局信息，高亮显示控件边界。

---

🧬 开发理念

• “一切皆控件”：无 UI 描述文件，纯代码式组件组合；
• “CSS 驱动视觉”：结构和样式分离；
• “面向前端思维”：布局、交互风格向 Web 靠拟；
• “跨平台可拟扩”：绘图模块可替换（未来可能会使用跨平台图形库）；

---

📄 License