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

# GameInputUiNavigationState（已弃用）

> GameInputUiNavigationState

# GameInputUiNavigationState

> [!WARNING]
>
> **已弃用。** 此结构在 GameInput v3 中被移除，当前 API 中不再提供。

描述输入读数中 UI 导航按钮的当前状态。

## 语法

```cpp theme={null}
typedef struct GameInputUiNavigationState {
    GameInputUiNavigationButtons buttons;
} GameInputUiNavigationState;
```

## 成员

**buttons**\
类型：[GameInputUiNavigationButtons](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/enums/gameinputuinavigationbuttons.md)

当前按下的 UI 导航按钮的位掩码。

## 备注

此结构通过已弃用的 [IGameInputReading::GetUiNavigationState](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_getuinavigationstate.md) 方法读取。两者均已在 v3 中被移除。

UI 导航状态将物理游戏手柄按钮抽象为逻辑操作（接受、取消、菜单等），以便在游戏标题菜单和用户界面元素中使用。

## 版本历史

| 版本 | 变更 |
| - | - |
| **v3** | 已移除。 |
| **v2** | 引入。 |

## 另请参阅

[已弃用的 GameInput API 成员](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
[IGameInputReading::GetUiNavigationState](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_getuinavigationstate.md)
[GameInputUiNavigationInfo](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputuinavigationinfo.md)
[GameInputUiNavigationButtons](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/enums/gameinputuinavigationbuttons.md)


## Related topics

- [GameInputUiNavigationButtons（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/enums/gameinputuinavigationbuttons.md)
- [GameInputUiNavigationInfo（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputuinavigationinfo.md)
- [IGameInputReading::GetUiNavigationState（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_getuinavigationstate.md)
- [GameInputMotionState（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputmotionstate.md)
- [GameInputTouchState（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputtouchstate.md)