XCEngine/docs/api/XCEngine/Input/InputManager/IsKeyPressed.md

# InputManager::IsKeyPressed

查询一个键是否在本帧刚被按下。

```cpp
bool IsKeyPressed(KeyCode key) const;
```

## 行为说明

当前实现判断条件是：

```cpp
m_keyDownThisFrame[index] && !m_keyDownLastFrame[index]
```

所以它表示的是“从上一帧到当前帧的按下边沿”。要得到正确结果，必须保证 [Update](Update.md) 每帧只在固定边界调用一次。

## 参数

- `key` - 要查询的键。

## 返回值

- `bool` - 当前帧是否刚按下。

## 示例

```cpp
if (XCEngine::Input::InputManager::Get().IsKeyPressed(XCEngine::Input::KeyCode::Space)) {
    // ...
}
```

## 相关文档

- [返回类型总览](InputManager.md)
- [Update](Update.md)
- [IsKeyDown](IsKeyDown.md)