> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GameInputMouseState

> GameInputMouseState

# GameInputMouseState

描述滑鼠的狀態。

## 語法

```cpp theme={null}
struct GameInputMouseState
{
    GameInputMouseButtons   buttons;
    GameInputMousePositions positions;
    int64_t                 positionX;
    int64_t                 positionY;
    int64_t                 absolutePositionX;
    int64_t                 absolutePositionY;
    int64_t                 wheelX;
    int64_t                 wheelY;
};
```

### 成員

*buttons*\

類型：[GameInputMouseButtons](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputmousebuttons.md)

滑鼠按鈕的狀態。

*positionFlags*\

類型：[GameInputMousePosition](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameInputmousepositions.md)

滑鼠位置的狀態。

*positionX*\

類型：int64\_t

滑鼠位置在 X 軸上的累計變化。

*positionY*\

類型：int64\_t

滑鼠位置在 Y 軸上的累計變化。

*absolutePositionX*\

類型：int64\_t

滑鼠的絕對 X 軸位置。

*absolutePositionY*\

類型：int64\_t

滑鼠的絕對 Y 軸位置。

*wheelX*\

類型：int64\_t

X 軸滾輪的累計變化。

*wheelY*\

類型：int64\_t

Y 軸滾輪的累計變化。

## 備註

此結構由 [IGameInputReading::GetMouseState](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getmousestate.md) 方法使用。

滑鼠和滾輪的移動不會以絕對位置回報。請將目前讀數中的值減去先前讀數中的值來計算差異。

GameInput 會將任何可用的觸控板裝置呈現為單一虛擬滑鼠裝置。

如需詳細資訊，請參閱 [GameInput 讀數](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-readings.md)。

## 需求

**標頭：** GameInput.h

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 概念文件

* [GameInput 鍵盤和滑鼠](https://docs.xbox.com/zh-TW/build/core-features/common/input/advanced/input-keyboard-mouse.md)

## 另請參閱

[GameInput 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-overview.md)\
[GameInput](https://docs.xbox.com/zh-TW/reference/input/gameinput/gameinput_members.md)

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v1** | **新增** `positions` (GameInputMousePositions 位元遮罩) 以及 `absolutePositionX`/`absolutePositionY` 欄位。 |
| **v0** | 推出。 |

## 附錄：先前版本

### v0

```cpp theme={null}
struct GameInputMouseState
{
    GameInputMouseButtons buttons;
    int64_t               positionX;
    int64_t               positionY;
    int64_t               wheelX;
    int64_t               wheelY;
};
```


## Related topics

- [GetMouseState](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getmousestate.md)
- [GameInputMousePositions](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameInputmousepositions.md)
- [GameInputMouseButtons](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputmousebuttons.md)
- [GameInput 鍵盤和滑鼠](https://docs.xbox.com/zh-TW/build/core-features/common/input/advanced/input-keyboard-mouse.md)
- [GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/gameinput_members.md)