# new-emoji **Repository Path**: dulang104/new-emoji ## Basic Information - **Project Name**: new-emoji - **Description**: ElementUI封装 共91个组件 支持易语言/火山/C#/Python - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-05-13 - **Last Updated**: 2026-05-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # new_emoji `new_emoji` 是一个 Windows 原生 UI DLL，已提供易语言、Python ctypes、C# 对象式封装、WinForms .NET Framework 4.8 设计器和 C# P/Invoke 接入说明；同时通过统一的 `EU_` C API、`__stdcall` 调用约定和 UTF-8 字节数组文本参数，也可被 C/C++、Delphi、VB6/VBA、Go、Rust、Node.js FFI、Java JNA/JNI 等能够调用 Windows DLL 的语言接入。它采用单一 HWND + 纯 Direct2D / DirectWrite 渲染，把所有 UI 控件封装成 Element 组件，重点解决传统 GDI 子窗口在缩放和重绘时的闪烁问题，同时原生支持中文与彩色 emoji。 ## 特性 - 纯 Direct2D / DirectWrite 渲染，单窗口元素树，减少闪烁。 - 统一 `EU_` C API 导出，适合 DLL 方式集成。 - 文本参数统一使用 UTF-8 字节数组 + 长度，方便易语言传递 emoji 和 Unicode 文本。 - 支持 Win32 与 x64 Release 构建，其中 Win32 是易语言交付优先目标。 - 组件完成度：91 / 91，计划内组件均已完成独立中文 emoji 验证。 - 内置主题、DPI、键鼠交互、Set/Get 状态读回和 Python ctypes helper。 ## 快速入口 - [下载组件总览独立运行版 EXE](https://github.com/mosheng20205/new-emoji/releases) - [文档总览](docs/README.md) - [快速开始](docs/quick-start.md) - [构建说明](docs/build.md) - [API 约定](docs/api-conventions.md) - [组件文档导航](docs/components/README.md) - [AI 客户端使用指南](AI_USAGE.md) - [AI 技能入口](SKILL.md) - [AI SDK 文档](docs/ai/README.md) - [多语言接入矩阵](docs/ai/language-matrix.md) - [AI 完整 API manifest](docs/ai/api_manifest.full.json) - [多语言模板示例](examples/templates/) - [Python 示例说明](docs/examples/python.md) - [项目定位](#项目定位) - [适合谁使用](#适合谁使用) - [商业支持与付费定制](#商业支持与付费定制) - [联系作者](#联系作者) - [火山视窗简单示例](examples/火山/README.md) - [易语言 DLL 命令](DLL命令/易语言DLL命令.md)（易语言源码中不要直接写 emoji，应使用 UTF-8 字节集） - [C# DLL 命令](DLL命令/CSharp%20DLL命令.md) - [Python DLL 命令](DLL命令/Python%20DLL命令.md) - [贡献指南](CONTRIBUTING.md) - [更新日志](CHANGELOG.md) - [图片预览](#图片预览) - [许可证](LICENSE) ## AI 客户端接入 本项目提供面向 AI 客户端的多语言 SDK 入口，覆盖易语言、火山、C# 和 Python。让 AI 写 UI 时，建议先阅读 [AI 客户端使用指南](AI_USAGE.md)、[AI SDK 文档](docs/ai/README.md)、[多语言接入矩阵](docs/ai/language-matrix.md) 和 [完整 API manifest](docs/ai/api_manifest.full.json)，再从 [多语言模板示例](examples/templates/) 复制同语言模板开始改。 易语言有额外编码约束：易语言 IDE 源码中不要直接写 emoji 或特殊 Unicode 字符，否则可能变成问号；应使用 UTF-8 字节集 + 长度传给 DLL。详见 [易语言 UTF-8 字节集规则](docs/ai/e-language-encoding.md)。 ## 项目定位 `new_emoji` 是一个面向 Windows 桌面软件的原生 Emoji UI DLL，采用单一 HWND + Direct2D / DirectWrite 渲染架构，目标是解决传统 GDI 子窗口控件在拖拽、缩放和高 DPI 场景下容易闪烁的问题。 项目重点支持中文软件开发场景，适合用于易语言、C++、C#、Python 等程序调用，帮助开发者快速构建支持彩色 emoji、无闪烁、自绘标题栏和现代化控件的桌面界面。 ## 适合谁使用 `new_emoji` 适合以下开发者或项目： - 正在开发 Windows 桌面软件，希望界面支持彩色 emoji。 - 使用易语言 / 火山 / C++ / C# / Python 调用 DLL 构建界面。 - 遇到 GDI 子窗口控件拖拽、缩放时白底闪烁问题。 - 希望实现自绘标题栏、无边框窗口、现代化按钮和输入框。 - 想把旧版 Win32 / GDI 界面逐步迁移到 Direct2D 渲染架构。 ## 商业支持与付费定制 本项目保持开源，欢迎个人学习、研究和项目集成使用。 如果你希望将 `new_emoji` 用于商业软件，或者需要更深入的功能支持，可以联系作者提供付费服务，包括但不限于： - 易语言 / 火山 / C++ / C# / Python 项目接入指导。 - 自定义无边框窗口、标题栏、主题皮肤。 - 聊天窗口、客服窗口、emoji 输入框等界面定制。 - 旧版 GDI / Win32 界面迁移到 Direct2D 架构。 - 高 DPI 适配、闪烁问题排查、输入法与剪贴板问题处理。 - 企业项目私有组件开发与长期技术支持。 如果你的需求超出了开源版本的范围，欢迎通过 Issue 或作者联系方式沟通商业合作。 ## 联系作者 如果你需要商业定制、技术支持、项目合作，或者想交流 `new_emoji` 的使用方式，可以通过以下方式联系作者： - GitHub Issues：适合提交 bug、建议和公开讨论。 - 邮箱：`1098901025@qq.com` - QQ：`1098901025`（添加注明来意） - 微信：`zhx_ms`（添加注明来意） ## 组件总览 Demo 如果只想快速体验组件效果，可以前往 [Releases 页面](https://github.com/mosheng20205/new-emoji/releases) 下载 `new_emoji_component_gallery.exe`，双击即可运行，不需要安装 Python 环境。 运行完整组件总览： ```powershell python examples/python/component_gallery.py ``` 该 Demo 展示当前 90 个推荐组件；`EditBox` 作为兼容编辑内核保留 API 和文档，不再放入基础布局总览。Demo 包含中文界面、emoji 渲染、主题切换、分类分页、常见交互和复杂组件预览。默认窗口保持 180 秒，便于检查首屏尺寸、DPI 和交互效果。 如果只想短时间冒烟验证： ```powershell $env:NEW_EMOJI_GALLERY_SECONDS="12" python examples/python/component_gallery.py ``` 公共 Python ctypes 封装位于 `examples/python/new_emoji_ui.py`，普通示例建议优先复用它，而不是从测试目录导入 helper。 ## 最短 Python 示例 ```python import ctypes from ctypes import wintypes import sys sys.path.insert(0, "examples/python") import new_emoji_ui as ui hwnd = ui.create_window("✨ new_emoji 示例", 240, 120, 820, 560) root = ui.create_container(hwnd, 0, 0, 0, 780, 500) ui.create_text(hwnd, root, "你好，new_emoji 🚀", 32, 32, 360, 40) ui.create_button(hwnd, root, "✅", "确认操作", 32, 96, 160, 42) ui.dll.EU_ShowWindow(hwnd, 1) user32 = ctypes.windll.user32 msg = wintypes.MSG() while user32.GetMessageW(ctypes.byref(msg), None, 0, 0): user32.TranslateMessage(ctypes.byref(msg)) user32.DispatchMessageW(ctypes.byref(msg)) ``` > Python 位数必须和 DLL 位数一致：32 位 Python 加载 Win32 DLL，64 位 Python 加载 x64 DLL。 ## 最短 C# 示例 ```csharp using NewEmoji; class Program { static void Main() { var win = EmojiWindow.Create("✨ new_emoji C# 示例", 860, 560); var root = win.CreateContainer(0, 0, 820, 500); root.AddText("欢迎使用 new_emoji C# 界面库 🚀", 32, 32, 420, 40); root.AddButton("✅", "确认操作", 32, 96, 160, 42) .Clicked += (_, _) => win.ShowMessage("操作成功 🎉", EmojiMessageType.Success); win.Show(); EmojiApplication.Run(); } } ``` 仓库已提供可直接运行的最短 C# 示例：[MinimalExample.cs](examples/Csharp/MinimalExample.cs) 和 [MinimalExample.csproj](examples/Csharp/MinimalExample.csproj)。已验证 `dotnet build examples\Csharp\MinimalExample.csproj -c Release` 可成功构建；运行方式： ```powershell dotnet run -c Release --project examples\Csharp\MinimalExample.csproj ``` > C# 推荐使用 [NewEmoji 封装库](bindings/csharp/NewEmoji)。封装库会按当前进程位数加载 x64 / Win32 DLL；完整底层声明仍可查 [C# DLL 命令](DLL命令/CSharp%20DLL命令.md)。 ## C# WinForms .NET Framework 4.8 与设计器 仓库已提供 WinForms `.NET Framework 4.8` 示例： ```powershell dotnet run --project examples\CsharpNet48\MinimalWinFormsExample.csproj ``` 也提供独立 WinForms `.NET Framework 4.8` 可视化设计器 MVP： ```powershell dotnet run --project bindings\csharp\NewEmoji.Designer.WinForms48\NewEmoji.Designer.WinForms48.csproj ``` 设计器支持拖入基础组件、编辑中文/emoji 文案和坐标尺寸、保存 JSON、导出 C# `.NET Framework 4.8` 项目并构建运行。布局模型和代码生成位于 [NewEmoji.Design](bindings/csharp/NewEmoji.Design)。 ## 火山视窗示例入口 仓库已提供火山视窗 x64 简单窗口 demo：[examples/火山](examples/火山)。打开 [NewEmojiSimpleDemo_x64.vsln](examples/火山/NewEmojiSimpleDemo_x64.vsln) 即可查看源码；示例通过 `@视窗.输入 = "new_emoji.dll"` 和 `@输出名 = "EU_..."` 直接导入 DLL，演示窗口、面板、文本、编辑框、按钮与点击回调，界面文案均为中文并包含 emoji。 ## 最短易语言示例 / DLL 命令入口说明 易语言 IDE 可能无法可靠保存 emoji 和 Unicode 特殊符号，所以示例不在源码字符串里直接写 emoji；窗口标题、正文和按钮文字都用 UTF-8 字节集 + 长度传给 DLL。完整命令表见 [易语言 DLL 命令](DLL命令/易语言DLL命令.md)。 ```text .DLL命令 创建窗口, 整数型, "new_emoji.dll", "EU_CreateWindow" .参数 标题字节集指针, 整数型 .参数 标题长度, 整数型 .参数 X坐标, 整数型 .参数 Y坐标, 整数型 .参数 宽度, 整数型 .参数 高度, 整数型 .参数 标题栏颜色, 整数型 .DLL命令 创建容器, 整数型, "new_emoji.dll", "EU_CreateContainer" .参数 窗口句柄, 整数型 .参数 父元素ID, 整数型 .参数 X坐标, 整数型 .参数 Y坐标, 整数型 .参数 宽度, 整数型 .参数 高度, 整数型 .DLL命令 创建文本, 整数型, "new_emoji.dll", "EU_CreateText" .参数 窗口句柄, 整数型 .参数 父元素ID, 整数型 .参数 文本字节集指针, 整数型 .参数 文本长度, 整数型 .参数 X坐标, 整数型 .参数 Y坐标, 整数型 .参数 宽度, 整数型 .参数 高度, 整数型 .DLL命令 创建按钮, 整数型, "new_emoji.dll", "EU_CreateButton" .参数 窗口句柄, 整数型 .参数 父元素ID, 整数型 .参数 Emoji字节集指针, 整数型 .参数 Emoji长度, 整数型 .参数 文本字节集指针, 整数型 .参数 文本长度, 整数型 .参数 X坐标, 整数型 .参数 Y坐标, 整数型 .参数 宽度, 整数型 .参数 高度, 整数型 .DLL命令 显示窗口, , "new_emoji.dll", "EU_ShowWindow" .参数 窗口句柄, 整数型 .参数 是否显示, 整数型 .DLL命令 运行消息循环, 整数型, "new_emoji.dll", "EU_RunMessageLoop" ``` ```text '. 无易语言窗体时可直接放到 _启动子程序 中；运行消息循环会阻塞到 new_emoji 窗口关闭。 .局部变量 窗口句柄, 整数型 .局部变量 根容器, 整数型 .局部变量 标题, 字节集 .局部变量 正文, 字节集 .局部变量 按钮Emoji, 字节集 .局部变量 按钮文字, 字节集 '. 标题 UTF-8 字节集：sparkle emoji + " new_emoji " + 中文 示例 标题 ＝ { 226, 156, 168, 32, 110, 101, 119, 95, 101, 109, 111, 106, 105, 32, 231, 164, 186, 228, 190, 139 } '. 正文 UTF-8 字节集：中文 你好， + "new_emoji " + rocket emoji 正文 ＝ { 228, 189, 160, 229, 165, 189, 239, 188, 140, 110, 101, 119, 95, 101, 109, 111, 106, 105, 32, 240, 159, 154, 128 } '. 按钮 emoji UTF-8 字节集：check mark emoji 按钮Emoji ＝ { 226, 156, 133 } '. 按钮文字 UTF-8 字节集：中文 确认操作 按钮文字 ＝ { 231, 161, 174, 232, 174, 164, 230, 147, 141, 228, 189, 156 } 窗口句柄 ＝ 创建窗口 (取变量数据地址 (标题), 取字节集长度 (标题), 240, 120, 820, 560, -13795841) 根容器 ＝ 创建容器 (窗口句柄, 0, 0, 0, 780, 500) 创建文本 (窗口句柄, 根容器, 取变量数据地址 (正文), 取字节集长度 (正文), 32, 32, 360, 40) 创建按钮 (窗口句柄, 根容器, 取变量数据地址 (按钮Emoji), 取字节集长度 (按钮Emoji), 取变量数据地址 (按钮文字), 取字节集长度 (按钮文字), 32, 96, 160, 42) 显示窗口 (窗口句柄, 1) 运行消息循环 () ``` ## 构建 ```powershell & "C:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild\Current\Bin\MSBuild.exe" .\new_emoji.sln /p:Configuration=Release /p:Platform=Win32 & "C:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild\Current\Bin\MSBuild.exe" .\new_emoji.sln /p:Configuration=Release /p:Platform=x64 ``` 详细要求见 [构建说明](docs/build.md)。 ## 文档维护 当某个组件新增、删除、重命名或修改导出 API 时，必须同步更新该组件文档、组件导航、`docs/api-index.md`、Python ctypes/helper，以及 `DLL命令/易语言DLL命令.md`、`DLL命令/CSharp DLL命令.md`、`DLL命令/Python DLL命令.md`，避免开源用户看到过期接口。 ## 图片预览 截图较多，默认折叠；点击下方标题可展开查看组件总览截图。
展开 90 张组件截图

Affix Alert Anchor Aside Autocomplete Avatar Backtop Badge BarChart Border Breadcrumb BulletProgress Button Calendar Card Carousel Cascader Checkbox Collapse ColorPicker Container DatePicker DateRangePicker DateTimePicker DateTimeRange Descriptions Dialog Divider DonutChart Drawer Dropdown ElementPopup Empty Footer Gauge Header Icon Image InfiniteScroll InfoBox Input InputGroup InputNumber InputTag KPI Card Layout LineChart Link Loading Main Mentions Menu Message MessageBox Notification PageHeader Pagination Panel Popconfirm Popover Progress Radio Rate Result RingProgress Segmented Select SelectV2 Skeleton Slider Space Statistic StatusDot Steps Switch Table Tabs Tag Text Timeline TimePicker TimeRange TimeSelect Tooltip Tour Transfer Tree TreeSelect Trend Upload Watermark

## 许可证 本项目使用 [MIT License](LICENSE) 开源。