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

# GameInputControllerButtonInfo

> GameInputControllerButtonInfo

# GameInputControllerButtonInfo

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

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

## 語法

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

## 成員

**label**\
類型：[GameInputLabel](/zh-TW/reference/input/gameinput/enums/gameinputlabel)

識別此按鈕功能的標籤。

**location**\
類型：[GameInputLocation](/zh-TW/reference/input/gameinput/deprecated/enums/gameinputlocation)

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

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

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

## 版本歷程記錄

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

## 另請參閱

[已淘汰的 GameInput API 成員](/zh-TW/reference/input/gameinput/deprecated/gameinput_deprecated_members)
[GameInputControllerInfo](/zh-TW/reference/input/gameinput/structs/gameinputcontrollerinfo)


## Related topics

- [GameInputControllerButtonInfo](/reference/input/gameinput/deprecated/structs/gameinputcontrollerbuttoninfo.md)
- [GameInputControllerInfo](/reference/input/gameinput/structs/gameinputcontrollerinfo.md)
- [GameInputLocation](/reference/input/gameinput/deprecated/enums/gameinputlocation.md)