# 输入法状态

:::tips
**⚠️ 注意事项**

- 此功能仅对一些输入法有效。详见本文末尾的说明。
:::

:::info
**ℹ️ 提示**

- 本模块的功能仅在输入法开启的情况下有效。
- 输入法状态是作用到“前台窗口”进程的，使用的时候确保目标窗口以及窗口的某个输入框具有焦点。
:::
<a name="O9U51"></a>
# 概述
获取或改变输入法的中英文状态。<br />通常在发送热键或文本之前可以使用此模块将输入法切换到英文状态，从而避免发送到窗口的内容被输入法影响。

![image.png](https://cdn.nlark.com/yuque/0/2019/png/272392/1571918971798-51336b53-18ba-4e43-abca-f70aff6791a4.png#averageHue=%23fbfafa&height=268&id=fL3Vn&originHeight=536&originWidth=1180&originalType=binary&ratio=1&rotation=0&showTitle=false&size=47715&status=done&style=none&title=&width=590)

<a name="axczK"></a>
# 参数
【操作】要执行的操作类型：

- 切换为英文：将输入法切换为英文状态。
- 切换为中文：将输入法切换到中文状态（如果是其他文字如日文/韩文等，切换到对应的语种）。
- 恢复：恢复输入法的中英文状态。（恢复到首次使用本模块之前的状态）
- 是否为中文状态：获取当前的输入法状态是否为中文（或输入法对应的其他语种）。

<a name="k61tE"></a>
# 故障排除
切换输入法为兼容模式可能解决部分问题。<br />[🔗 相关链接：微软拼音输入法被置顶的界面遮挡](https://getquicker.net/KC/Kb/Article/920)


<a name="MymNi"></a>
## 一些输入法的支持情况测试结果

**2023-12-19日测试结果**<br />操作系统版本：Windows11 22H2 （22581.100）

- 搜狗输入法11.1.0.5032：**支持**；
- QQ拼音输入法6.6.6304.400：**支持**；
- 小狼毫（Rime）输入法0.15.0.0：**支持**；
- 系统内置微软输入法：**不支持**；
- 微软输入法开启“使用以前版本的微软拼音输入法”选项(参见下图)后：**支持**；

![image.png](https://cdn.nlark.com/yuque/0/2022/png/272392/1648650779934-c74152e0-fdfe-46a6-b2aa-13d96b6da9c2.png#averageHue=%23f0f0f0&clientId=u55b7d19b-0ea5-4&from=paste&height=958&id=u35b0808a&originHeight=1581&originWidth=2184&originalType=binary&ratio=1&rotation=0&showTitle=false&size=141501&status=done&style=none&taskId=u4a29bf55-d167-4846-915d-0faac61eb4a&title=&width=1323.6362871322465)