- Qt 5.15
- Qt Gamepad
- C++ Classes
- QGamepad
- Qt 5.15.18 Reference Documentation

# QGamepad Class

A gamepad device connected to a system. More...

Header: | #include <QGamepad>
qmake: | QT += gamepad
Instantiated By: | Gamepad
Inherits: | QObject

- List of all members, including inherited members

## Properties

- axisLeftX : const double
- axisLeftY : const double
- axisRightX : const double
- axisRightY : const double
- buttonL1 : const bool
- buttonL2 : const double
- buttonL3 : const bool
- buttonR1 : const bool
- buttonR2 : const double
- buttonR3 : const bool
- buttonA : const bool
- buttonB : const bool
- buttonCenter : const bool

- buttonDown : const bool
- buttonGuide : const bool
- buttonLeft : const bool
- buttonRight : const bool
- buttonSelect : const bool
- buttonStart : const bool
- buttonUp : const bool
- buttonX : const bool
- buttonY : const bool
- connected : const bool
- deviceId : int
- name : const QString

## Public Functions

| QGamepad(int deviceId = 0, QObject *parent = nullptr)
double | axisLeftX() const
double | axisLeftY() const
double | axisRightX() const
double | axisRightY() const
bool | buttonL1() const
double | buttonL2() const
bool | buttonL3() const
bool | buttonR1() const
double | buttonR2() const
bool | buttonR3() const
bool | buttonA() const
bool | buttonB() const
bool | buttonCenter() const
bool | buttonDown() const
bool | buttonGuide() const
bool | buttonLeft() const
bool | buttonRight() const
bool | buttonSelect() const
bool | buttonStart() const
bool | buttonUp() const
bool | buttonX() const
bool | buttonY() const
int | deviceId() const
bool | isConnected() const
QString | name() const

## Public Slots

void | setDeviceId(int number)

## Signals

void | axisLeftXChanged(double value)
void | axisLeftYChanged(double value)
void | axisRightXChanged(double value)
void | axisRightYChanged(double value)
void | buttonAChanged(bool value)
void | buttonBChanged(bool value)
void | buttonCenterChanged(bool value)
void | buttonDownChanged(bool value)
void | buttonGuideChanged(bool value)
void | buttonL1Changed(bool value)
void | buttonL2Changed(double value)
void | buttonL3Changed(bool value)
void | buttonLeftChanged(bool value)
void | buttonR1Changed(bool value)
void | buttonR2Changed(double value)
void | buttonR3Changed(bool value)
void | buttonRightChanged(bool value)
void | buttonSelectChanged(bool value)
void | buttonStartChanged(bool value)
void | buttonUpChanged(bool value)
void | buttonXChanged(bool value)
void | buttonYChanged(bool value)
void | connectedChanged(bool value)
void | deviceIdChanged(int value)
void | nameChanged(QString value)

## Detailed Description

QGamepad is used to access the current state of gamepad hardware connected to a system.

## Property Documentation

### axisLeftX : const double

The value of the left thumbstick's X axis. The axis values range from -1.0 to 1.0.

Access functions:

double | axisLeftX() const

Notifier signal:

void | axisLeftXChanged(double value)

### axisLeftY : const double

The value of the left thumbstick's Y axis. The axis values range from -1.0 to 1.0.

Access functions:

double | axisLeftY() const

Notifier signal:

void | axisLeftYChanged(double value)

### axisRightX : const double

This value of the right thumbstick's X axis. The axis values range from -1.0 to 1.0.

Access functions:

double | axisRightX() const

Notifier signal:

void | axisRightXChanged(double value)

### axisRightY : const double

This value of the right thumbstick's Y axis. The axis values range from -1.0 to 1.0.

Access functions:

double | axisRightY() const

Notifier signal:

void | axisRightYChanged(double value)

### buttonL1 : const bool

The state of the left shoulder button. The value is `true` when pressed, and `false` when not pressed.

Access functions:

bool | buttonL1() const

Notifier signal:

void | buttonL1Changed(bool value)

### buttonL2 : const double

The value of the left trigger button. This trigger value ranges from 0.0 when not pressed to 1.0 when pressed completely.

Access functions:

double | buttonL2() const

Notifier signal:

void | buttonL2Changed(double value)

### buttonL3 : const bool

The state of the left stick button. The value is `true` when pressed, and `false` when not pressed. This button is usually triggered by pressing the left joystick itself.

Access functions:

bool | buttonL3() const

Notifier signal:

void | buttonL3Changed(bool value)

### buttonR1 : const bool

The state of the right shoulder button. The value is `true` when pressed, and `false` when not pressed.

Access functions:

bool | buttonR1() const

Notifier signal:

void | buttonR1Changed(bool value)

### buttonR2 : const double

The value of the right trigger button. This trigger value ranges from 0.0 when not pressed to 1.0 when pressed completely.

Access functions:

double | buttonR2() const

Notifier signal:

void | buttonR2Changed(double value)

### buttonR3 : const bool

The state of the right stick button. The value is `true` when pressed, and `false` when not pressed. This button is usually triggered by pressing the right joystick itself.

Access functions:

bool | buttonR3() const

Notifier signal:

void | buttonR3Changed(bool value)

### buttonA : const bool

The state of the A button. The value is `true` when pressed, and `false` when not pressed.

Access functions:

bool | buttonA() const

Notifier signal:

void | buttonAChanged(bool value)

### buttonB : const bool

The state of the B button. The value is `true` when pressed, and `false` when not pressed.

Access functions:

bool | buttonB() const

Notifier signal:

void | buttonBChanged(bool value)

### buttonCenter : const bool

The state of the center button. The value is `true` when pressed, and `false` when not pressed.

Access functions:

bool | buttonCenter() const

Notifier signal:

void | buttonCenterChanged(bool value)

### buttonDown : const bool

The state of the direction pad down button. The value is `true` when pressed, and `false` when not pressed.

Access functions:

bool | buttonDown() const

Notifier signal:

void | buttonDownChanged(bool value)

### buttonGuide : const bool

The state of the guide button. The value is `true` when pressed, and `false` when not pressed. This button is typically the one in the center of the gamepad with a logo. Not all gamepads have a guide button.

Access functions:

bool | buttonGuide() const

Notifier signal:

void | buttonGuideChanged(bool value)

### buttonLeft : const bool

The state of the direction pad left button. The value is `true` when pressed, and `false` when not pressed.

Access functions:

bool | buttonLeft() const

Notifier signal:

void | buttonLeftChanged(bool value)

### buttonRight : const bool

The state of the direction pad right button. The value is `true` when pressed, and `false` when not pressed.

Access functions:

bool | buttonRight() const

Notifier signal:

void | buttonRightChanged(bool value)

### buttonSelect : const bool

The state of the Select button. The value is `true` when pressed, and `false` when not pressed. This button can sometimes be labeled as the Back button on some gamepads.

Access functions:

bool | buttonSelect() const

Notifier signal:

void | buttonSelectChanged(bool value)

### buttonStart : const bool

The state of the Start button. The value is `true` when pressed, and `false` when not pressed. This button can sometimes be labeled as the Forward button on some gamepads.

Access functions:

bool | buttonStart() const

Notifier signal:

void | buttonStartChanged(bool value)

### buttonUp : const bool

The state of the direction pad up button. The value is `true` when pressed, and `false` when not pressed.

Access functions:

bool | buttonUp() const

Notifier signal:

void | buttonUpChanged(bool value)

### buttonX : const bool

The state of the X button. The value is `true` when pressed, and `false` when not pressed.

Access functions:

bool | buttonX() const

Notifier signal:

void | buttonXChanged(bool value)

### buttonY : const bool

The state of the Y button. The value is `true` when pressed, and `false` when not pressed.

Access functions:

bool | buttonY() const

Notifier signal:

void | buttonYChanged(bool value)

### connected : const bool

The connectivity state of the gamepad device. If a gamepad is connected, this property will be `true`, otherwise `false`.

Access functions:

bool | isConnected() const

Notifier signal:

void | connectedChanged(bool value)

### deviceId : int

This property holds the deviceId of the gamepad device. Multiple gamepad devices can be connected at any given time, so setting this property defines which gamepad to use.

Access functions:

int | deviceId() const
void | setDeviceId(int number)

Notifier signal:

void | deviceIdChanged(int value)

See also QGamepadManager::connectedGamepads().

### name : const QString

The reported name of the gamepad if one is available.

Access functions:

QString | name() const

Notifier signal:

void | nameChanged(QString value)

## Member Function Documentation

### QGamepad::QGamepad(int deviceId = 0, QObject *parent = nullptr)

Constructs a QGamepad with the given deviceId and parent.