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

# GameInputFlightStickState

> GameInputFlightStickState

# GameInputFlightStickState

描述飛行搖桿的狀態。

## 語法

```cpp theme={null}
struct GameInputFlightStickState {
    GameInputFlightStickButtons buttons;
    GameInputSwitchPosition     hatSwitch;
    float                       roll;
    float                       pitch;
    float                       yaw;
    float                       throttle;
};
```

### 成員

*buttons*\

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

按下的飛行搖桿按鈕。

*hatSwitch*\

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

苦力帽開關的位置。

*roll*\

類型：float

範圍 \[-1.0, 1.0] 內的正規化滾轉值。

*pitch*\

類型：float

範圍 \[-1.0, 1.0] 內的正規化俯仰值。

*yaw*\

類型：float

範圍 \[-1.0, 1.0] 內的正規化偏擺值。

*throttle*\

類型：float

範圍 \[-1.0, 1.0] 內的正規化油門值。

## 備註

此結構由 [IGameInputReading::GetFlightStickState](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getflightstickstate.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

- [GetFlightStickState](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getflightstickstate.md)
- [GameInputFlightStickButtons](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputflightstickbuttons.md)
- [GameInputSwitchPosition](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputswitchposition.md)
- [GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/gameinput_members.md)
- [GameInputFlightStickAxes](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputflightstickaxes.md)