IGameInputReading::GetMouseState

检索描述鼠标的状态的输入读取的视图。

语法

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

库:xgameruntime.lib

支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

输入 API 概述
IGameInputReading