64 lines
1.7 KiB
Markdown
64 lines
1.7 KiB
Markdown
# TsfEditControl
|
||
|
||
一个基于 Win32 TSF 的编辑控件实验工程，使用 Direct2D / DirectWrite 负责绘制。项目里把文本输入、组合串显示、候选框定位和基础编辑逻辑放进了控件本身，demo 只是一个最小宿主。
|
||
|
||
## 功能
|
||
|
||
- Direct2D / DirectWrite 文本渲染
|
||
- TSF 输入法接入
|
||
- preedit / display attribute 绘制
|
||
- 候选框位置上报
|
||
- 软换行
|
||
- 选区、插入点和鼠标命中
|
||
- 独立 demo 程序
|
||
|
||
## 目录
|
||
|
||
- `include/TsfD2DTextBox.h`：对外头文件
|
||
- `src/`：控件实现和 TSF 相关代码
|
||
- `demo/TsfD2DTextBoxDemo.cpp`：最小示例程序
|
||
- `CMakeLists.txt`：顶层 CMake 配置
|
||
- `CMakePresets.json`：VS2022 + vcpkg preset
|
||
- `vcpkg.json`：依赖声明
|
||
|
||
## 构建
|
||
|
||
如果本机已经装好了 vcpkg，并且 preset 里的路径配置可用，可以直接执行：
|
||
|
||
```powershell
|
||
cmake --preset vcpkg
|
||
cmake --build --preset debug
|
||
```
|
||
|
||
生成的 demo 默认位于：
|
||
|
||
```text
|
||
build/bin/Debug/TsfEditControlDemo.exe
|
||
```
|
||
|
||
## 生成目标
|
||
|
||
- `TsfEditControl`：静态库
|
||
- `TsfD2DTextBox`：兼容旧命名的别名 target
|
||
- `TsfEditControlDemo`：demo 可执行文件
|
||
|
||
## 命名说明
|
||
|
||
对外类型名暂时还是 `TsfD2DTextBox`，主要是为了不动现有接口。工程名和 target 已经改成了 `TsfEditControl`，后面如果要统一命名，再一起收口文件名、类名和 demo 名称。
|
||
|
||
## 脚本
|
||
|
||
`scripts/` 目录提供了几个常用脚本：
|
||
|
||
- `./scripts/configure.ps1`：执行 CMake configure
|
||
- `./scripts/build.ps1`：配置并编译，默认 `Debug`
|
||
- `./scripts/run-demo.ps1`：配置、编译并启动 demo
|
||
|
||
示例：
|
||
|
||
```powershell
|
||
./scripts/build.ps1
|
||
./scripts/build.ps1 -Configuration Release
|
||
./scripts/run-demo.ps1
|
||
```
|