docs: rebuild Input API content

This commit is contained in:
2026-03-26 17:39:53 +08:00
parent ec4edb2689
commit ce2eee32e3
54 changed files with 1108 additions and 941 deletions

View File

@@ -1,34 +1,29 @@
# InputModule::HandleMessage
公开方法,详见头文件声明
处理一条平台窗口消息并把它翻译成引擎输入事件
```cpp
virtual void HandleMessage(size_t hwnd, unsigned int msg, size_t wParam, size_t lParam) = 0;
```
该方法声明于 `XCEngine/Input/InputModule.h`,当前页面用于固定 `InputModule` 类目录下的方法级 canonical 路径。
## 行为说明
**参数:**
- `hwnd` - 参数语义详见头文件声明。
- `msg` - 参数语义详见头文件声明。
- `wParam` - 参数语义详见头文件声明。
- `lParam` - 参数语义详见头文件声明。
这是平台桥接层最关键的接口。当前抽象直接暴露原始整型参数,而不是包装成统一事件对象,目的是让平台实现保留足够低层的解释空间。
**返回:** `void` - 无返回值
在 Windows 路径中,这个方法会处理 `WM_KEYDOWN``WM_MOUSEMOVE``WM_CHAR` 等消息,然后调用 `InputManager::Process*`
**示例:**
## 参数
```cpp
#include <XCEngine/Input/InputModule.h>
- `hwnd` - 平台窗口句柄或等价标识。
- `msg` - 平台消息类型。
- `wParam` - 平台消息参数 1。
- `lParam` - 平台消息参数 2。
void Example() {
XCEngine::Input::InputModule object;
// 根据上下文补齐参数后调用 InputModule::HandleMessage(...)
(void)object;
}
```
## 返回值
-
## 相关文档
- [返回类总览](InputModule.md)
- [返回模块目录](../Input.md)
- [返回类总览](InputModule.md)
- [WindowsInputModule](../../Platform/Windows/WindowsInputModule/WindowsInputModule.md)