> ## 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.

# GameInputGamepadState

> GameInputGamepadState

# GameInputGamepadState

描述遊戲台輸入裝置的狀態。

## 語法

```cpp theme={null}
struct GameInputGamepadState
{
    GameInputGamepadButtons buttons;
    float                   leftTrigger;
    float                   rightTrigger;
    float                   leftThumbstickX;
    float                   leftThumbstickY;
    float                   rightThumbstickX;
    float                   rightThumbstickY;
};
```

### 成員

*buttons*\

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

按下的遊戲台按鈕。

*leftTrigger*\

類型：float

左扳機的位置，正規化為範圍 \[0.0, 1.0] 內的值。

*rightTrigger*\

類型：float

右扳機的位置，正規化為範圍 \[0.0, 1.0] 內的值。

*leftThumbstickX*\

類型：float

左搖桿的水平位置，正規化為範圍 \[-1.0, 1.0] 內的值。

*leftThumbstickY*\

類型：float

左搖桿的垂直位置，正規化為範圍 \[-1.0, 1.0] 內的值。

*rightThumbstickX*\

類型：float

右搖桿的水平位置，正規化為範圍 \[-1.0, 1.0] 內的值。

*rightThumbstickY*\

類型：float

右搖桿的垂直位置，正規化為範圍 \[-1.0, 1.0] 內的值。

## 備註

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

如需詳細資訊，請參閱 [GameInput 讀數](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-readings.md)的[從讀數取得資料](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-readings.md#gettingStateSection)一節。如需程式碼範例，請參閱[簡單的遊戲台輸入迴圈](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-readings.md#sampleSection)。

## 需求

**標頭：** GameInput.h

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

## 另請參閱

[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)

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v0** | 推出。 |


## Related topics

- [GetGamepadState](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getgamepadstate.md)
- [GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/gameinput_members.md)
- [GameInputGamepadButtons](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputgamepadbuttons.md)
- [GameInputGamepadAxes](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputgamepadaxes.md)
- [GameInputGamepadInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/structs/gameinputgamepadinfo.md)