检索描述鼠标的状态的输入读取的视图。
语法
bool GetMouseState(
GameInputMouseState* state
);
参数
state _Out_
类型:GameInputMouseState*
作为鼠标的输入的解释。
返回值
类型:bool
在成功解释鼠标输入后返回 true。 在尝试读取未识别为鼠标输入的输入时返回 false。
备注
调用 IGameInputReading::GetInputKind 方法以查看哪些 Get*State 函数将返回某些 IGameInputReading 的有效解读。 每个 Get*State 函数在 IGameInputReading::GetInputKind 枚举中都有对应的条目。 如果您在未设置相应的 IGameInputReading::GetInputKind 标志时尝试调用 Get*State 函数,则该函数将返回静态默认值以及一个 false 返回值。
鼠标移动从设备本机报告为相对增量值和/或绝对值,具体取决于设备功能。 相对位置与轮询 API 不太兼容,因为定期请求当前鼠标读取可能会错过几个中间增量。 GameInput API 不强制使用轮询 API 的应用遍历数十个历史鼠标读数并汇总增量,而是通过将增量不断累积到虚拟“位置”值来公开相对鼠标移动。 然后,应用程序通过从先前获取的读数中减去“位置”值来计算自己的增量。 这样,在计算连续读数时便可访问单个增量,或者在有意跳过中间读数时便可访问累积增量。 注意,鼠标“位置”值只是所有移动增量的总和,与屏幕空间坐标没有任何关联。
要求
头文件:GameInput.h
库:gameinput.lib
支持的平台: 窗户
另请参阅
输入 API 概述IGameInputReadingGameInputMouseStateGameInputMousePositions