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

# GameInputTouchState (已淘汰)

> GameInputTouchState

# GameInputTouchState

> [!WARNING]
>
> **已淘汰。** 此結構已在 GameInput v1 中移除，目前的 API 中無法使用。

描述輸入讀數中單一觸控接觸點的狀態。

## 語法

```cpp theme={null}
typedef struct GameInputTouchState {
    uint64_t touchId;
    uint32_t sensorIndex;
    float positionX;
    float positionY;
    float pressure;
    float proximity;
    float contactRectTop;
    float contactRectLeft;
    float contactRectRight;
    float contactRectBottom;
} GameInputTouchState;
```

## 成員

**touchId**\
類型：uint64\_t

此觸控接觸點的唯一識別碼，會跨讀數追蹤。

**sensorIndex**\
類型：uint32\_t

產生此接觸點之觸控感應器的索引。

**positionX, positionY**\
類型：float

接觸點在感應器表面上的正規化位置，範圍為 \[0.0, 1.0]。

**pressure**\
類型：float

接觸點的正規化壓力，範圍為 \[0.0, 1.0]。

**proximity**\
類型：float

接觸點的正規化接近程度，範圍為 \[0.0, 1.0]。

**contactRectTop, contactRectLeft, contactRectRight, contactRectBottom**\
類型：float

感應器表面上接觸區域的週框矩形，以正規化座標表示。

## 備註

此結構是透過已淘汰的 [IGameInputReading::GetTouchState](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_gettouchstate.md) 方法讀取。兩者都已在 v1 中移除。

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v1** | 已移除。 |
| **v0** | 推出。 |

## 另請參閱

[已淘汰的 GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
[IGameInputReading::GetTouchState](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_gettouchstate.md)
[IGameInputReading::GetTouchCount](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_gettouchcount.md)
[GameInputTouchSensorInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/structs/gameinputtouchsensorinfo.md)


## Related topics

- [GameInputTouchSensorInfo (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/structs/gameinputtouchsensorinfo.md)
- [IGameInputReading::GetTouchState (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_gettouchstate.md)
- [IGameInputReading::GetTouchCount (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_gettouchcount.md)
- [已淘汰的 GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
- [GameInputTouchShape (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/enums/gameinputtouchshape.md)