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

# GameInputMouseState

> GameInputMouseState

# GameInputMouseState

描述滑鼠的狀態。

<a id="syntaxSection" />

## 語法

```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;
};
```

<a id="membersSection" />

### 成員

*buttons*<br />
類型：[GameInputMouseButtons](/zh-TW/reference/input/gameinput/enums/gameinputmousebuttons)

滑鼠按鈕的狀態。

*positionFlags*<br />
類型：[GameInputMousePosition](/zh-TW/reference/input/gameinput/enums/gameInputmousepositions)

滑鼠位置的狀態。

*positionX*<br />
類型：int64\_t

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

*positionY*<br />
類型：int64\_t

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

*absolutePositionX*<br />
類型：int64\_t

滑鼠的絕對 X 軸位置。

*absolutePositionY*<br />
類型：int64\_t

滑鼠的絕對 Y 軸位置。

*wheelX*<br />
類型：int64\_t

X 軸滾輪的累計變化。

*wheelY*<br />
類型：int64\_t

Y 軸滾輪的累計變化。

<a id="remarksSection" />

## 備註

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

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

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

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

<a id="requirementsSection" />

## 需求

**標頭：** GameInput.h

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

<a id="seealsoSection" />

## 概念文件

* [GameInput 鍵盤和滑鼠](/zh-TW/build/core-features/common/input/advanced/input-keyboard-mouse)

## 另請參閱

[GameInput 概觀](/zh-TW/build/core-features/common/input/overviews/input-overview)\
[GameInput](/zh-TW/reference/input/gameinput/gameinput_members)

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **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

- [GameInputMouseState](/reference/input/gameinput/structs/gameinputmousestate.md)
- [IGameInputReading::GetMouseState](/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getmousestate.md)
- [GameInputMousePositions](/reference/input/gameinput/enums/gameInputmousepositions.md)
- [GameInputMouseButtons](/reference/input/gameinput/enums/gameinputmousebuttons.md)
- [Keyboards and mice in GameInput](/build/core-features/common/input/advanced/input-keyboard-mouse.md)