Windows Input Simulator 技术文档

1. 安装指南

1.1 使用 NuGet 安装

你可以通过 NuGet 包管理器来安装 InputSimulator 包。在 Visual Studio 中，打开你的项目，然后使用以下命令安装：

Install-Package InputSimulator

1.2 手动安装

如果你不想使用 NuGet，也可以手动下载源代码并将其添加到你的项目中。你可以从 GitHub 项目页面 下载源代码。

2. 项目使用说明

Windows Input Simulator 是一个用于模拟键盘和鼠标输入的 C# 库。它通过调用 Win32 的 SendInput 方法来实现输入模拟。该库适用于 WPF、Windows Forms 和控制台应用程序。

2.1 基本功能

• 模拟按键输入：可以模拟单个按键、组合键（如 Ctrl+C）、以及复杂的组合键（如 Ctrl+Alt+Shift+Esc+K）。
• 模拟文本输入：可以直接模拟文本输入，例如输入 "Hello World!"。
• 获取按键状态：可以检查特定按键（如 Shift、Caps Lock）的状态。

2.2 示例代码

2.2.1 模拟单个按键

public void PressTheSpacebar()
{
  InputSimulator.SimulateKeyPress(VirtualKeyCode.SPACE);
}

2.2.2 模拟组合键

public void SimulateSomeModifiedKeystrokes()
{
  // 模拟 Ctrl+C
  InputSimulator.SimulateModifiedKeyStroke(VirtualKeyCode.CONTROL, VirtualKeyCode.VK_C);

  // 模拟 Ctrl+K+C
  InputSimulator.SimulateModifiedKeyStroke(VirtualKeyCode.CONTROL, new [] {VirtualKeyCode.VK_K, VirtualKeyCode.VK_C});

  // 模拟 Ctrl+Alt+Shift+Esc+K
  InputSimulator.SimulateModifiedKeyStroke(
    new[] { VirtualKeyCode.CONTROL, VirtualKeyCode.MENU, VirtualKeyCode.SHIFT },
    new[] { VirtualKeyCode.ESCAPE, VirtualKeyCode.VK_K });
}

2.2.3 模拟文本输入

public void SayHello()
{
  InputSimulator.SimulateTextEntry("Say hello!");
}

2.2.4 获取按键状态

public void GetKeyStatus()
{
  // 检查 Shift 键是否按下
  var isShiftKeyDown = InputSimulator.IsKeyDown(VirtualKeyCode.SHIFT);

  // 检查 Caps Lock 是否开启
  var isCapsLockOn = InputSimulator.IsTogglingKeyInEffect(VirtualKeyCode.CAPITAL);
}

3. 项目 API 使用文档

3.1 主要 API 方法

• SimulateKeyPress(VirtualKeyCode key)：模拟单个按键的按下和释放。
• SimulateKeyDown(VirtualKeyCode key)：模拟按键按下。
• SimulateKeyUp(VirtualKeyCode key)：模拟按键释放。
• SimulateModifiedKeyStroke(VirtualKeyCode modifier, VirtualKeyCode key)：模拟组合键，如 Ctrl+C。
• SimulateTextEntry(string text)：模拟文本输入。
• IsKeyDown(VirtualKeyCode key)：检查特定按键是否按下。
• IsTogglingKeyInEffect(VirtualKeyCode key)：检查特定切换键（如 Caps Lock）是否开启。

3.2 VirtualKeyCode 枚举

VirtualKeyCode 是一个枚举类型，包含了所有可模拟的虚拟键码。你可以使用这些键码来指定要模拟的按键。

4. 项目安装方式

4.1 通过 NuGet 安装

Install-Package InputSimulator

4.2 手动下载源代码

你可以从 GitHub 项目页面 下载源代码，并将其添加到你的项目中。

---

通过以上文档，你应该能够顺利安装和使用 Windows Input Simulator 项目。如果你有任何问题，请参考项目文档或联系开发者。