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

# GameInputControllerButtonInfo (已淘汰)

> GameInputControllerButtonInfo

# GameInputControllerButtonInfo

> [!WARNING]
>
> **已淘汰。** 此結構已在 GameInput v3 中移除，目前的 API 中無法使用。此資訊現在改由 [GameInputControllerInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/structs/gameinputcontrollerinfo.md) 提供。

描述一般控制器裝置上的個別按鈕。

## 語法

```cpp theme={null}
typedef struct GameInputControllerButtonInfo {
    GameInputLabel label;
    GameInputLocation location;
    uint32_t locationId;
} GameInputControllerButtonInfo;
```

## 成員

**label**\
類型：[GameInputLabel](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputlabel.md)

識別此按鈕功能的標籤。

**location**\
類型：[GameInputLocation](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/enums/gameinputlocation.md)

此按鈕在裝置上的實體位置。

**locationId**\
類型：uint32\_t

用來區分位於相同位置之各按鈕的識別碼。

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v3** | 已移除。欄位已整合至 [GameInputControllerInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/structs/gameinputcontrollerinfo.md)。 |
| **v2** | 無變更。 |
| **v1** | 無變更。 |
| **v0** | 推出。 |

## 另請參閱

[已淘汰的 GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
[GameInputControllerInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/structs/gameinputcontrollerinfo.md)


## Related topics

- [GameInputControllerAxisInfo (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/structs/gameinputcontrolleraxisinfo.md)
- [GameInputUiNavigationButtons (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/enums/gameinputuinavigationbuttons.md)
- [GameInputUiNavigationInfo (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/structs/gameinputuinavigationinfo.md)
- [GameInputGuidButtonCallback (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/functions/gameinputguidebuttoncallback.md)
- [IGameInput::RegisterGuideButtonCallback (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerguidebuttoncallback.md)