Skip to content

README_zh_CN.md

Latest commit

 

History

History
129 lines (87 loc) · 4.02 KB

README_zh_CN.md

File metadata and controls

129 lines (87 loc) · 4.02 KB

im-control

另一个 Windows 上的 im-select 实现。

相对于 im-select 的优势 :

  • 支持几乎所有类型的窗口，包括控制台窗口和 UWP 窗口。
  • 允许通过输入法（即 TIP，文本输入处理器）的 GUID 切换输入法，而 im-select 只能切换语言。
  • 允许设置输入法的区段（compartments），包括：
    • 开关状态（例如中文输入法的中文/英文模式或日语输入法的假名/英文模式）。
    • 转换模式（例如英文/本地模式）。
  • 从 GUI 运行时，不会出现控制台窗口。
  • 其他功能，包括条件切换等。

工作原理

im-select 使用 ActivateKeyboardLayout 来切换键盘布局（语言），但这对某些类型的窗口不起作用，如控制台窗口和 UWP 窗口。

在现代 Windows 上，输入法由文本服务框架（TSF）管理。每个输入法由一个文本输入处理器（TIP）表示，并由一个全局唯一标识符（GUID）标识。可以使用 ITfInputProcessorProfileMgr::ActivateProfile 方法更改活动 TIP，该方法适用于几乎所有类型的窗口。

然而，TSF 要求调用者与前台窗口在同一线程中。为了有效地调用 TSF API，im-control 使用 SetWindowsHookEx 将 DLL 中的窗口过程注入前台窗口，然后向被注入的窗口发送一个自定义的窗口消息以调用 TSF 的 API。其他参数则通过共享内存传递给目标窗口。

使用这种方法，im-control 可以在目标窗口上调用所有 TSF API，例如用于设置区段的 ITfCompartment::SetValue。

编译与安装

请确保你已经安装了 CMake 和 Visual Studio。

cmake -S . -B build -G "Visual Studio 17 2022"
cmake --build build --config RelWithDebInfo

# 将输出的二进制文件放在 `bin` 目录下
cmake --install build --prefix bin --config RelWithDebInfo

用法

im-control [LANGID-{GUID}] [-k|--keyboard <open|close>] [-c|--conversion-mode <alphamumeric|native[,...]>] [-o FILE]
im-control -l|--list
im-control -v|--version

在运行前，请确保以下文件在同一目录下：

  • im-control.exe
  • im-control-injector-32.dll
  • im-control-injector-64.dll
  • im-control-hook-32.dll
  • im-control-hook-64.dll

使用 LANGID-{GUID} 切换输入法

# 英语（美国）
im-control 0409-{00000000-0000-0000-0000-000000000000}

# 中文（简体，中国）- 微软拼音
im-control 0804-{81D4E9C9-1D3B-41BC-9E6C-4B40BF79E35E}

# 小狼毫
im-control 0804-{A3F4CDED-B1E9-41EE-9CA6-7B4D0DE6CB0A}

输出为之前输入法的 LANGID-{GUID}。

设置键盘开关（对于中文输入法，此即中/英模式）

im-control -k open
im-control -k close

或者将以上组合起来

# 切换到小狼毫并开启中文输入模式
im-control 0804-{A3F4CDED-B1E9-41EE-9CA6-7B4D0DE6CB0A} -k open

条件切换

# 如果当前输入法是英语键盘，则切换到微软拼音，否则切换到小狼毫
im-control 0804-{81D4E9C9-1D3B-41BC-9E6C-4B40BF79E35E} --if 0409-{00000000-0000-0000-0000-000000000000} --else 0804-{A3F4CDED-B1E9-41EE-9CA6-7B4D0DE6CB0A}

列出所有输入法

im-control -l

获取当前输入法

im-control

版本历史

v0.5.0 (2025/10/24)

  • 实现 -l|--list 参数以列出所有输入法。

v0.4.0 (2025/10/18)

  • 编译为 Win32 GUI 应用以避免弹出控制台窗口，但从命令行运行时仍支持附到控制台。
  • 使用 Event 代替等待进程退出以减少等待时间。
  • 增加 -o|--output FILE 参数以将输出写入文件。
  • 增加 --if 和 --else 参数以支持条件切换。
  • 将 GUID 输出格式统一为大写字母。
  • 重构并改进注入器代码。
  • 改进日志记录。
  • 其他 bug 修复。

v0.3.0 (2025/10/14)

  • 改变命令行语法以更兼容现有工具。

v0.2.0 (2025/10/14)

  • 实现获取当前输入法功能。
  • 增加 -version --version 参数以显示版本信息。

v0.1.0 (2025/10/14)

第一个版本。