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

# GameInputTouchState

> GameInputTouchState

# GameInputTouchState

<Warning>**已淘汰。** 此結構已在 GameInput v1 中移除，目前的 API 中無法使用。</Warning>

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

## 語法

```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](/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_gettouchstate) 方法讀取。兩者都已在 v1 中移除。

## 版本歷程記錄

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

## 另請參閱

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


## Related topics

- [GameInputTouchState](/reference/input/gameinput/deprecated/structs/gameinputtouchstate.md)
- [IGameInputReading::GetTouchState](/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_gettouchstate.md)