En esta página

QLowEnergyCharacteristicData Class

La clase QLowEnergyCharacteristicData se utiliza para configurar los datos del servicio GATT. Más información...

Cabecera: #include <QLowEnergyCharacteristicData>
CMake: find_package(Qt6 REQUIRED COMPONENTS Bluetooth)
target_link_libraries(mytarget PRIVATE Qt6::Bluetooth)
qmake: QT += bluetooth

Funciones públicas

QLowEnergyCharacteristicData()
QLowEnergyCharacteristicData(const QLowEnergyCharacteristicData &other)
~QLowEnergyCharacteristicData()
void addDescriptor(const QLowEnergyDescriptorData &descriptor)
QList<QLowEnergyDescriptorData> descriptors() const
bool isValid() const
int maximumValueLength() const
int minimumValueLength() const
QLowEnergyCharacteristic::PropertyTypes properties() const
QBluetooth::AttAccessConstraints readConstraints() const
void setDescriptors(const QList<QLowEnergyDescriptorData> &descriptors)
void setProperties(QLowEnergyCharacteristic::PropertyTypes properties)
void setReadConstraints(QBluetooth::AttAccessConstraints constraints)
void setUuid(const QBluetoothUuid &uuid)
void setValue(const QByteArray &value)
void setValueLength(int minimum, int maximum)
void setWriteConstraints(QBluetooth::AttAccessConstraints constraints)
void swap(QLowEnergyCharacteristicData &other)
QBluetoothUuid uuid() const
QByteArray value() const
QBluetooth::AttAccessConstraints writeConstraints() const
QLowEnergyCharacteristicData &operator=(const QLowEnergyCharacteristicData &other)
bool operator!=(const QLowEnergyCharacteristicData &a, const QLowEnergyCharacteristicData &b)
bool operator==(const QLowEnergyCharacteristicData &a, const QLowEnergyCharacteristicData &b)

Descripción detallada

Un objeto de esta clase proporciona una característica que se añade a un objeto ` QLowEnergyServiceData ` mediante la función ` QLowEnergyServiceData::addCharacteristic()`.

Véase también ` QLowEnergyServiceData ` y ` QLowEnergyController::addService`.

Documentación de las funciones miembro

QLowEnergyCharacteristicData::QLowEnergyCharacteristicData()

Crea un nuevo objeto no válido de esta clase.

QLowEnergyCharacteristicData::QLowEnergyCharacteristicData(const QLowEnergyCharacteristicData &other)

Crea un nuevo objeto de esta clase que es una copia de other.

[noexcept] QLowEnergyCharacteristicData::~QLowEnergyCharacteristicData()

Destruye este objeto.

void QLowEnergyCharacteristicData::addDescriptor(const QLowEnergyDescriptorData &descriptor)

Añade « descriptor » a la lista de descriptores de esta característica, si es válido.

Véase también setDescriptors().

QList<QLowEnergyDescriptorData> QLowEnergyCharacteristicData::descriptors() const

Devuelve los descriptores de esta característica.

Véase también setDescriptors().

bool QLowEnergyCharacteristicData::isValid() const

Devuelve «true» si y solo si esta característica es válida, es decir, si tiene un UUID distinto de nulo.

int QLowEnergyCharacteristicData::maximumValueLength() const

Devuelve la longitud máxima, en bytes, que puede tener el valor de esta característica. De forma predeterminada, no hay ningún límite más allá de las restricciones del tipo de datos.

int QLowEnergyCharacteristicData::minimumValueLength() const

Devuelve la longitud mínima, en bytes, que puede tener el valor de esta característica. El valor por defecto es cero.

QLowEnergyCharacteristic::PropertyTypes QLowEnergyCharacteristicData::properties() const

Devuelve las propiedades de esta característica.

Véase también setProperties().

QBluetooth::AttAccessConstraints QLowEnergyCharacteristicData::readConstraints() const

Devuelve las restricciones necesarias para que un cliente pueda leer el valor de esta característica. Si properties() no incluye QLowEnergyCharacteristic::Read, este valor carece de relevancia. Por defecto, no hay restricciones de lectura.

Véase también setReadConstraints().

void QLowEnergyCharacteristicData::setDescriptors(const QList<QLowEnergyDescriptorData> &descriptors)

Establece los descriptores de esta característica en descriptors. Solo se tienen en cuenta los descriptores válidos.

Véase también descriptors() y addDescriptor().

void QLowEnergyCharacteristicData::setProperties(QLowEnergyCharacteristic::PropertyTypes properties)

Establece las propiedades de esta característica en « properties ».

Véase también properties().

void QLowEnergyCharacteristicData::setReadConstraints(QBluetooth::AttAccessConstraints constraints)

Especifica que los clientes deben cumplir con constraints para poder leer el valor de esta característica.

Véase también readConstraints().

void QLowEnergyCharacteristicData::setUuid(const QBluetoothUuid &uuid)

Establece el UUID de esta característica en uuid.

Véase también uuid().

void QLowEnergyCharacteristicData::setValue(const QByteArray &value)

Establece el valor de esta característica en « value ».

Véase también value().

void QLowEnergyCharacteristicData::setValueLength(int minimum, int maximum)

Especifica que minimum y maximum son, respectivamente, la longitud mínima y máxima que puede tener el valor de esta característica. La unidad es el byte. Si minimum y maximum son iguales, la característica tiene un valor de longitud fija.

void QLowEnergyCharacteristicData::setWriteConstraints(QBluetooth::AttAccessConstraints constraints)

Especifica que los clientes deben cumplir con constraints para poder escribir el valor de esta característica.

Véase también writeConstraints().

[noexcept] void QLowEnergyCharacteristicData::swap(QLowEnergyCharacteristicData &other)

Intercambia este objeto por other.

QBluetoothUuid QLowEnergyCharacteristicData::uuid() const

Devuelve el UUID de esta característica.

Véase también setUuid().

QByteArray QLowEnergyCharacteristicData::value() const

Devuelve el valor de esta característica.

Véase también setValue().

QBluetooth::AttAccessConstraints QLowEnergyCharacteristicData::writeConstraints() const

Devuelve las restricciones necesarias para que un cliente pueda escribir el valor de esta característica. Si properties() no incluye ninguna de las siguientes restricciones: QLowEnergyCharacteristic::Write, QLowEnergyCharacteristic::WriteNoResponse y QLowEnergyCharacteristic::WriteSigned, este valor no es relevante. Por defecto, no hay restricciones de escritura.

Véase también setWriteConstraints().

QLowEnergyCharacteristicData &QLowEnergyCharacteristicData::operator=(const QLowEnergyCharacteristicData &other)

Convierte este objeto en una copia de ` other ` y devuelve el nuevo valor de este objeto.

Elementos no miembros relacionados

bool operator!=(const QLowEnergyCharacteristicData &a, const QLowEnergyCharacteristicData &b)

Devuelve « true » si « a » y « b » no son iguales en cuanto a su estado público; en caso contrario, devuelve « false ».

bool operator==(const QLowEnergyCharacteristicData &a, const QLowEnergyCharacteristicData &b)

Devuelve « true » si « a » y « b » son iguales en cuanto a su estado público; en caso contrario, devuelve « false ».

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.