<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.15.0 -",
    "tvOS: 13.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "GameController",
  "identifier" : "/documentation/GameController/GCControllerTouchpad",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Game Controller"
    ],
    "preciseIdentifier" : "c:objc(cs)GCControllerTouchpad"
  },
  "title" : "GCControllerTouchpad"
}
-->

# GCControllerTouchpad

A control element that represents a touch event on a touchpad.

```
class GCControllerTouchpad
```

## Overview

A `GCControllerTouchpad` object provides the state of the touches and presses on a touchpad. This is a compound element with button and directional pad subelements.

## Topics

### Getting the subelements

[`touchSurface`](/documentation/GameController/GCControllerTouchpad/touchSurface)

The element that represents the state of the user’s touch on the surface of the touchpad.

[`button`](/documentation/GameController/GCControllerTouchpad/button)

The element that represents the button component on the touchpad.

### Accessing the input values

[`touchState`](/documentation/GameController/GCControllerTouchpad/touchState-swift.property)

The state of the user’s touch on the surface of the touchpad.

[`GCControllerTouchpad.TouchState`](/documentation/GameController/GCControllerTouchpad/TouchState-swift.enum)

The possible states of the user’s touch.

[`reportsAbsoluteTouchSurfaceValues`](/documentation/GameController/GCControllerTouchpad/reportsAbsoluteTouchSurfaceValues)

A Boolean value that determines whether the touch values are absolute or relative.

### Getting change information

[`touchDown`](/documentation/GameController/GCControllerTouchpad/touchDown)

The block that the element calls when the user begins touching the touchpad.

[`touchMoved`](/documentation/GameController/GCControllerTouchpad/touchMoved)

The block that the element calls when the user continues touching the touchpad, not when the user begins or ends touching the touchpad.

[`touchUp`](/documentation/GameController/GCControllerTouchpad/touchUp)

The block that the element calls when the user finishes touching the touchpad.

[`GCControllerTouchpadHandler`](/documentation/GameController/GCControllerTouchpadHandler)

The signature for the block that executes when the user interacts with the touchpad.

### Setting snapshot values

[`setValueForXAxis(_:yAxis:touchDown:buttonValue:)`](/documentation/GameController/GCControllerTouchpad/setValueForXAxis(_:yAxis:touchDown:buttonValue:))

Sets the input values of a snapshot of a touchpad.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)